Files
2026-07-13 13:22:34 +08:00

52 lines
1.7 KiB
Python

"""Utility to lazy load modules."""
import importlib
import sys
import types
class LazyLoader(types.ModuleType):
"""Class for module lazy loading.
This class helps lazily load modules at package level, which avoids pulling in large
dependencies like `tensorflow` or `torch`. This class is mirrored from wandb's LazyLoader:
https://github.com/wandb/wandb/blob/79b2d4b73e3a9e4488e503c3131ff74d151df689/wandb/sdk/lib/lazyloader.py#L9
"""
def __init__(self, local_name, parent_module_globals, name):
self._local_name = local_name
self._parent_module_globals = parent_module_globals
self._module = None
super().__init__(str(name))
def _load(self):
"""Load the module and insert it into the parent's globals."""
if self._module:
# If already loaded, return the loaded module.
return self._module
# Import the target module and insert it into the parent's namespace
module = importlib.import_module(self.__name__)
self._parent_module_globals[self._local_name] = module
sys.modules[self._local_name] = module
# Update this object's dict so that if someone keeps a reference to the `LazyLoader`,
# lookups are efficient (`__getattr__` is only called on lookups that fail).
self.__dict__.update(module.__dict__)
return module
def __getattr__(self, item):
module = self._load()
return getattr(module, item)
def __dir__(self):
module = self._load()
return dir(module)
def __repr__(self):
if not self._module:
return f"<module '{self.__name__} (Not loaded yet)'>"
return repr(self._module)