hvSSKrSSKrSSKrSSKrSSKrSSKrSS/rSSjr"SS\R5r Sr g) Nattach _lazy_importc^^^^ Uc0nTc [5mO [T5mUR5VVVs0sHup4UHoUU_M M snnnm [TT R5-5mU UU4SjnU4Sjn[R R SS5(a+[T R55T-H nU"U5 M Xg[T54$s snnnf)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__ c>UT;a"TSU35$UT;a)[R"TSTU35n[X5$[STSU35e)N.zNo z attribute ) importlib import_modulegetattrAttributeError)namesubmodattr_to_modules module_name submoduless G/var/www/html/env/lib/python3.13/site-packages/networkx/lazy_imports.py __getattr__attach..__getattr__?ss : **k]!D6+BC C _ $,, }Aod>S=T-UVF6( ( 3{m;tf!EF Fc>T$N)__all__sr__dir__attach..__dir__Hsr EAGER_IMPORT)setitemslistkeysosenvironget) rr submod_attrsmodattrsattrrrrrs `` @@rrr sL U _ %1$6$6$8$8jcUTc U$8O: 4 4 667GG zz~~nb)),,./*Xl[TU]"U0UD6 gr)%_DelayedImportErrorModule__frame_datasuper__init__)self frame_dataargskwargs __class__s rr.!DelayedImportErrorModule.__init__Ss& $)&)rc>US;a[TU]U5 gURn[SUSSUSSUSSUS S S R US =(d S 5R 53 5e) N)r3__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/xfdr3s rr$DelayedImportErrorModule.__getattr__Ws 9 9 G  """B%#BvJ<0Z.)HeBzNCSTN!3!9r:@@BCE r)r7)__name__ __module__ __qualname____firstlineno__r.r__static_attributes__ __classcell__)r3s@rr)r)Rs*  rr)c[RU$! O=f[RR U5nUc\[ R "5SnUURURURURS.n[US5A$!Af=f[RRU5nU[RU'[RRUR5nURU5 U$)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. )r8r9r:r;r<r))sysmodulesrutil find_specinspectstackr9r:r;r<r)module_from_spec LazyLoaderloader exec_module)fullnamer8parentr0modulerSs rrrdsx {{8$$   >> # #H -D | ]]_Q'F "OO --"OO & 3 3 J,J8RS ^^ , ,T 2F"CKK ^^ & &t{{ 3F v MsABB)NN) rimportlib.utilrOr!rKtypesrr ModuleTyper)rrrrr[s@ ^ $D/Nu//$Xr