ii 6%SSKJr SSKrSSKrSSKrSSKrSSKrSSKJr SSKJ r J r J r J r SSKJr SSKJrJr SSKJr SSKJrJr SS KJrJrJr SS KJrJrJrJrJ r SS K!J"r"J#r# SS K$J%r% SS K&J'r' SSK(J)r)J*r*J+r+J,r,J-r-J.r.JrJ/r/J0r0J1r1J2r2 \(aSSK3J4r4 SSK5J6r6 SSK7J8r8J9r9 SSKJ:r: S\;S'SSKa \4r=GNQf=fs snnnf)#) annotationsN) Parameter) Signaturecleandocgetsourcelinesunwrap) signature) TYPE_CHECKINGAny) ObjectNode)LinesCollectionModulesCollection)Kind ParameterKindTypeParameterKind)Expr ExprBinOp ExprSubscript ExprTuplesafe_get_annotation) Extensionsload_extensions)dynamic_import)logger) Alias AttributeClass DocstringFunctionModuler Parameters TypeAlias TypeParameterTypeParameters)Sequence)Path)DocstringOptionsDocstringStyle)Parserztuple[types.ModuleType, ...]_TYPING_MODULES)filepath import_paths extensionsparentdocstring_parserdocstring_optionslines_collectionmodules_collectionc b[UUU=(d [5UUUUUS9RU5$)aInspect a module. Sometimes we cannot get the source code of a module or an object, typically built-in modules like `itertools`. The only way to know what they are made of is to actually import them and inspect their contents. Sometimes, even if the source code is available, loading the object is desired because it was created or modified dynamically, and our static agent is not powerful enough to infer all these dynamic modifications. In this case, we load the module using introspection. Griffe therefore provides this function for dynamic analysis. It uses a [`NodeVisitor`][ast.NodeVisitor]-like class, the [`Inspector`][griffe.Inspector], to inspect the module with [`inspect.getmembers()`][inspect.getmembers]. The inspection agent works similarly to the regular [`Visitor`][griffe.Visitor] agent, in that it maintains a state with the current object being handled, and recursively handle its members. Important: This function is generally not used directly. In most cases, users can rely on the [`GriffeLoader`][griffe.GriffeLoader] and its accompanying [`load`][griffe.load] shortcut and their respective options to load modules using dynamic analysis. Parameters: module_name: The module name (as when importing [from] it). filepath: The module file path. import_paths: Paths to import the module from. extensions: The extensions to use when inspecting the module. parent: The optional parent of this module. docstring_parser: The docstring parser to use. By default, no parsing is done. docstring_options: Docstring parsing options. lines_collection: A collection of source code lines. modules_collection: A collection of modules. Returns: The module, with its members populated. )r/r0r1r2) Inspectorr get_module) module_namer+r,r-r.r/r0r1r2s [/home/james-whalen/.local/lib/python3.13/site-packages/griffe/_internal/agents/inspector.pyinspectr87s>d 'o')+)- j cH^\rSrSrSrSSU4SjjjrSSjrSSjrSS SjjrS!Sjr S!Sjr S!S jr S!S jr S!S jr S!S jrS!S jrS!SjrS!SjrS!SjrS!SjrS!SjrS!SjrS!SjrS!SjrSS"SjjrS!SjrS!SjrSS#SjjrSrU=r$)$r4uzrThis class is used to instantiate an inspector. Inspectors iterate on objects members to extract data from them. c >[T U]5 XlX lX0lX@lSUlXPlU=(d 0UlU=(d [5Ul U=(d [5Ul g)aInitialize the inspector. Parameters: module_name: The module name. filepath: The optional filepath. extensions: Extensions to use when inspecting. parent: The module parent. docstring_parser: The docstring parser to use. docstring_options: Docstring parsing options. lines_collection: A collection of source code lines. modules_collection: A collection of modules. N) super__init__r6r+r-r.currentr/r0r r1rr2) selfr6r+r-r.r/r0r1r2 __class__s r7r>Inspector.__init__{s{.  +%- #&04%+ ='+ 1@P*3D3J,1A1V_EV05G5^K\K^&r9c[URSS5nUcg[U5n[ UUR URS9$![a gf=f![a gf=f)N__doc__)parserparser_options)getattrobj ExceptionrAttributeErrorrr/r0)r@nodevaluecleaneds r7_get_docstringInspector._get_docstrings~ DHHi6E = uoG ((11      s"A A AA A%$A%cUR(aURUR;ag[UR5up#X3SR U5R5RS5-4$![[ 4a gf=f)N)NN ) r+r1rrHOSError TypeErrorjoinrstripcount)r@rKlineslinenos r7 _get_linenosInspector._get_linenossw}} T5J5J J *4884ME 5 5 7 = =d CCCC#  sA77B  B cURnURbURRSU3n[U=(d S5nUR(aURRn[ UR S55HnURnM URRS:Xa URnX1;aURSU5 [X!5nSnURb6URRRS5H n[SXvS9nM [XPRUS9nURU5 URR$)aBuild and return the object representing the module attached to this inspector. This method triggers a complete inspection of the module members. Parameters: import_paths: Paths replacing `sys.path` to import the module. Returns: A module instance. N.r>r)namer.)r.)r6r.pathlistr+rangerWsteminsertrsplitr r8r?module) r@r, import_path parent_path_rL parent_nodepart module_nodes r7r5Inspector.get_modules+&& ;; "![[--.a }=KL.B/  ==--..K;,,S12)00 3}}!!Z/)00 .##A{3{9  ;; " ((..s3(DM 4 (8(8M  [!||"""r9cX[USUR3UR5"U5 g)zXExtend the base inspection with extensions. Parameters: node: The node to inspect. inspect_N)rGkindgeneric_inspectr@rKs r7r8Inspector.inspects&  ,d.B.BCDIr9c dURGHnUR=n(GavUR(Ga X0RRSUR 3:Xa[ URS5(d[R"SU5 [UR SURRURURURURUR S9nUR#U5 URR%UR URR5 GM2GM5['UR USS9nURR%UR U5 URR)SXQUS 9 GMUR+U5 GM g) z`Extend the base generic inspection with extensions. Parameters: node: The node to inspect. r]__file__z;Module %s is not discoverable on disk, inspecting right nowN)r+r.r-r/r0r1r2dynamic)analysison_alias_instance)aliasrKagent)childrenalias_target_path is_moduler?r`r_hasattrrHrdebugr4rfr-r/r0r1r2inspect_module set_memberrcallr8)r@rKchild target_path inspectorrys r7rqInspector.generic_inspectsF ]]E#555{5???{9J9J8K1UZZL6Y'Y"599j99 %bdop$-!JJ%)#'<<#6#6'+-1-B-B.2.D.D-1-B-B/3/F/F % "007 // IOO(()Inspect a module. Parameters: node: The node to inspect. on_noderKrzon_module_noderv)r_r+r. docstringr1r2rw on_instancerKrHrzon_module_instance)rKmodrz on_memberson_module_membersN) r-rr r6r+r.rNr1r2r?rq)r@rKrfs r7rInspector.inspect_module,s YT> -DE &!!]];;))$/!22#66!   v ]N 1PTU T" \M 0ttTr9c lURRSXS9 URRSXS9 /nURRH8nU[LaMUR UR SUR35 M: URU5upE[URURU5U[[URURURS96UUSS9nURRURU5 X`lURRSXUS 9 URRS XUS 9 UR!U5 URRS XUS 9 URRS XUS 9 URR"Ulg)z=Inspect a class. Parameters: node: The node to inspect. rr on_class_noder]r.memberrv)r_rbasestype_parametersrY endlinenorwrron_class_instance)rKclsrzron_class_membersN)r-rrH __bases__objectappend __module__ __qualname__rZrr_rNr$_convert_type_parametersr?rrqr.)r@rKrbaserYrclass_s r7 inspect_classInspector.inspect_classCs YT> _4DHH&&Dv~ LLDOO,Ad.?.?-@A B' !--d3))$/*,DTXXVZVbVbkoktkt,uv   62  ]N 0ttT T" \M /ddS||** r9c*URUS15 g)zEInspect a static method. Parameters: node: The node to inspect. staticmethodNhandle_functionrrs r7inspect_staticmethodInspector.inspect_staticmethodes TN#34r9c*URUS15 g)zDInspect a class method. Parameters: node: The node to inspect. classmethodNrrrs r7inspect_classmethodInspector.inspect_classmethodms TM?3r9c*URUS15 g)zIInspect a method descriptor. Parameters: node: The node to inspect. zmethod descriptorNrrrs r7inspect_method_descriptor#Inspector.inspect_method_descriptorus T$7#89r9c*URUS15 g)zFInspect a builtin method. Parameters: node: The node to inspect. builtinNrrrs r7inspect_builtin_method Inspector.inspect_builtin_method} TI;/r9c&URU5 g)z>Inspect a method. Parameters: node: The node to inspect. Nrrrs r7inspect_methodInspector.inspect_method T"r9c*URUS15 g)zAInspect a coroutine. Parameters: node: The node to inspect. asyncNrrrs r7inspect_coroutineInspector.inspect_coroutines TG9-r9c*URUS15 g)zHInspect a builtin function. Parameters: node: The node to inspect. rNrrrs r7inspect_builtin_function"Inspector.inspect_builtin_functionrr9c&URU5 g)z@Inspect a function. Parameters: node: The node to inspect. Nrrrs r7inspect_functionInspector.inspect_functionrr9c,URUSS15 g)zGInspect a cached property. Parameters: node: The node to inspect. cachedpropertyNrrrs r7inspect_cached_property!Inspector.inspect_cached_propertys THj#9:r9c*URUS15 g)z@Inspect a property. Parameters: node: The node to inspect. rNrrrs r7inspect_propertyInspector.inspect_property TJ<0r9c*URUS15 g)zJInspect a get/set descriptor. Parameters: node: The node to inspect. rNrrrs r7inspect_getset_descriptor#Inspector.inspect_getset_descriptorrr9c bURRSXS9 URRSXS9 [UR5n[ UR R 5Vs/sH!n[X@RURS9PM# sn6nURnU[LaSO[X`RURS9nURU5upU=(d [5nSU;a)[!URSUUR#U5UU SS9n OV[%URUU['[)URURURS96UR#U5UU SS 9n U =R*U-slURR-URU 5 URRS XUS 9 U R.(aURRS XUS 9 gURRSXUS9 gs snf![a SnSnGN`f=f)zmHandle a function. Parameters: node: The node to inspect. labels: Labels to add to the data object. rron_function_noderNrrv)r_rL annotationrrYrrw)r_ parametersreturnsrrrYrrwrron_attribute_instancerKattrrzon_function_instance)rKfuncrz)r-r getsignaturerHr!rvalues_convert_parameterr?r_return_annotation_empty_convert_object_to_annotationrIrZsetrrNrr$rlabelsr is_attribute) r@rKrr parameterrrrrYrrHs r7rInspector.handle_functions YT> /dG $TXX.I$&/%9%9%@%@%B%B 'ydiiX%BJ !* ; ; %.23D\\bfbkbkl  !--d335  YY"--d3#"CYY% .-dhht||TXT]T]^!--d3#" C f   3/ ]dK    OO !8tUY Z OO !7dTX Y[ JG  sH,(HH.-H.clURRSXS9 URRSXS9 URU5up#[UR[ UR RURURS9UU[[UR URURS96URU5URSS9nURRURU5 URRSXUS9 URRS XUS 9 g ) zBInspect a type alias. Parameters: node: The node to inspect. rron_type_alias_noderrv)r_rLrYrrrr.rwrron_type_alias_instance)rK type_aliasrzN) r-rrZr"r__convert_type_to_annotationrH __value__r?r$rrNr)r@rKrYrrs r7inspect_type_aliasInspector.inspect_type_aliass YT> 1I --d3-dhh.@.@^b^g^gh*,DTXXVZVbVbkoktkt,uv))$/<<    :6 ]TR 5D_cdr9c&URU5 g)zBInspect an attribute. Parameters: node: The node to inspect. N)handle_attributerrs r7inspect_attributeInspector.inspect_attributes d#r9cURRSXS9 URRSXS9 URn[5nUR[ R LaURS5 OzUR[ RLaURS5 OKUR[ RLa.URS:wagURnURS5 [UR5nURU5n[!URUUUS S 9nU=R"U-slUR%URU5 URS :Xa['UR5UlURRS XUS 9 URRSXUS9 g![a SnNf=f![a SnNf=f)ziHandle an attribute. Parameters: node: The node to inspect. annotation: A potential annotation. rron_attribute_nodezmodule-attributezclass-attributer>Nzinstance-attributerv)r_rLrrrw__all__rrrr)r-rr?rrprMODULEaddCLASSFUNCTIONr_r.reprrHrIrNrrrraexports)r@rKrr.rrLr attributes r7rInspector.handle_attribute s YT> 0tH5 ;;$++ % JJ) * [[DJJ & JJ( ) [[DMM ){{j(]]F JJ+ , NE ++D1I!   F"$))Y/ 99 !!$((^FN ]DQ 44W[\) E  I s$5G G GG G&%G&) r?r0r/r-r+r1r6r2r.)NNNNN)r6strr+ Path | Noner-rr. Module | Noner/DocstringStyle | Parser | Noner0DocstringOptions | Noner1LinesCollection | Noner2ModulesCollection | NonereturnNone)rKr rzDocstring | None)rKr rz#tuple[int, int] | tuple[None, None])N)r,Sequence[str | Path] | Nonerr )rKr rr)rKr rz set | Nonerr)rKr rstr | Expr | Nonerr)__name__rr__firstlineno__rDr>rNrZr5r8rqrrrrrrrrrrrrrrrrr__static_attributes__ __classcell__)rAs@r7r4r4us!%;?59377;2'2'2' 2'  2' 9 2'32'12'52' 2'2'h ,D.#`J#$JU. +D54:0#.0#;11@ZDe2$.].]r9r4rc`URnUR[LaSO[URXS9n[UR nUR [LaSnOG[UR S5(aUR RnO[UR 5n[X4XVS9$)Nrr )rrpdefault) r_rrr_parameter_kind_maprprr~r rr)rr.rr_rrprs r7rrZs >>D   6 ) *9+?+? ^ y~~ .DF" ""J / /##,,y(() Tt MMr9c[U[5(aUnO3[U5n[US5(aSU;a UROUnOUn[ USS[ RSS9n[URXS9$![a Us$f=f)Nr <evalz<>)modefilenameflagsoptimizer) isinstancerrr~r compileast PyCF_ONLY_AST SyntaxErrorrbody)rHr.rrobj_reprannotation_nodes r7rrqs #s 9 3 # #*-hJ!J!*6DPSPaPalmn 33V KK  s A<< B  B )TypeVar TypeVarTuple ParamSpecc [U5n[US5(d/$/nURHn[USS5nUb [ XQUS9n[USS5Vs/sH n[ XaUS9PM nn[USS5"5(a[ UR UUS9nOSnUR [UR[[U5UU=(d SUS95 M U$s snf) N__type_params__ __bound__r__constraints__r^ has_defaultcg)NFr^r^r9r7*_convert_type_parameters..s%r9)rpbound constraintsr) rr~r&rGr __default__rr#r _type_parameter_kind_maptype) rHr.rrtype_parameterr- constraintr.rs r7rrs +C 3) * * O-- T:  /VTE&n6GL) L  ( & QL ) >=- @ B B1**G G ''-d>.BC'/4   %.8 1) sC$c H[R"U5nUc [XUS9$[R"U5Vs/sH n[ XAUS9PM nnU[ R La[R"SU5$[ X1US9nUcg[U[USS95$s snf)Nrc[USU5$)N|)r)leftrights r7r+-_convert_type_to_annotation..s IdC4Or9T)implicit) typing get_originrget_argsrtypes UnionType functoolsreducerr)rHr.roriginargargss r7rrs   s #F ~,SOOSYRaRabeRf)Rf3#CvFRf )  OQUVV (v NF ~ 4$!? @@)sB)r6rr+rr,rr-zExtensions | Noner.rr/rr0rr1rr2rrr )rSignatureParameterr.Module | Classr str | Nonerr)rHr r.rFrrGrr )rHr r.rFrrGrzlist[TypeParameter])X __future__rrr@sysr>r;r8rrErrrrr rr r %griffe._internal.agents.nodes.runtimer griffe._internal.collectionsr rgriffe._internal.enumerationsrrrgriffe._internal.expressionsrrrrr griffe._internal.extensions.baserrgriffe._internal.importerrgriffe._internal.loggerrgriffe._internal.modelsrrrrrr r!r"r#r$collections.abcr%pathlibr&#griffe._internal.docstrings.parsersr'r(r)__annotations__typing_extensionsr* ImportErroremptyrr4POSITIONAL_ONLYpositional_onlyPOSITIONAL_OR_KEYWORDpositional_or_keywordVAR_POSITIONALvar_positional KEYWORD_ONLY keyword_only VAR_KEYWORD var_keywordrrrtype_vartype_var_tuple param_specitemsr~rGr0rr)rrLrfs000r7rgs#  3??-%<KPPggH4*    (T4--201O  !04$( 7;15/337;;;. ; " ;  ;5;/;-;1; ;|Y]Y]z&& (E(E,,m.Q.Q%%}'C'C##]%?%?""M$=$=  N!N N  N  N.]aL6%--)88&11 eg    "v!GF5 "    ( ( (  (  (V[_AAc iO t s7H7HH HH