-hTnddlmZddlZddlZddlZddlZddlmZddlm Z ddl m Z ddl m Z ddlmZddlmZmZdd lmZdd lmZerdd lmZmZdd lmZdd lmZddDZddDZddDZddDZ e!e"dfZ# e!e#efZ$ d4dZ%e GddZ&e Gd d!Z'Gd"d#Z(ej)d$Z*ej)d%Z+ej)d&Z,d5d)Z-d6d-Z.e Gd.d/Z/d7d2Z0d7d3Z1dS)8) annotationsN) defaultdict)suppress) dataclass)chain)Path) TYPE_CHECKINGClassVar)UnhandledEditableModuleError)logger)IteratorSequence)Pattern)Modulec6g|]}tj|Srecompile.0pats K/var/www/FlaskApp/flask-venv/lib/python3.11/site-packages/_griffe/finder.py r(s sssC 3sss)z^__editables_\w+\.py$z^_editable_impl_\w+\.py$c6g|]}tj|Srrrs rrr)s X X XSC X X Xr)z^__editable__\w+\.py$c6g|]}tj|Srrrs rrr*s '\'\'\C 3'\'\'\r)z^_\w+_editable.py$c6g|]}tj|Srrrs rrr+s "^"^"^s2:c??"^"^"^r)z^_\w+_editable_loader.py$.stringstrpatternsSequence[Pattern]returnboolc:tfd|DS)Nc3BK|]}|VdSN)match)rpatternrs r z!_match_pattern..4s/==w}}V$$======r)any)rr!s` r_match_patternr,3s& ====H=== = ==rc:eZdZUdZded< 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). r namerpathNz Path | Nonestubs)__name__ __module__ __qualname____doc____annotations__r1rrrr.r.7sGIIIJJJErr.c*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. r r/ list[Path]r0N)r2r3r4r5r6rrrr8r8Is6III!))rr8ceZdZUdZgdZded< eeZded< d2d3d Zd4dZ d5dZ dddd6dZ d7d Z d2d8d%Z d9d(Zd:d*Zd;d,Zd4d-Zdd1ZdS)? 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] | Noner#Noneci|_g|_ |p tjD]$}|t |%t t|_| dS)zmInitialize the finder. Parameters: search_paths: Optional paths to search into. N) _paths_contentsr@sysr0append_search_pathrrlist_always_scan_for_extend_from_pth_files)selfr@r0s r__init__zModuleFinder.__init__fst 8:(*&!,CH 0 0D  # #DJJ / / / /7B47H7H ##%%%%%rr0rcx|}||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)resolver@appendrJr0s rrFzModuleFinder.append_search_pathwsD||~~ t( ( (   $ $T * * * * * ) (rpositionintcz|}||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)rMr@insert)rJrPr0s rinsert_search_pathzModuleFinder.insert_search_pathsF||~~ t( ( (   $ $Xt 4 4 4 4 4 ) (rTF)try_relative_pathfind_stubs_packagemodule str | PathrUr$rV&tuple[str, Package | NamespacePackage]ct|tr.||\}}||}n|rj |t|\}}||}nL#t$r!|}|ddd}Yn"wxYw|}|ddd}|s|||fS ||}n#t$rd}YnwxYw ||dz}n#t$rd}YnwxYw||t||r||rzt|tr"t|tr |j |_ n?t|tr*t|tr|xj |j z c_ ||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.r0r1r8) rJrWrUrV module_name module_pathtop_module_namepackager1s r find_speczModuleFinder.find_specs5N fd # # 6'+'='=f'E'E $K"33K@@OO  6 E+/+A+A$v,,+O+O( [ #'"7"7 "D"D % : : :$ "(,,sA"6"6q"9 : !K$ll32215O" C 1 1/ B BB B ''88GG"   GGG  %%o&@AAEE"   EEE  ?u}%o66 6  (u ('7++ + 5'0J0J + %  G%566 +:eM];^;^ +  * ' 'G,u,,s6%B(B-,B-(C>> D  D D** D98D9rer Package | NamespacePackagect|t|dg}|}|d}g}|jD]}||}|r|D]}||z }||vr|jr@|d} t ||| r| ndccS|dz } | rOt| s@| d} t || | r| ndccS|dz } | rt || dccS| ||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. r<r]r=N __init__.pyz __init__.pyi) r removesuffixr@ _contentssuffix with_suffixr.exists_is_pkg_style_namespacerNr8rd) rJre filepathsreal_module_namenamespace_dirsr0 path_contentschoiceabs_pathr1 init_modules rrczModuleFinder.find_packages    K$$$ % %  '+88BB% 8 8D NN400M 8'88F#f}H=00#?j$,$8$8$@$@E#*+;XPUP\P\P^P^Ghuudh#i#iiiiii&.&> &--//m8OP[8\8\m$/$;$;F$C$CE#*+;[SXS_S_SaSaJk%%gk#l#llllll&.&? &--//P#*+;[$#O#OOOOOO&--h777  A#K@@ @!+...rPath | list[Path]seen set | NoneIterator[NamePartsAndPathType]c#Kt|tr1t}|D]}|||Ed{VdS|jdkr|j}n|j|jvrdSt|pd}||D]}| |}|j|vrtj d|6|jdk}|j}|s| ddd}|dkrIt|jdkr|jdd |fV|||j|r|d j|fV||j|fVdS) 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. NrKrz'Skip %s, another module took precedencer<r[r\r)r^rGsetiter_submodulesstemparentror?_filter_py_modules relative_tor debugrblenpartsaddrp with_name) rJr0r{ path_elemskipsubpath rel_subpathpy_filers rrzModuleFinder.iter_submoduless* dD ! ! 55D! A A // 4@@@@@@@@@@ F 9 " ";DD[D/ / / F 4:2..t44 A AG!--d33K!T)) FPPP!(E1G#D -zz#q))!,z!!{())Q..!',g5555#HH[/000 A!--b117@@@@@!++D117@@@@@- A Arrlist[NamePartsAndPathType]c tt||j||j|jt S)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)sortedrrfilepathrHr/ _module_depth)rJrWs r submoduleszModuleFinder.submodulesVs[ $$V_55$$T%:6;%GHH       rtuple[str, Path]c@|}|r:|jD])}|d|z }|r |j|fcS*|j|fS|r"|jdkr|jj|fS|j|fSt)NrK)absoluteis_dirr>rqr/rrra)rJr0extrfs rr_zModuleFinder._module_name_pathgs}} ;;== #9 2 2"%5%5%55 %%''29k111129d? " ;;== #yJ&&{'--9d? "rr9c||jvrL t||j|<n!#ttf$r g|j|<YnwxYw|j|Sr')rDrGiterdirraNotADirectoryErrorrOs rrnzModuleFinder._contentsvsw t+ + + 0-1$,,..-A-A$T**%'9: 0 0 0-/$T*** 0#D))s)5AAcP||jvr|j|dSdSr')r@rNrOs r_append_search_pathz ModuleFinder._append_search_path~s5 t( ( (   $ $T * * * * * ) (rc:|jD]}||D]z}|jdkrmt|D]]}|jx}r8|j||j|| |j^{dS)Nz.pth) r@rnro_handle_pth_filealways_scan_forrHrNr0joinpathrF)rJr0item directoryscans rrIz#ModuleFinder._extend_from_pth_filess% @ @Dt,, @ @;&((%5d%;%;@@ #,#<<4^ 1$7>>y~?V?VW[?\?\]]]// ????  @ @ @rIterator[Path]c#Ktj|ddD]Z\}}}d|D|dd<|D]@}tj|d|jvrt ||VA[dS)NT)topdown followlinkscg|] }|dk| S) __pycache__r)rdirs rrz3ModuleFinder._filter_py_modules..s"CCCsc].B.Bs.B.B.Brr\)oswalkr0splitextr?r)rJr0rootdirsfilesrelfiles rrzModuleFinder._filter_py_moduless!#t!N!N!N . . D$CCdCCCDG  . .7##G,,Q/43FFFtW----- . . .rc6|r|n|j}|}|jD]j}t t t 5||}|jdcdddcS#1swxYwYk|j|krJ|jdz r.|j}|j|kr|jdz .| d|j|j S)Nrrl) rrrMr@r ValueError IndexErrorrrrqrTr/)rJr0 parent_path search_pathrel_paths rr`zModuleFinder._top_module_names["kkmmr6rr?rKrFrTrircrrr_rnrrIrr`rrrr;r;Xs:h9g9g!gggg5),-J)K)KNKKKK4&&&&&" + + + + 5 5 5 5$#'#( Q-Q-Q-Q-Q-Q-f-/-/-/-/d @A@A@A@A@AD    "     ****++++@@@@....      rr;zG(?:__import__\([\"']pkg_resources[\"']\).declare_namespace\(__name__\))zP(?:__path__ = __import__\([\"']pkgutil[\"']\).extend_path\(__path__, __name__\))z^import[ \t]+\w+$ryrc|d}tt|pt|S)Nutf8encoding) read_textr$_re_pkgresourcessearch _re_pkgutil)rycodes rrrrrsH  & 1 1D  ''--I1C1CD1I1I J JJrname_parts_and_pathNamePartsAndPathTyperQc,t|dS)Nr)r)rs rrrs "1% & &&rc(eZdZUded<dZded<dS)_SPrr0rr rN)r2r3r4r6rrrrrrs,JJJOrrr0 list[_SP]cg} |d}n#t$r|cYSwxYw|dddD]}|}t |rq|j|tdd dz }tt5t|cdddcS#1swxYwY|rc| d sNtj|r/|t%t'| |S) Nrr; Fkeependsimportr<#)rUnicodeDecodeErrorstripreplace splitlines_re_import_liner(rrlstriprr _handle_editable_module startswithrr0rqrNrr)r0 directoriestextlineeditable_modules rrrs K~~v~..  $$S$//::E:JJ00zz||   & & @"ktCMMOO/D/K/K/M/M,R,R,RRO677 @ @.?? @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @  0,, 01E1E 0   s4:: / / / s **"DD D czt|jgttRr |dd}n"#t$r}t||d}~wwxYwt|d dd}|j drt|j j gSt|gSt|jtrtj|}|jD]}t%|tjr|jd }n#t%|tjr|j}nMt%|tjrB|jd kr7t%|jtjrd |jjDcSt|jt8r+tj|}|jD]}t%|tjrt%|jtjrt%|jjtjr|jjjd krt%|jj d tj!r_t|jj d jd}tE|#j}t||gcSt|)NrrFrr'rKrMAPPINGcg|]B}t|tjtt |jjCSr)r^astConstantrrvaluer)rcsts rrz+_handle_editable_module..s@rrrT^_bdgdpTqTqrDOO233rrrrinstallr\src)r)$r,r/_editable_editables_patterns$_editable_scikit_build_core_patternsrrrrar rrbrrr_editable_setuptools_patternsrparsebodyr^Assigntargets AnnAssigntargetNameidrDictvalues_editable_meson_python_patternsExprCallfuncargsrnextr) r0editable_lineserrornew_path parsed_modulenoder build_pathpkg_names rrrsdi!g#?!gBf!g!ghh   @!^^V^<<BBDDOOY^O__NN  @ @ @.t44% ? @r*0055a899 = # #J / / 1.//0 0H di!>?? s $.."2"233 !& s sD$ ++ aD#-00 &#(++ s Y0F0F:VZV`bebjKkKk0Frrtz?Prrrrrrdi!@AAC $.."2"233 !& C CD4** Ctz3844 Ctz99 CJO&)33tzq13<@@4"$*/!"4":EBB  2 2 4 455:JAAABBBB &t , ,,srs "#""""" ######!!!!!!********;;;;;;!!!!!!&22222222%%%%%% ts;rsss X X]"^"^"^c3h 0]D01=>>>>  "  * * * * * * *  *I I I I I I I I X 2:hiibjlmm "*122 KKKK ''''   <------------r