]jU%SSKJr SSKrSSKrSSKJrJr SSKJr SSK J r SSK J r J r SSKJrJr SSKJr SS KJr \ (a4SSKrSS KJr SS KJr SS KJr SS KJr SSKJr SSK J!r!J"r"J#r#J$r$J%r%J&r&J'r' "SS5r(\)\*\)\ 4-\(-\+\(-r,"SS5r-SS1r.S\/S'SSjr0SSjr1SSjr2g)) annotationsN)module_from_specspec_from_file_location)isclass)Path) TYPE_CHECKINGAny) ast_childrenast_kind)ExtensionNotLoadedError)dynamic_import) ModuleType) Inspector) ObjectNode)Visitor) GriffeLoader)Alias AttributeClassFunctionModuleObject TypeAliasc\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 Extensionz!Base class for Griffe extensions.cD[US[U53S5"U5 g)z8Visit a node. Parameters: node: The node to visit. visit_cgN_s ]/home/mande/repo/quber/.venv/lib/python3.13/site-packages/griffe/_internal/extensions/base.py!Extension.visit..%s4N)getattrr selfnodes r$visitExtension.visits! x~./@Fr'cJ[U5HnURU5 M g)zPVisit children nodes. Parameters: node: The node to visit the children of. N)r r,r*r+childs r$ generic_visitExtension.generic_visit's "$'E JJu (r'cF[USUR3S5"U5 g)z.6sr'N)r(kindr)s r$inspectExtension.inspect0s  ,n=dCr'crURH'nUR(aMURU5 M) g)z`Extend the base generic inspection with extensions. Parameters: node: The node to inspect. N)childrenalias_target_pathr8r/s r$generic_inspectExtension.generic_inspect8s* ]]E*** U##r'c g)zpRun when visiting a new node during static/dynamic analysis. Parameters: node: The currently visited node. Nr!r*r+agentkwargss r$on_nodeExtension.on_nodeBr'c 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. Nr!r*r+objrArBs r$ on_instanceExtension.on_instanceIrEr'c 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. Nr!)r*rHloaderrBs r$ on_objectExtension.on_object_rEr'c 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. Nr!rGs r$ on_membersExtension.on_memberslrEr'c 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. Nr!r@s r$on_module_nodeExtension.on_module_node{rEr'c 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. Nr!r*r+modrArBs r$on_module_instanceExtension.on_module_instancerEr'c 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. Nr!)r*rWrLrBs r$ on_moduleExtension.on_modulerEr'c 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. Nr!rVs r$on_module_membersExtension.on_module_membersrEr'c 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. Nr!r@s r$ on_class_nodeExtension.on_class_noderEr'c 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. Nr!r*r+clsrArBs r$on_class_instanceExtension.on_class_instancerEr'c 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. Nr!)r*rerLrBs r$on_classExtension.on_classrEr'c 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. Nr!rds r$on_class_membersExtension.on_class_membersrEr'c 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. Nr!r@s r$on_function_nodeExtension.on_function_noderEr'c 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. Nr!)r*r+funcrArBs r$on_function_instanceExtension.on_function_instancerEr'c 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. Nr!)r*rrrLrBs r$ on_functionExtension.on_functionrEr'c 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. Nr!r@s r$on_attribute_nodeExtension.on_attribute_node+rEr'c 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. Nr!)r*r+attrrArBs r$on_attribute_instanceExtension.on_attribute_instance4rEr'c 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. Nr!)r*r|rLrBs r$ on_attributeExtension.on_attributeJrEr'c 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. Nr!r@s r$on_type_alias_nodeExtension.on_type_alias_nodeWrEr'c 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. Nr!)r*r+ type_aliasrArBs r$on_type_alias_instance Extension.on_type_alias_instance`rEr'c 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. Nr!)r*rrLrBs r$ on_type_aliasExtension.on_type_aliasvrEr'c 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. __old_on_aliasF)r+aliasrANr!)r(on_alias)r*r+rrArBs r$on_alias_instanceExtension.on_alias_instances/* 4)5 1 1 MM Ht H H 2r'c 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. Nr!)r*rrLrBs r$rExtension.on_aliasrEr'c g)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. Nr!)r*pkgrLrBs r$ on_packageExtension.on_packagerEr'r!N)r+zast.ASTreturnNone)r+rrr)r+ast.AST | ObjectNoderAVisitor | InspectorrBr rr) r+rrHrrArrBr rr)rHrrLrrBr rr) r+rrWrrArrBr rr)rWrrLrrBr rr) r+rrerrArrBr rr)rerrLrrBr rr) r+rrrrrArrBr rr)rrrrLrrBr rr) r+rr|rrArrBr rr)r|rrLrrBr rr) r+rrrrArrBr rr)rrrLrrBr rr) r+rrrrArrBr rr)rrrLrrBr rr)rrrLrrBr rr)"__name__ __module__ __qualname____firstlineno____doc__r,r1r8r=rCrIrMrPrSrXr[r^rarfrirlrorsrvryr}rrrrrrr__static_attributes__r!r'r$rrs[+GD$  #   #      ,      #   #      ,   #   #      ,  #   #      ,   #   #      ,  #   #      ,    #   #      ,    #   #      ,  I#I I # I  I I0    r'rc@\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)r* extensionss r$__init__Extensions.__init__s -/ *r'cLUHnURRU5 M g)zWAdd extensions to this container. Parameters: *extensions: The extensions to add. N)rappend)r*r extensions r$rExtensions.adds" $I    # #I .$r'c g)z!No-op method for extension hooks.Nr!)r*rBs r$_noopExtensions._nooprEr'c bURHn[X1UR5"S0UD6 M! g)zCall the extension hook for the given event. Parameters: event: The triggered event. **kwargs: Arguments passed to the hook. Nr!)rr(r)r*eventrBrs r$callExtensions.calls*))I Idjj 1 ;F ;*r')rN)rrrr)rBr rr)rstrrBr rr) rrrrrrrrrrr!r'r$rrsV/0>{)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 r$load_extensionsrJsJ i( c4 NNC NN3  M%% 9, ,   &  67 r')rrrr)rz2str | dict[str, Any] | Extension | type[Extension]rzExtension | list[Extension])rLoadableExtensionTyperr)3 __future__rrrimportlib.utilrrr8rpathlibrtypingrr !griffe._internal.agents.nodes.astr r griffe._internal.exceptionsr griffe._internal.importerr asttypesr!griffe._internal.agents.inspectorr%griffe._internal.agents.nodes.runtimergriffe._internal.agents.visitorrgriffe._internal.loaderrgriffe._internal.modelsrrrrrrrrrrrrrr__annotations__rrrr!r'r$rs# D%D?4 ;@74dddW W t d38n,y84 ?J< <