o hT@sddlmZddlZddlZddlZddlZddlmZddlm Z ddl m Z ddl m Z ddlmZddlmZmZdd lmZdd lmZer^dd lmZmZdd lmZdd lmZdddDZdddDZdddDZdddDZ e!e"dfZ# e!e#efZ$ d:ddZ%e Gd d!d!Z&e Gd"d#d#Z'Gd$d%d%Z(e)d&Z*e)d'Z+e)d(Z,d;d+d,Z-d) annotationsN) defaultdict)suppress) dataclass)chain)Path) TYPE_CHECKINGClassVar)UnhandledEditableModuleError)logger)IteratorSequence)Pattern)ModulecCg|]}t|qSrecompile.0patrrX/var/www/html/openai_agents/venv/lib/python3.10/site-packages/griffe/_internal/finder.py (r)z^__editables_\w+\.py$z^_editable_impl_\w+\.py$cCrrrrrrrr)r)z^__editable__\w+\.py$cCrrrrrrrr*r)z^_\w+_editable.py$cCrrrrrrrr+r)z^_\w+_editable_loader.py$.stringstrpatternsSequence[Pattern]returnboolcstfdd|DS)Nc3s|]}|VqdSN)match)rpatternrrr 4sz!_match_pattern..)any)rrrr$r_match_pattern3sr'c@s2eZdZUdZded< ded< dZded<dS) PackagezThis class is a simple placeholder used during the process of finding packages. Parameters: name: The package name. path: The package path(s). stubs: An optional path to the related stubs file (.pyi). rnamerpathNz Path | Nonestubs)__name__ __module__ __qualname____doc____annotations__r+rrrrr(7s  r(c@s$eZdZUdZded< ded<dS)NamespacePackagezThis class is a simple placeholder used during the process of finding packages. Parameters: name: The package name. path: The package paths. rr) list[Path]r*N)r,r-r.r/r0rrrrr1Is r1c@seZdZUdZgdZded< eeZded< d?d@d d ZdAddZ dBddZ ddddCdd Z dDd$d%Z d?dEd*d+Z dFd.d/ZdGd1d2ZdHd4d5ZdAd6d7ZdId8d9ZdJd;d<ZdKd=d>ZdS)L ModuleFinderafThe Griffe finder, allowing to find modules on the file system. The module finder is generally not used directly. Each [`GriffeLoader`][griffe.GriffeLoader] instance creates its own module finder instance. The finder can be configured when instantiating the loader thanks to the [loader][griffe.GriffeLoader]'s `search_paths` parameter. ).pyz.pycz.pyoz.pyd.pyiz.sozClassVar[list[str]]accepted_py_module_extensionszClassVar[set[str]]extensions_setN search_pathsSequence[str | Path] | NonerNonecCsBi|_g|_ |p tjD] }|t|q tt|_| dS)zmInitialize the finder. Parameters: search_paths: Optional paths to search into. N) _paths_contentsr8sysr*append_search_pathrrlist_always_scan_for_extend_from_pth_files)selfr8r*rrr__init__fs  zModuleFinder.__init__r*rcCs&|}||jvr|j|dSdS)zAppend a search path. The path will be resolved (absolute, normalized). The path won't be appended if it is already in the search paths list. Parameters: path: The path to append. N)resolver8appendrAr*rrrr=ws zModuleFinder.append_search_pathpositionintcCs(|}||jvr|j||dSdS)a/Insert a search path at the given position. The path will be resolved (absolute, normalized). The path won't be inserted if it is already in the search paths list. Parameters: position: The insert position in the list. path: The path to insert. N)rCr8insert)rArFr*rrrinsert_search_paths zModuleFinder.insert_search_pathTF)try_relative_pathfind_stubs_packagemodule str | PathrJr rK&tuple[str, Package | NamespacePackage]c Csdt|tr||\}}||}n1|r9z |t|\}}Wnty2|}|ddd}Ynw||}n |}|ddd}|sL|||fSz||}Wn ty^d}Ynwz ||d}Wn tysd}Ynw|dur|durt||r|rt|trt|tr|j |_ ||fSt|t rt|t r|j |j 7_ ||fS||p|fS)a5Find the top-level parent module of a module. If a Path is passed, only try to find the module as a file path. If a string is passed, first try to find the module as a file path, then look into the search paths. Parameters: module: The module name or path. try_relative_path: Whether to try finding the module as a relative path, when the given module is not already a path. find_stubs_package: Whether to search for stubs-only package. If both the package and its stubs are found, they'll be merged together. If only the stubs are found, they'll be used as the package itself. Raises: FileNotFoundError: When a Path was passed and the module could not be found: - the directory has no `__init__.py` file in it - the path does not exist ModuleNotFoundError: When a string was passed and the module could not be found: - no `module/__init__.py` - no `module.py` - no `module.pth` - no `module` directory (namespace packages) - or unsupported .pth file Returns: The name of the module, and an instance representing its (namespace) package. .rN-stubs) isinstancer_module_name_path_top_module_nameFileNotFoundErrorsplit find_packageModuleNotFoundErrorr(r*r+r1) rArLrJrK module_name module_pathtop_module_namepackager+rrr find_specsF '      zModuleFinder.find_specrYrPackage | NamespacePackagec Cst|t|dg}|}|d}g}|jD]f}||}|r}|D]Z}||}||vr||jrD|d} t||| r=| ndS|d} | ret| se| d} t|| | r^| ndS|d} | rwt|| dS| |q"q|rt ||St |)aFind a package or namespace package. Parameters: module_name: The module name. Raises: ModuleNotFoundError: When the module cannot be found. Returns: A package or namespace package wrapper. r4rQr5N __init__.pyz __init__.pyi) r removesuffixr8 _contentssuffix with_suffixr(exists_is_pkg_style_namespacerDr1rX) rArY filepathsreal_module_namenamespace_dirsr* path_contentschoiceabs_pathr+ init_modulerrrrWs6          zModuleFinder.find_packagePath | list[Path]seen set | NoneIterator[NamePartsAndPathType]c cs&t|trt}|D] }|||EdHq dS|jdkr"|j}n|j|jvr*dSt|p.d}||D][}| |}|j|vrHt d|q5|jdk}|j}|sZ| ddd}|dkr{t |jdkrfq5|jdd |fV|durz||jq5|r|d j|fVq5||j|fVq5dS) aIterate on a module's submodules, if any. Parameters: path: The module path. seen: If not none, this set is used to skip some files. The goal is to replicate the behavior of Python by only using the first packages (with `__init__` modules) of the same name found in different namespace packages. As soon as we find an `__init__` module, we add its parent path to the `seen` set, which will be reused when scanning the next namespace packages. Yields: name_parts (tuple[str, ...]): The parts of a submodule name. filepath (Path): A submodule filepath. NrBrz'Skip %s, another module took precedencer4rOrPr)rRr>setiter_submodulesstemparentrbr7_filter_py_modules relative_tor debugrVlenpartsaddrc with_name) rAr*rn path_elemskipsubpath rel_subpathpy_filerurrrrts>         zModuleFinder.iter_submodulesrlist[NamePartsAndPathType]cCs(tt||j||j|jtdS)zReturn the list of a module's submodules. Parameters: module: The parent module. Returns: A list of tuples containing the parts of the submodule name and its path. )key)sortedrrtfilepathr?r) _module_depth)rArLrrr submodulesVs  zModuleFinder.submodulestuple[str, Path]cCsv|}|r%|jD]}|d|}|r|j|fSq |j|fS|r9|jdkr4|jj|fS|j|fSt)NrB)absoluteis_dirr6rdr)rurvrU)rAr*extrZrrrrSgs     zModuleFinder._module_name_pathr2c CsL||jvr!z t||j|<Wnttfy g|j|<Ynw|j|Sr!)r;r>iterdirrUNotADirectoryErrorrErrrravs  zModuleFinder._contentscCs||jvr |j|dSdSr!)r8rDrErrr_append_search_path~s z ModuleFinder._append_search_pathcCsf|jD]-}||D]%}|jdkr/t|D]}|j}r(|j||j|| |jqq qdS)Nz.pth) r8rarb_handle_pth_filealways_scan_forr?rDr*joinpathr=)rAr*item directoryscanrrrr@s    z#ModuleFinder._extend_from_pth_filesIterator[Path]ccsdtj|dddD]&\}}}dd|D|dd<|D]}tj|d|jvr.t||Vqq dS)NT)topdown followlinkscSsg|]}|dkr|qS) __pycache__r)rdirrrrrsz3ModuleFinder._filter_py_modules..rP)oswalkr*splitextr7r)rAr*rootdirsfilesrelfilerrrrws zModuleFinder._filter_py_modulesc Cs|r|n|j}|}|jD]%}ttt||}|jdWdS1s0wYq|j|krQ|jd rQ|j}|j|krQ|jd sB| d|j|j S)Nrr_) rrvrCr8r ValueError IndexErrorrxr{rdrIr))rAr* parent_path search_pathrel_pathrrrrTs  &zModuleFinder._top_module_namer!)r8r9rr:)r*rrr:)rFrGr*rrr:)rLrMrJr rKr rrN)rYrrr^)r*rmrnrorrp)rLrrr)r*rrr)r*rrr2)rr:)r*rrr)r*rrr)r,r-r.r/r6r0rsr7rBr=rIr]rWrtrrSrarr@rwrTrrrrr3Xs,     S2 B     r3zG(?:__import__\([\"']pkg_resources[\"']\).declare_namespace\(__name__\))zP(?:__path__ = __import__\([\"']pkgutil[\"']\).extend_path\(__path__, __name__\))z^import[ \t]+\w+$rlrcCs$|jdd}tt|pt|S)N utf-8-sigencoding) read_textr _re_pkgresourcessearch _re_pkgutil)rlcoderrrres rename_parts_and_pathNamePartsAndPathTyperGcCs t|dS)Nr)rz)rrrrrs rc@s"eZdZUded<dZded<dS)_SPrr*rrrrN)r,r-r.r0rrrrrrs rr* list[_SP]c Csg}z|jdd}Wn ty|YSw|ddjddD]K}|}t|rW|j|tdd d}t t t |WdS1sRwY|rm| d smtj|rm|tt|q"|S) Nrr; Fkeependsimportr4#)rUnicodeDecodeErrorstripreplace splitlines_re_import_liner"rvrzlstriprr _handle_editable_module startswithrr*rdrDrr)r* directoriestextlineeditable_modulerrrrs"     $rc Cst|jgttRrHz|jddjdd}Wnty*}zt||d}~wwt |d dd}|j drCt |j j gSt |gSt|jtrt|}|jD]6}t|tjrf|jd }n t|tjrp|j}nqXt|tjr|jd krt|jtjrd d |jjDSqXt|jtrt|}|jD]B}t|tjrt|jtjrt|jjtjr|jjjd krt|jj dtj!rt |jj djd}t"|#j}t ||dgSqt|)NrrFrrq'rBrMAPPINGcSs(g|]}t|tjrtt|jjqSr)rRastConstantrrvaluerv)rcstrrrrs(z+_handle_editable_module..installrPsrc)r)$r'r)_editable_editables_patterns$_editable_scikit_build_core_patternsrrrrUr rrVrrrv_editable_setuptools_patternsrparsebodyrRAssigntargets AnnAssigntargetNameidrDictvalues_editable_meson_python_patternsExprCallfuncargsrnextr) r*editable_lineserrornew_path parsed_modulenoder build_pathpkg_namerrrrsN        $    r)rrrrrr )rlrrr )rrrrG)r*rrr)2 __future__rrrrr< collectionsr contextlibr dataclassesr itertoolsrpathlibrtypingrr griffe._internal.exceptionsr griffe._internal.loggerr collections.abcr r rgriffe._internal.modelsrrrrrtupler NamePartsTyperr'r(r1r3rrrrrerrrrrrrrsT              N