im]%SSKJr SSKrSSKrSSKrSSKrSSKJr SSKJ r J r SSKJ r SSK J r SSKJrJrJr SSKJrJr SS KJr SS KJr \(a4SSKrSS KJr SS KJr SS KJr SSK J!r! SSK"J#r# SSK$J%r%J&r&J'r'J(r(J)r)J*r*J+r+ "SS\,5r-"SS\-S9r.\\/\0\/\4\.\,\.4r1"SS5r2SS1r3S\4S'SSjr5S Sjr6S!Sjr7g)") annotationsN)suppress)module_from_specspec_from_file_location)isclass)Path) TYPE_CHECKINGAnyUnion) ast_childrenast_kind)ExtensionNotLoadedError)dynamic_import) ModuleType) Inspector) ObjectNode)Visitor) GriffeLoader)Alias AttributeClassFunctionModuleObject TypeAliasc0^\rSrSrSrSU4SjjrSrU=r$)_ExtensionMetaclass z Metaclass for Griffe extensions.cL>SU;a[R"S[SS9 SU;aN[R"US5R nSU;dSU;aSUS '[R"S [S S9 S U;a[R"S [SS9 [ TU]XX#5$)Non_package_loadedzHThe `on_package_loaded` event is deprecated and renamed to `on_package`.) stacklevelon_aliasnodeagentT__old_on_aliaszThe `on_alias` event is now a load event and receives the `alias` and `loader` parameters. It doesn't receive the `node` or `agent` parameters anymore. Please use the new `on_alias` signature, or rename your hook to `on_alias_instance`.on_wildcard_expansionzThe `on_wildcard_expansion` event is deprecated. Instead, hook onto the `on_alias` event and check for aliases' `wildcard_imported` boolean attribute.)warningswarnDeprecationWarninginspect signature parameterssuper__new__)clsnamebasesattrsr. __class__s Z/home/james-whalen/.local/lib/python3.13/site-packages/griffe/_internal/extensions/base.pyr0_ExtensionMetaclass.__new__#s % ' MMZ"    **5+<=HHJ#w*'<*.&' k'  #e + MMP#  ws%77)r2strr3ztuple[type, ...]r4zdict[str, Any]returnr)__name__ __module__ __qualname____firstlineno____doc__r0__static_attributes__ __classcell__)r5s@r6rr s*88r8rc\rSrSrSrS!SjrS!SjrS"SjrS"SjrS#Sjr S$Sjr S%S jr S$S jr S#S jr S&S jrS'S jrS&SjrS#SjrS(SjrS)SjrS(SjrS#SjrS*SjrS+SjrS#SjrS,SjrS-SjrS#SjrS.SjrS/SjrS0SjrS1SjrS2Sjr Sr!g )3 Extension@z!Base class for Griffe extensions.cD[US[U53S5"U5 g)z8Visit a node. Parameters: node: The node to visit. visit_cgNr9_s r6!Extension.visit..Is4r8N)getattrr selfr$s r6visitExtension.visitCs! x~./@Fr8cJ[U5HnURU5 M g)zPVisit children nodes. Parameters: node: The node to visit the children of. N)r rQrPr$childs r6 generic_visitExtension.generic_visitKs "$'E JJu (r8cF[USUR3S5"U5 g)z.Zsr8N)rNkindrOs r6r,Extension.inspectTs  ,n=dCr8crURH'nUR(aMURU5 M) g)z`Extend the base generic inspection with extensions. Parameters: node: The node to inspect. N)childrenalias_target_pathr,rTs r6generic_inspectExtension.generic_inspect\s* ]]E*** U##r8c g)zpRun when visiting a new node during static/dynamic analysis. Parameters: node: The currently visited node. Nr9rPr$r%kwargss r6on_nodeExtension.on_nodefr8c g)aRun when an Object has been created. Warning: This method runs while the object tree is still being constructed: data might be incomplete (class inheritance, alias resolution, etc.). Only hook onto this event if you know what you're doing. Parameters: node: The currently visited node. obj: The object instance. agent: The analysis agent currently running. **kwargs: For forward-compatibility. Nr9rPr$objr%res r6 on_instanceExtension.on_instancemrhr8c g)a_Run on objects (every kind) once the object tree has been fully constructed. Note: This method runs once the object tree has been fully constructed: data is therefore complete and you can safely hook onto this event. Parameters: obj: The object instance. loader: The loader currently in use. **kwargs: For forward-compatibility. Nr9)rPrkloaderres r6 on_objectExtension.on_objectrhr8c g)aRun when members of an Object have been loaded. Warning: This method runs while the object tree is still being constructed: data might be incomplete (class inheritance, alias resolution, etc.). Only hook onto this event if you know what you're doing. Parameters: node: The currently visited node. obj: The object instance. agent: The analysis agent currently running. **kwargs: For forward-compatibility. Nr9rjs r6 on_membersExtension.on_membersrhr8c g)zRun when visiting a new module node during static/dynamic analysis. Parameters: node: The currently visited node. agent: The analysis agent currently running. **kwargs: For forward-compatibility. Nr9rds r6on_module_nodeExtension.on_module_noderhr8c g)aRun when a Module has been created. Warning: This method runs while the object tree is still being constructed: data might be incomplete (class inheritance, alias resolution, etc.). Only hook onto this event if you know what you're doing. Parameters: node: The currently visited node. mod: The module instance. agent: The analysis agent currently running. **kwargs: For forward-compatibility. Nr9rPr$modr%res r6on_module_instanceExtension.on_module_instancerhr8c g)aRRun on modules once the object tree has been fully constructed. Note: This method runs once the object tree has been fully constructed: data is therefore complete and you can safely hook onto this event. Parameters: mod: The module instance. loader: The loader currently in use. **kwargs: For forward-compatibility. Nr9)rPrzrores r6 on_moduleExtension.on_modulerhr8c g)aRun when members of a Module have been loaded. Warning: This method runs while the object tree is still being constructed: data might be incomplete (class inheritance, alias resolution, etc.). Only hook onto this event if you know what you're doing. Parameters: node: The currently visited node. mod: The module instance. agent: The analysis agent currently running. **kwargs: For forward-compatibility. Nr9rys r6on_module_membersExtension.on_module_membersrhr8c g)zRun when visiting a new class node during static/dynamic analysis. Parameters: node: The currently visited node. agent: The analysis agent currently running. **kwargs: For forward-compatibility. Nr9rds r6 on_class_nodeExtension.on_class_noderhr8c g)aRun when a Class has been created. Warning: This method runs while the object tree is still being constructed: data might be incomplete (class inheritance, alias resolution, etc.). Only hook onto this event if you know what you're doing. Parameters: node: The currently visited node. cls: The class instance. agent: The analysis agent currently running. **kwargs: For forward-compatibility. Nr9rPr$r1r%res r6on_class_instanceExtension.on_class_instancerhr8c g)aQRun on classes once the object tree has been fully constructed. Note: This method runs once the object tree has been fully constructed: data is therefore complete and you can safely hook onto this event. Parameters: cls: The class instance. loader: The loader currently in use. **kwargs: For forward-compatibility. Nr9)rPr1rores r6on_classExtension.on_classrhr8c g)aRun when members of a Class have been loaded. Warning: This method runs while the object tree is still being constructed: data might be incomplete (class inheritance, alias resolution, etc.). Only hook onto this event if you know what you're doing. Parameters: node: The currently visited node. cls: The class instance. agent: The analysis agent currently running. **kwargs: For forward-compatibility. Nr9rs r6on_class_membersExtension.on_class_members rhr8c g)zRun when visiting a new function node during static/dynamic analysis. Parameters: node: The currently visited node. agent: The analysis agent currently running. **kwargs: For forward-compatibility. Nr9rds r6on_function_nodeExtension.on_function_node#rhr8c g)aRun when a Function has been created. Warning: This method runs while the object tree is still being constructed: data might be incomplete (class inheritance, alias resolution, etc.). Only hook onto this event if you know what you're doing. Parameters: node: The currently visited node. func: The function instance. agent: The analysis agent currently running. **kwargs: For forward-compatibility. Nr9)rPr$funcr%res r6on_function_instanceExtension.on_function_instance,rhr8c g)aWRun on functions once the object tree has been fully constructed. Note: This method runs once the object tree has been fully constructed: data is therefore complete and you can safely hook onto this event. Parameters: func: The function instance. loader: The loader currently in use. **kwargs: For forward-compatibility. Nr9)rPrrores r6 on_functionExtension.on_functionBrhr8c g)zRun when visiting a new attribute node during static/dynamic analysis. Parameters: node: The currently visited node. agent: The analysis agent currently running. **kwargs: For forward-compatibility. Nr9rds r6on_attribute_nodeExtension.on_attribute_nodeOrhr8c g)aRun when an Attribute has been created. Warning: This method runs while the object tree is still being constructed: data might be incomplete (class inheritance, alias resolution, etc.). Only hook onto this event if you know what you're doing. Parameters: node: The currently visited node. attr: The attribute instance. agent: The analysis agent currently running. **kwargs: For forward-compatibility. Nr9)rPr$attrr%res r6on_attribute_instanceExtension.on_attribute_instanceXrhr8c g)aYRun on attributes once the object tree has been fully constructed. Note: This method runs once the object tree has been fully constructed: data is therefore complete and you can safely hook onto this event. Parameters: attr: The attribute instance. loader: The loader currently in use. **kwargs: For forward-compatibility. Nr9)rPrrores r6 on_attributeExtension.on_attributenrhr8c g)zRun when visiting a new type alias node during static/dynamic analysis. Parameters: node: The currently visited node. agent: The analysis agent currently running. **kwargs: For forward-compatibility. Nr9rds r6on_type_alias_nodeExtension.on_type_alias_node{rhr8c g)aRun when a TypeAlias has been created. Warning: This method runs while the object tree is still being constructed: data might be incomplete (class inheritance, alias resolution, etc.). Only hook onto this event if you know what you're doing. Parameters: node: The currently visited node. type_alias: The type alias instance. agent: The analysis agent currently running. **kwargs: For forward-compatibility. Nr9)rPr$ type_aliasr%res r6on_type_alias_instance Extension.on_type_alias_instancerhr8c g)abRun on type aliases once the object tree has been fully constructed. Note: This method runs once the object tree has been fully constructed: data is therefore complete and you can safely hook onto this event. Parameters: type_alias: The type alias instance. loader: The loader currently in use. **kwargs: For forward-compatibility. Nr9)rPrrores r6 on_type_aliasExtension.on_type_aliasrhr8c T[USS5(aUR"SXUS.UD6 gg)aRun when an Alias has been created. Warning: This method runs while the object tree is still being constructed: data might be incomplete (class inheritance, alias resolution, etc.). Only hook onto this event if you know what you're doing. Parameters: node: The currently visited node. alias: The alias instance. agent: The analysis agent currently running. **kwargs: For forward-compatibility. r&F)r$aliasr%Nr9)rNr#)rPr$rr%res r6on_alias_instanceExtension.on_alias_instances/* 4)5 1 1 MM Ht H H 2r8c g)aSRun on aliases once the object tree has been fully constructed. Note: This method runs once the object tree has been fully constructed: data is therefore complete and you can safely hook onto this event. Parameters: alias: The alias instance. loader: The loader currently in use. **kwargs: For forward-compatibility. Nr9)rPrrores r6r#Extension.on_aliasrhr8c P[US5(aUR"SXS.UD6 gg)aKRun when a package has been completely loaded. Note: This method runs once the object tree has been fully constructed: data is therefore complete and you can safely hook onto this event. Parameters: pkg: The package (Module) instance. loader: The loader currently in use. **kwargs: For forward-compatibility. r )pkgroNr9)hasattrr )rPrrores r6 on_packageExtension.on_packages- 4, - -  " " Ds DV D .r8r9N)r$zast.ASTr;None)r$rr;r)r$ast.AST | ObjectNoder%Visitor | Inspectorrer r;r) r$rrkrr%rrer r;r)rkrrorrer r;r) r$rrzrr%rrer r;r)rzrrorrer r;r) r$rr1rr%rrer r;r)r1rrorrer r;r) r$rrrr%rrer r;r)rrrorrer r;r) r$rrrr%rrer r;r)rrrorrer r;r) r$rrrr%rrer r;r)rrrorrer r;r) r$rrrr%rrer r;r)rrrorrer r;r)rrrorrer r;r)"r<r=r>r?r@rQrVr,rarfrlrprsrvr{r~rrrrrrrrrrrrrrrr#rrAr9r8r6rDrD@s\+GD$  #   #      ,      #   #      ,   #   #      ,  #   #      ,   #   #      ,  #   #      ,    #   #      ,    #   #      ,  I#I I # I  I I0  Er8rD) metaclassc@\rSrSrSrS SjrS SjrS SjrS SjrSr g) ExtensionsizLThis class helps iterating on extensions that should run at different times.c0/UlUR"U6 g)zZInitialize the extensions container. Parameters: *extensions: The extensions to add. N) _extensionsadd)rP extensionss r6__init__Extensions.__init__s -/ *r8cLUHnURRU5 M g)zWAdd extensions to this container. Parameters: *extensions: The extensions to add. N)rappend)rPr extensions r6rExtensions.adds" $I    # #I .$r8c g)z!No-op method for extension hooks.Nr9)rPres r6_noopExtensions._nooprhr8c  URHbnUS:Xa=[USS5(a+[[5 [X15"S0UD6 SSS5 MF[X1UR5"S0UD6 Md g!,(df  Mv=f)zCall the extension hook for the given event. Parameters: event: The triggered event. **kwargs: Arguments passed to the hook. r#r&FNr9)rrNr TypeErrorr)rPeventrers r6callExtensions.callsl))I "wy:JE'R'Ri(I-77)( $**5?? *)(s A44 B )rN)rrDr;r)rer r;r)rr:rer r;r) r<r=r>r?r@rrrrrAr9r8r6rrsV/0 @r8r dataclassesunpack_typeddictzset[str]builtin_extensionsc[RRU5RSS5Sn[ X5nU(d[ SUS35e[ U5nU[RU'URRU5 U$)N.r'rz#Could not import module from path '') ospathbasenamersplitrrrsysmodulesro exec_module)r module_namespecmodules r6_load_extension_pathrsz''""4(//Q7:K "; 5D %(KD6QR&STT d #F%CKK KKF# Mr8c Sn[U[5(aU$[U5(a[U[5(aU"5$[U[5(a0[ [ UR555up#[U5nO [U5n0nURS5nUS:d U(a.S[U5R;aURSS5up%OSnU[;aSU3nO0[RR!U5(a [#U5nU(d [)U5n[U5(a[U[5(aU"S 0UD6$U(a[-X5"S 0UD6$[1U5R35Vs/sH9n[U5(dM[U[5(dM,U[LdM7UPM; nnUV s/sH o"S 0UD6PM sn $![$an['SUS35UeSnAff=f![*an['SUS35UeSnAf[$an['SUSU35UeSnAff=f![.an['SUS US 35UeSnAff=fs snfs sn f) aLoad a configured extension. Parameters: extension: An extension, with potential configuration options. Raises: ExtensionNotLoadedError: When the extension cannot be loaded, either because the module is not found, or because it does not expose the Extension attribute. ImportError will bubble up so users can see the traceback. Returns: An extension instance. N:r'zgriffe._internal.extensions.zExtension module 'z' could not be foundz!Error while importing extension 'z': z ' has no 'z ' attributer9) isinstancerDr issubclassdictnextiteritemsr:countrdriverrrrexistsr ImportErrorrrModuleNotFoundErrorrNAttributeErrorvarsvalues) r ext_object import_pathoptionscolonsextension_nameerrorrkrexts r6_load_extensionrs"J)Y''yjI>>{)T""#D):$;< +& )n   s #F zfD,=,C,C!C&1&8&8a&@# ^((4[MB  $ $ m-k:J  r' 4Jzz*i@@$G$$ :6AA AJ'..00GCLZPSU^E_dgoxdx0'1 1jsCN'Nj 11A m),>{mK_*`agl l m# m),>{mK_*`agl l r),Mk]Z]^c]d*eflq q r )$[MN;K;W   2sr G4. H.II<2I< I<I< J4 H>HH I H00 I=II I9!I44I9c4[5nUHEn[U5n[U[5(aUR"U6 M4UR U5 MG SSKJn URHn[U5ULdM U$ UR"[S56 U$)zLoad configured extensions. Parameters: exts: Extensions with potential configuration options. Returns: An extensions container. r)DataclassesExtensionr) rrrlistr'griffe._internal.extensions.dataclassesrrtype)extsrrrrs r6load_extensionsrvsJ i( c4 NNC NN3  M%% 9, ,   &  67 r8)rr:r;r)rz2str | dict[str, Any] | Extension | type[Extension]r;zExtension | list[Extension])rLoadableExtensionTyper;r)8 __future__rr,rrr) contextlibrimportlib.utilrrrpathlibrtypingr r r !griffe._internal.agents.nodes.astr r griffe._internal.exceptionsrgriffe._internal.importerrasttypesr!griffe._internal.agents.inspectorr%griffe._internal.agents.nodes.runtimergriffe._internal.agents.visitorrgriffe._internal.loaderrgriffe._internal.modelsrrrrrrrrrrDr:rrrr__annotations__rrrr9r8r6rs# D,,D?4 ;@74ddd8$8@ZE-ZEz c4S>9d9oMN<%@%@R H/X2AX2 X2vr8