o Thu@sddlZddlZddlmZddlmZmZddlmZddl m Z ddl m Z m Z mZddlmZdd lmZdd lmZGd d d ZGd ddeZdS)N) ModuleSpec)module_from_specspec_from_file_location)Path) ModuleType)AnyOptionalTuple)Config)CollectionNotFound)debugc@s^eZdZdZd dedddfddZdedeefd d Zd deede e effd d Z dS)Loaderzo Abstract class defining how to find/import a session's base `.Collection`. .. versionadded:: 1.0 Nconfigr returncCs|durt}||_dS)a Set up a new loader with some `.Config`. :param config: An explicit `.Config` to use; it is referenced for loading-related config options. Defaults to an anonymous ``Config()`` if none is given. N)r r)selfrr@/var/www/html/venv/lib/python3.10/site-packages/invoke/loader.py__init__s  zLoader.__init__namecCst)a Implementation-specific finder method seeking collection ``name``. Must return a ModuleSpec valid for use by `importlib`, which is typically a name string followed by the contents of the 3-tuple returned by `importlib.module_from_spec` (``name``, ``loader``, ``origin``.) For a sample implementation, see `.FilesystemLoader`. .. versionadded:: 1.0 )NotImplementedError)rrrrrfind"s z Loader.findc Cs|dur |jjj}||}|rL|jrL|jrLt|j}|j}|}|jr&|j}t|}|t j vr6t j d|t |}|t j |j<|j||t|fSd}t||t)a Load and return collection module identified by ``name``. This method requires a working implementation of `.find` in order to function. In addition to importing the named module, it will add the module's parent directory to the front of `sys.path` to provide normal Python import behavior (i.e. so the loaded module may load local-to-it modules or packages.) :returns: Two-tuple of ``(module, directory)`` where ``module`` is the collection-containing Python module object, and ``directory`` is the string path to the directory the module was found in. .. versionadded:: 1.0 Nrz-ImportError loading {!r}, raising ImportError)rtaskscollection_namerloaderoriginrparentstrsyspathinsertrmodulesr exec_moduler format ImportError) rrspec source_file enclosing_dir module_parent enclosing_strmodulemsgrrrload1s&       z Loader.loadN) __name__ __module__ __qualname____doc__rrrrrr rr,rrrrrs  $rcs\eZdZdZd deededdffdd Zedefdd Z d edee fd d Z Z S)FilesystemLoaderz Loads Python files from the filesystem (e.g. ``tasks.py``.) Searches recursively towards filesystem root from a given start point. .. versionadded:: 1.0 Nstartkwargsrc s.tjdi||dur|jjj}||_dS)Nr)superrrr search_root_start)rr3r4 __class__rrrps  zFilesystemLoader.__init__cCs|jptSr-)r7osgetcwd)rrrrr3vszFilesystemLoader.startrc Cs$td|jd}d|}|jtj}zbttt|dD]H}tj |d|}|t |vr@t |tj ||}n*|t |vritj tj ||dritj ||}t |tj |d|gd}nq!|rvtd||WSWdSttfyd}t||t||jd w) Nz&FilesystemLoader find starting at {!r}z{}.pyr rz __init__.py)submodule_search_locationszFound module: {!r}z4ImportError loading {!r}, raising CollectionNotFound)rr3)r r#r3splitr:sepreversedrangelenjoinlistdirrrexistsFileNotFoundErrorModuleNotFoundErrorr ) rrr%r*pathsxrbasepathr+rrrr{sB  zFilesystemLoader.findr-) r.r/r0r1rrrrpropertyr3rr __classcell__rrr8rr2cs  r2)r:rimportlib.machineryrimportlib.utilrrpathlibrtypesrtypingrrr r exceptionsr utilr rr2rrrrs      U