o h@s`ddlZddlZddlZddlZddlZddlZddgZdddZGdddejZ ddZ dS) Nattach _lazy_importcs|duri}durtntdd|DtBfdd}fdd}tjdd rGtBD]}||q@||tfS) aAttach lazily loaded submodules, and functions or other attributes. Typically, modules import submodules and attributes as follows:: import mysubmodule import anothersubmodule from .foo import someattr The idea of this function is to replace the `__init__.py` module's `__getattr__`, `__dir__`, and `__all__` attributes such that all imports work exactly the way they normally would, except that the actual import is delayed until the resulting module object is first used. The typical way to call this function, replacing the above imports, is:: __getattr__, __lazy_dir__, __all__ = lazy.attach( __name__, ["mysubmodule", "anothersubmodule"], {"foo": "someattr"} ) This functionality requires Python 3.7 or higher. Parameters ---------- module_name : str Typically use __name__. submodules : set List of submodules to lazily import. submod_attrs : dict Dictionary of submodule -> list of attributes / functions. These attributes are imported as they are used. Returns ------- __getattr__, __dir__, __all__ NcSs i|] \}}|D]}||qqSr).0modattrsattrrri/var/www/html/construction_image-detection-poc/venv/lib/python3.10/site-packages/networkx/lazy_imports.py 9s zattach..csZ|vrtd|S|vr#td|}t||Stdd|)N.zNo z attribute ) importlib import_modulegetattrAttributeError)namesubmod)attr_to_modules module_name submodulesrr __getattr__?s  zattach..__getattr__csSNrr)__all__rr __dir__Hszattach..__dir__ EAGER_IMPORT)setitemslistkeysosenvironget)rr submod_attrsrrrr)rrrrr r s&  cs(eZdZfddZfddZZS)DelayedImportErrorModulecs||_tj|i|dSr)%_DelayedImportErrorModule__frame_datasuper__init__)self frame_dataargskwargs __class__rr r&Ssz!DelayedImportErrorModule.__init__csf|dvr t|dS|j}td|dd|dd|dd|d d d |d p,d  ) N)r,__file__ __frame_datazNo module named 'speczG' This error is lazily reported, having originally occurred in File filenamez, line linenoz, in functionz ----> r code_context)r%rr$ModuleNotFoundErrorjoinstrip)r'xfdr+rr rWs z$DelayedImportErrorModule.__getattr__)__name__ __module__ __qualname__r&r __classcell__rrr+r r#Rs r#cCsztj|WSYtj|}|dur1ztd}||j|j|j |j d}t |dW~S~wtj |}|tj|<tj |j}|||S)aReturn a lazily imported proxy for a module or library. Warning ------- Importing using this function can currently cause trouble when the user tries to import from a subpackage of a module before the package is fully imported. In particular, this idiom may not work: np = lazy_import("numpy") from numpy.lib import recfunctions This is due to a difference in the way Python's LazyLoader handles subpackage imports compared to the normal import process. Hopefully we will get Python's LazyLoader to fix this, or find a workaround. In the meantime, this is a potential problem. The workaround is to import numpy before importing from the subpackage. Notes ----- We often see the following pattern:: def myfunc(): import scipy as sp sp.argmin(...) .... This is to prevent a library, in this case `scipy`, from being imported at function definition time, since that can be slow. This function provides a proxy module that, upon access, imports the actual module. So the idiom equivalent to the above example is:: sp = lazy.load("scipy") def myfunc(): sp.argmin(...) .... The initial import time is fast because the actual import is delayed until the first attribute is requested. The overall import time may decrease as well for users that don't make use of large portions of the library. Parameters ---------- fullname : str The full name of the package or subpackage to import. For example:: sp = lazy.load("scipy") # import scipy as sp spla = lazy.load("scipy.linalg") # import scipy.linalg as spla Returns ------- pm : importlib.util._LazyModule Proxy module. Can be used like any regularly imported module. Actual loading of the module occurs upon first attribute request. N)r/r0r1r2r3r#)sysmodulesr util find_specinspectstackr0r1r2r3r#module_from_spec LazyLoaderloader exec_module)fullnamer/parentr(modulerFrrr rds*<       )NN) r importlib.utilrBrr>typesrr ModuleTyper#rrrrr s G