iT.SSKJr SSKrSSKrSSKrSSKrSSKJr SSKJ r SSK J r SSK J r SSKJr SSKJrJr SS KJr SS KJr \(aSS KJrJr SS KJr SS KJr SVs/sHn\R;U5PM snrSVs/sHn\R;U5PM snrSVs/sHn\R;U5PM snr SVs/sHn\R;U5PM snr!\"\#S4r$\"\$\4r%S#Sjr&\ "SS55r'\ "SS55r("SS5r)\R:"S5r*\R:"S5r+\R:"S5r,S$Sjr-S%Sjr.\ "SS 55r/S&S!jr0S&S"jr1gs snfs snfs snfs snf)') annotationsN) defaultdict)suppress) dataclass)chain)Path) TYPE_CHECKINGClassVar)UnhandledEditableModuleError)logger)IteratorSequence)Pattern)Module)z^__editables_\w+\.py$z^_editable_impl_\w+\.py$)z^__editable__\w+\.py$)z^_\w+_editable.py$)z^_\w+_editable_loader.py$.c.^[U4SjU55$)Nc3D># UHoRT5v M g7fN)match).0patternstrings Q/home/james-whalen/.local/lib/python3.13/site-packages/griffe/_internal/finder.py !_match_pattern..4s=H}}V$$Hs )any)rpatternss` r_match_patternr3s =H= ==c@\rSrSr%SrS\S'S\S'SrS\S 'S rg) Package7zThis 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). strnamerpathNz Path | Nonestubs)__name__ __module__ __qualname____firstlineno____doc____annotations__r%__static_attributes__r&rrr r 7s& I JE;rr c0\rSrSr%SrS\S'S\S'Srg) NamespacePackageIzThis 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]r$r&N)r'r(r)r*r+r,r-r&rrr/r/Is I! )rr/c\rSrSr%Sr/SQrS\S'\"\5rS\S'SSS jjr SS jr SS jr SS jr S SS.SSjjr SSjrSS SjjrS!SjrS"SjrS#SjrS$SjrS%SjrS&SjrSrg)' ModuleFinderXaRThe 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_setNc0Ul/UlU=(d [RHnUR [ U55 M [ [5UlUR5 g)zUInitialize the finder. Parameters: search_paths: Optional paths to search into. N) _paths_contents search_pathssysr$append_search_pathrrlist_always_scan_for_extend_from_pth_files)selfr;r$s r__init__ModuleFinder.__init__fs] 8:(*&!,CHH,D  # #DJ /-8C47H ##%rcBURUR55 g)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)_append_search_pathresolverAr$s rr=ModuleFinder.append_search_pathws   0rcZXR;aURRU5 ggr)r;appendrGs rrE ModuleFinder._append_search_paths' (( (    $ $T * )rczUR5nX R;aURRX5 gg)zInsert 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)rFr;insert)rApositionr$s rinsert_search_pathModuleFinder.insert_search_paths4||~ (( (    $ $X 4 )rTF)try_relative_pathfind_stubs_packagec[U[5(a%URU5upEURU5nOMU(a/UR[U55upEURU5nOUnUR SS5SnU(dX@R U54$UR U5nUR US-5nUcUc [U5eU(aU(a[U[5(a)[U[5(aURUl XG4$[U[5(a4[U[5(aU=RUR- sl XG4$XG=(d U4$![a UnUR SS5SnGNf=f![a SnGNf=f![a SnNf=f)a}Find 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%r/) rAmodulerQrR module_name module_pathtop_module_namepackager%s r find_specModuleFinder.find_specsN fd # #'+'='=f'E $K"33K@O  E+/+A+A$v,+O( #'"7"7 "D K$ll3215O" 1 1/ BB B ''8G %%o&@AE ?u}%o6 6 u'7++ 5'0J0J %  ' 'G%566:eM];^;^  * ' ',u,,I% :$ "(,,sA"6q"9 : # G # E s6E="F%4F8=!F"!F"% F54F58 GGc[U5[US35/nUnURS5n/nURGHnURU5nU(dMUHnXW- nX;dMUR(a8UR S5n [ X8U R5(aU OS5s s $US- n U R5(aH[U 5(d8U R S5n [ X:U R5(aU OS5s s $US- n U R5(a[ X:S5s s $URU5 M GM U(a [X5$[U5e)zFind 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. r5rVr6N __init__.pyz __init__.pyi) r removesuffixr; _contentssuffix with_suffixr exists_is_pkg_style_namespacerJr/r]) rAr_ filepathsreal_module_namenamespace_dirsr$ path_contentschoiceabs_pathr% init_modules rr\ModuleFinder.find_packagesX   K=$ %  '+88B%%D NN40M}'F#}H0#??$,$8$8$@E#*+;PUP\P\P^P^udh#ii&.&> &--//8OP[8\8\$/$;$;F$CE#*+;SXS_S_SaSa%gk#ll&.&? &--//#*+;$#OO&--h7(&& #K@ @!+..rc#~# [U[5(a-[5nUHnURX25ShvN M gURS:Xa UR nOUR UR;ag[U=(d S5nURU5GHnURU5nUR U;a[R"SU5 M>UR S:HnURnU(dURSS5SnUS:XaP[UR5S:XaMURSS U4v UbURUR 5 MMU(a!UR!S 5RU4v MUR#U5RU4v GM gGN7f) aiIterate 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. NrBr&z'Skip %s, another module took precedencer5rTrUr)rWr>setiter_submodulesstemparentrir8_filter_py_modules relative_tor debugr[lenpartsaddrj with_name) rAr$seen path_elemskipsubpath rel_subpathpy_filerzs rryModuleFinder.iter_submoduless* dD ! !5D! // @@@"  99 ";;D[[D// /  4:2..t4G!--d3K!!T) FP!((E1G##Dzz#q)!,z!{(()Q.!'',g55#HH[//0$!--b177@@!++D177@@-5!As9F=F:E?F=c [[URUR5URURUR 55[ S9$)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)sortedrryfilepathr?r# _module_depth)rAr^s r submodulesModuleFinder.submodulesXsM $$V__5$$T%:%:6;;%GH    rcUR5nUR5(aNURH0nUSU3- nUR5(dM"URU4s $ URU4$UR5(a6UR S:XaUR RU4$UR U4$[e)NrB)absoluteis_dirr7rkr#rzr{rZ)rAr$extr`s rrXModuleFinder._module_name_pathis}} ;;==99"xu%55 %%''99k11:99d? " ;;==yyJ&{{''--99d? "rcXR;a'[UR55URU'URU$![[4a /URU'N0f=fr)r:r>iterdirrZNotADirectoryErrorrGs rrhModuleFinder._contentsxsh ++ + 0-1$,,.-A$$T*##D))&'9: 0-/$$T* 0s&AA('A(clURHnURU5HnURS:XdM[U5HhnUR=n(a7UR UR URRU55 URUR5 Mj M M g)Nz.pth) r;rhri_handle_pth_filealways_scan_forr?rJr$joinpathr=)rAr$item directoryscans rr@#ModuleFinder._extend_from_pth_filess%%Dt,;;&(%5d%; #,#<#<<4< 11$7>>y~~?V?VW[?\]// ?&<-&rc# # [R"USSS9Hkup#nUVs/sH oUS:wdM UPM snUSS&UHBn[RRU5SUR;dM5[ X&5v MD Mm gs snf7f)NT)topdown followlinks __pycache__rU)oswalkr$splitextr8r)rAr$rootdirsfilesdirrelfiles rr|ModuleFinder._filter_py_modulessy!#t!N D&*Cds].BsdCDG 77##G,Q/43F3FFt--!"OCs!B B B 9B3Bc~UR5(aUO URnUR5nURHOn[ [ [ 5 URUR55nURSsSSS5 s $ URU:wabURS- R5(a@URnURU:wa$URS- R5(aM@URSUR5 UR$!,(df  M=f)Nrrf) rr{rFr;r ValueError IndexErrorr}rrkrOr#)rAr$ parent_path search_pathrel_paths rrYModuleFinder._top_module_names"kkmmd !))+ ,,K*j1&22;3F3F3HI~~a(21-   K/[5G5G-5W4_4_4a4a%,,K  K/[5G5G-5W4_4_4a4a ;#5#5621s .D-- D< )r?r:r;r)r;zSequence[str | Path] | NonereturnNone)r$rrr)rNintr$rrr)r^z str | PathrQboolrRrrz&tuple[str, Package | NamespacePackage])r_r"rzPackage | NamespacePackage)r$zPath | list[Path]rz set | NonerzIterator[NamePartsAndPathType])r^rrzlist[NamePartsAndPathType])r$rrztuple[str, Path])r$rrr1)rr)r$rrzIterator[Path])r$rrr")r'r(r)r*r+r7r,rxr8rBr=rErOrcr\ryrrXrhr@r|rYr-r&rrr3r3Xs:h!#6g5),-J)KN&K4&" 1+ 5$#'#( Q-Q- Q- ! Q- 0 Q-f-/d @A@A@A ( @AD "  *@. rr3zG(?:__import__\([\"']pkg_resources[\"']\).declare_namespace\(__name__\))zP(?:__path__ = __import__\([\"']pkgutil[\"']\).extend_path\(__path__, __name__\))z^import[ \t]+\w+$cURSS9n[[RU5=(d [RU55$)N utf-8-sigencoding) read_textr_re_pkgresourcessearch _re_pkgutil)rscodes rrlrls<  + 6D  ''-I1C1CD1I JJrc[US5$)Nr)r)name_parts_and_paths rrrs "1% &&rc.\rSrSr%S\S'SrS\S'Srg) _SPirr$rwr"rr&N)r'r(r)r*r,rr-r&rrrrs JOSrrc/nURSS9nUR5RSS5R SS9HnUR5n[ R U5(aRURU[S5SR5S3- n[[5 [U5sSSS5 s $U(dMURS 5(aM[RR!U5(dMUR#[%['U555 M U$![a Us$f=f!,(df  N=f) Nrr; Fkeependsimportr5#)rUnicodeDecodeErrorstripreplace splitlines_re_import_linerr{rlstriprr _handle_editable_module startswithrr$rkrJrr)r$ directoriestextlineeditable_modules rrrs K~~{~3 $$S$/::E:Jzz|   & &"kktCMO/D/K/K/M.Nc,RRO67.?87 4,,1E1E   s4: /K   87sD/( E/ D>=D> E c [UR/[Q[Q75(aUR SS9R 5R SS9n[USRS5S5nURRS5(a [URR5/$[U5/$[UR[5(Ga`[R "UR S S95nUR"GH,n[%U[R&5(aUR(S nO.[%U[R*5(a UR,nOMa[%U[R.5(dMUR0S :XdM[%UR2[R45(dMUR2R6Vs/sHLn[%U[R85(dM$[[UR25R5PMN sns $ [UR[:5(Gap[R "UR S S95nUR"GH<n[%U[R<5(dM%[%UR2[R>5(dMP[%UR2R@[R.5(dMUR2R@R0S :XdM[%UR2RBS [R85(dM[UR2RBS R2S5n[EURG55Rn [XS9/s $ [U5e![an[U5UeSnAff=fs snf)NrrFrrv'rButf8rMAPPINGinstallrUsrc)r)$rr#_editable_editables_patterns$_editable_scikit_build_core_patternsrrrrZr rr[rrr{_editable_setuptools_patternsastparsebodyrWAssigntargets AnnAssigntargetNameidvalueDictvaluesConstant_editable_meson_python_patternsExprCallfuncargsnextr) r$editable_lineserrornew_path parsed_modulenodercst build_pathpkg_names rrrsdii!g#?!gBf!ghh  @!^^[^AGGITT^cTdNr*005a89 == # #J / /../0 0H dii!>?? $..&."AB !&&D$ ++aD#--00&#((++ Y0F:VZV`V`bebjbjKkKk?Czz?P?Pr?PT^_bdgdpdpTq3DO223?Prr'dii!@AA $..&."AB !&&D4**tzz38844tzz99JJOO&&)3tzzq13<<@@!$**//!"4":":EB  2 2 45::JABB' 't ,,K! @.t4% ? @&ss#*O&#O9 ,O9 O6% O11O6)rr"rzSequence[Pattern]rr)rsrrr)rNamePartsAndPathTyperr)r$rrz list[_SP])2 __future__rrrrer< collectionsr contextlibr dataclassesr itertoolsrpathlibrtypingr r griffe._internal.exceptionsr griffe._internal.loggerr collections.abcr rrgriffe._internal.modelsrcompilerrrrtupler" NamePartsTyperrr r/r3rrrrlrrrr)pats0rrs"# #!*D*2.]"^>]s2::c?>]"^c3h 0]D01=>  "  * *  *G G T ::hijjlm **12 K '   <--] t X'\"^s(F F,F F