%jUUddlmZddlZddlZddlmZmZddlmZddl m Z ddl m Z m Z ddlmZmZddlmZdd lmZe r4ddlZdd lmZdd lmZdd lmZdd lmZddlmZddl m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'GddZ(e)e*e)e fze(ze+e(zZ, GddZ-ddhZ.de/d< d$dZ0d%d Z1d&d#Z2dS)') annotationsN)module_from_specspec_from_file_location)isclass)Path) TYPE_CHECKINGAny) ast_childrenast_kind)ExtensionNotLoadedError)dynamic_import) ModuleType) Inspector) ObjectNode)Visitor) GriffeLoader)Alias AttributeClassFunctionModuleObject TypeAliasceZdZdZd:dZd:dZd;d Zd;d ZddZ d=dZ dz!Extension.visit..%s4N)getattrr selfrs r'visitzExtension.visits8 A/x~~//@@FFFFFr)cTt|D]}||dS)zhVisit children nodes. Parameters: node: The node to visit the children of. N)r r-r,rchilds r' generic_visitzExtension.generic_visit's: "$''  E JJu      r)rcLt|d|jd|dS)zTInspect a node. Parameters: node: The node to inspect. inspect_cdSr#r$r%s r'r(z#Extension.inspect..6sr)N)r*kindr+s r'inspectzExtension.inspect0s3 >,,,nn==dCCCCCr)cR|jD]}|js||dS)zxExtend the base generic inspection with extensions. Parameters: node: The node to inspect. N)childrenalias_target_pathr6r/s r'generic_inspectzExtension.generic_inspect8s= ] $ $E* $ U### $ $r)ast.AST | ObjectNodeagentVisitor | Inspectorkwargsr c dS)zRun when visiting a new node during static/dynamic analysis. Parameters: node: The currently visited node. Nr$r,rr<r>s r'on_nodezExtension.on_nodeBr)objrc dS)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,rrCr<r>s r' on_instancezExtension.on_instanceIrBr)loaderrc dS)aRun 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,rCrGr>s r' on_objectzExtension.on_object_rBr)c dS)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$rEs r' on_memberszExtension.on_memberslrBr)c dS)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_nodezExtension.on_module_node{rBr)modrc dS)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,rrNr<r>s r'on_module_instancezExtension.on_module_instancerBr)c dS)aRun 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,rNrGr>s r' on_modulezExtension.on_modulerBr)c dS)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$rPs r'on_module_memberszExtension.on_module_membersrBr)c dS)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_nodezExtension.on_class_noderBr)clsrc dS)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,rrXr<r>s r'on_class_instancezExtension.on_class_instancerBr)c dS)aRun 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,rXrGr>s r'on_classzExtension.on_classrBr)c dS)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$rZs r'on_class_memberszExtension.on_class_membersrBr)c dS)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_nodezExtension.on_function_noderBr)funcrc dS)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,rrbr<r>s r'on_function_instancezExtension.on_function_instancerBr)c dS)aRun 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,rbrGr>s r' on_functionzExtension.on_functionrBr)c dS)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_nodezExtension.on_attribute_node+rBr)attrrc dS)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,rrir<r>s r'on_attribute_instancezExtension.on_attribute_instance4rBr)c dS)aRun 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,rirGr>s r' on_attributezExtension.on_attributeJrBr)c dS)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_nodezExtension.on_type_alias_nodeWrBr) type_aliasrc dS)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,rrpr<r>s r'on_type_alias_instancez Extension.on_type_alias_instance`rBr)c dS)aRun 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,rprGr>s r' on_type_aliaszExtension.on_type_aliasvrBr)aliasrc Nt|ddr|jd|||d|dSdS)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)rrur<Nr$)r*on_alias)r,rrur<r>s r'on_alias_instancezExtension.on_alias_instancesM* 4)5 1 1 I DM Ht5 H H H H H H H I Ir)c dS)aRun 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,rurGr>s r'rxzExtension.on_aliasrBr)pkgc dS)aRun 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,r{rGr>s r' on_packagezExtension.on_packagerBr)N)rrrr)rrrr)rr;r<r=r>r rr) rr;rCrr<r=r>r rr)rCrrGrr>r rr) rr;rNrr<r=r>r rr)rNrrGrr>r rr) rr;rXrr<r=r>r rr)rXrrGrr>r rr) rr;rbrr<r=r>r rr)rbrrGrr>r rr) rr;rirr<r=r>r rr)rirrGrr>r rr) rr;rprr<r=r>r rr)rprrGrr>r rr) rr;rurr<r=r>r rr)rurrGrr>r rr)r{rrGrr>r rr) __name__ __module__ __qualname____doc__r-r1r6r:rArFrIrKrMrQrSrUrWr[r]r_rardrfrhrkrmrorrrtryrxr}r$r)r'rrsV++GGGGDDDD$$$$        ,                  ,         ,        ,         ,        ,             ,             ,     IIII0            r)rc2eZdZdZddZddZdd Zdd ZdS) ExtensionszLThis class helps iterating on extensions that should run at different times. extensionsrrrc(g|_|j|dS)zrInitialize the extensions container. Parameters: *extensions: The extensions to add. N) _extensionsadd)r,rs r'__init__zExtensions.__init__s! -/*r)cD|D]}|j|dS)zoAdd extensions to this container. Parameters: *extensions: The extensions to add. N)rappend)r,r extensions r'rzExtensions.adds7 $ / /I   # #I . . . . / /r)r>r c dS)z!No-op method for extension hooks.Nr$)r,r>s r'_noopzExtensions._nooprBr)eventstrc R|jD]}t|||jdi|dS)zCall the extension hook for the given event. Parameters: event: The triggered event. **kwargs: Arguments passed to the hook. Nr$)rr*r)r,rr>rs r'callzExtensions.callsG) < r rr)rrr>r rr)r~rrrrrrrr$r)r'rrsjVV////0000<<<<<z#_load_extension..DsLGCLLEOPSU^E_E_dgoxdxdxdxdxdxr)c g|] }|di S)r$r$)rextoptionss r'rz#_load_extension..Gs% 1 1 1sCCNN'NN 1 1 1r)r$) isinstancerrrdictnextiteritemsrcountrdriverrrrexistsr ImportErrorr r ModuleNotFoundErrorr*AttributeErrorvarsvalues)r ext_object import_pathcolonsextension_nameerrorrrs @r'_load_extensionrs+"J)Y''yjI>>y{{)T"" #D):):$;$;<< W+&& )nn   s # #F zzfzD,=,=,C!C!C&1&8&8a&@&@# ^^(((B[BB  $ $m m-k::JJ m m m)*`{*`*`*`aagl l m r r' 44JJ" m m m)*`{*`*`*`aagl l r r r)*ek*e*e^c*e*efflq q rz%z*i@@%z$$G$$$ 67:~66AAAA A   )W[WWNWWW  J''..00J 2 1 1 1j 1 1 11sT.D>> E!EE!'E77 F=F F="F88F=/H H+H&&H+extsLoadableExtensionTypec(t}|D]F}t|}t|tr |j|1||Gddlm}|jD]}t||urn|jtd|S)zLoad configured extensions. Parameters: exts: Extensions with potential configuration options. Returns: An extensions container. r)DataclassesExtensionr) rrrlistr'griffe._internal.extensions.dataclassesrrtype)rrrrrs r'load_extensionsrJsJ  i(( c4  JNC NN3    MLLLLL%88 99, , , E -   6677 r))rrrr)rrrr)rrrr)3 __future__rrrimportlib.utilrrr6rpathlibrtypingrr !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'rsT#"""""" DDDDDDDD%%%%%%%%DDDDDDDD??????444444eJJJ      ;;;;;;@@@@@@777777444444ddddddddddddddddddW W W W W W W W t d38n,y84 ?J< < < < < < < <