o hU]@sUddlmZddlZddlZddlZddlZddlmZddlm Z m Z ddlm Z ddl m Z ddlmZmZmZddlmZmZdd lmZdd lmZerddlZdd lmZdd lmZdd lmZddl m!Z!ddl"m#Z#ddl$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+Gddde,Z-Gddde-dZ.ee/e0e/efe.e,e.fZ1 GdddZ2dhZ3de4d< d*dd Z5d+d$d%Z6d,d(d)Z7dS)-) 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 TypeAliascs"eZdZdZd fd d ZZS) _ExtensionMetaclassz Metaclass for Griffe extensions.namestrbasestuple[type, ...]attrsdict[str, Any]returncsd|vr tjdtddd|vr,t|dj}d|vs d|vr,d|d <tjd td dd |vr8tjd tddt||||S)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__)clsrrr r1 __class__a/var/www/html/openai_agents/venv/lib/python3.10/site-packages/griffe/_internal/extensions/base.pyr3#s,z_ExtensionMetaclass.__new__)rrrrr r!r"r)__name__ __module__ __qualname____doc__r3 __classcell__r7r7r5r8r src@s(eZdZdZdVddZdVdd ZdWd d ZdWd dZdXddZdYddZ dZddZ dYddZ dXd d!Z d[d$d%Z d\d&d'Zd[d(d)ZdXd*d+Zd]d.d/Zd^d0d1Zd]d2d3ZdXd4d5Zd_d8d9Zd`d:d;ZdXdIz!Extension.visit..N)getattrr selfr'r7r7r8visitCs"zExtension.visitcCst|D]}||qdS)zhVisit children nodes. Parameters: node: The node to visit the children of. N)r rKrJr'childr7r7r8 generic_visitKs  zExtension.generic_visitrcCs t|d|jdd|dS)zTInspect a node. Parameters: node: The node to inspect. inspect_cSrBrCr7rDr7r7r8rFZrGz#Extension.inspect..N)rHkindrIr7r7r8r/Ts zExtension.inspectcCs |jD] }|js ||qdS)zxExtend the base generic inspection with extensions. Parameters: node: The node to inspect. N)childrenalias_target_pathr/rLr7r7r8generic_inspect\s  zExtension.generic_inspectast.AST | ObjectNoder(Visitor | Inspectorkwargsr cKdS)zRun when visiting a new node during static/dynamic analysis. Parameters: node: The currently visited node. Nr7rJr'r(rVr7r7r8on_nodefrGzExtension.on_nodeobjrcKrW)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. Nr7rJr'rZr(rVr7r7r8 on_instancemrGzExtension.on_instanceloaderrcKrW)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. Nr7)rJrZr]rVr7r7r8 on_objectrGzExtension.on_objectcKrW)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. Nr7r[r7r7r8 on_membersrGzExtension.on_memberscKrW)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. Nr7rXr7r7r8on_module_noderGzExtension.on_module_nodemodrcKrW)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. Nr7rJr'rar(rVr7r7r8on_module_instancerGzExtension.on_module_instancecKrW)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. Nr7)rJrar]rVr7r7r8 on_modulerGzExtension.on_modulecKrW)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. Nr7rbr7r7r8on_module_membersrGzExtension.on_module_memberscKrW)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. Nr7rXr7r7r8 on_class_noderGzExtension.on_class_noder4rcKrW)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. Nr7rJr'r4r(rVr7r7r8on_class_instancerGzExtension.on_class_instancecKrW)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. Nr7)rJr4r]rVr7r7r8on_classrGzExtension.on_classcKrW)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. Nr7rgr7r7r8on_class_members rGzExtension.on_class_memberscKrW)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. Nr7rXr7r7r8on_function_node#rGzExtension.on_function_nodefuncrcKrW)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. Nr7)rJr'rlr(rVr7r7r8on_function_instance,rGzExtension.on_function_instancecKrW)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. Nr7)rJrlr]rVr7r7r8 on_functionBrGzExtension.on_functioncKrW)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. Nr7rXr7r7r8on_attribute_nodeOrGzExtension.on_attribute_nodeattrrcKrW)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. Nr7)rJr'rpr(rVr7r7r8on_attribute_instanceXrGzExtension.on_attribute_instancecKrW)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. Nr7)rJrpr]rVr7r7r8 on_attributenrGzExtension.on_attributecKrW)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. Nr7rXr7r7r8on_type_alias_node{rGzExtension.on_type_alias_node type_aliasrcKrW)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. Nr7)rJr'rtr(rVr7r7r8on_type_alias_instancerGz Extension.on_type_alias_instancecKrW)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. Nr7)rJrtr]rVr7r7r8 on_type_aliasrGzExtension.on_type_aliasaliasrcKs,t|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. r)F)r'rwr(Nr7)rHr&)rJr'rwr(rVr7r7r8on_alias_instances zExtension.on_alias_instancecKrW)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. Nr7)rJrwr]rVr7r7r8r&rGzExtension.on_aliaspkgcKs(t|dr|jd||d|dSdS)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. r#)ryr]Nr7)hasattrr#)rJryr]rVr7r7r8 on_packages zExtension.on_packageN)r'r?r"r@)r'rr"r@)r'rTr(rUrVr r"r@) r'rTrZrr(rUrVr r"r@)rZrr]rrVr r"r@) r'rTrarr(rUrVr r"r@)rarr]rrVr r"r@) r'rTr4rr(rUrVr r"r@)r4rr]rrVr r"r@) r'rTrlrr(rUrVr r"r@)rlrr]rrVr r"r@) r'rTrprr(rUrVr r"r@)rprr]rrVr r"r@) r'rTrtrr(rUrVr r"r@)rtrr]rrVr r"r@) r'rTrwrr(rUrVr r"r@)rwrr]rrVr r"r@)ryrr]rrVr r"r@) r9r:r;r<rKrNr/rSrYr\r^r_r`rcrdrerfrhrirjrkrmrnrorqrrrsrurvrxr&r{r7r7r7r8r>@s<               r>) metaclassc@s8eZdZdZdddZddd Zdd d ZdddZdS) ExtensionszLThis class helps iterating on extensions that should run at different times. extensionsr>r"r@cGsg|_|j|dS)zrInitialize the extensions container. Parameters: *extensions: The extensions to add. N) _extensionsadd)rJr~r7r7r8__init__szExtensions.__init__cGs|D]}|j|qdS)zoAdd extensions to this container. Parameters: *extensions: The extensions to add. N)rappend)rJr~ extensionr7r7r8rszExtensions.addrVr cKrW)z!No-op method for extension hooks.Nr7)rJrVr7r7r8_nooprGzExtensions._noopeventrc Ksz|jD]7}|dkr.t|ddr.ttt||di|Wdn1s(wYqt|||jdi|qdS)zCall the extension hook for the given event. Parameters: event: The triggered event. **kwargs: Arguments passed to the hook. r&r)FNr7)rrHr TypeErrorr)rJrrVrr7r7r8calls  zExtensions.callN)r~r>r"r@)rVr r"r@)rrrVr r"r@)r9r:r;r<rrrrr7r7r7r8r}s   r} dataclasseszset[str]builtin_extensionspathrr"rcCsXtj|ddd}t||}|std|dt|}|tj|<|j ||S)N.r*rz#Could not import module from path '') osrbasenamersplitrr rsysmodulesr] exec_module)r module_namespecmoduler7r7r8_load_extension_paths   rr2str | dict[str, Any] | Extension | type[Extension]Extension | list[Extension]c sd}t|tr |St|rt|tr|St|tr)tt|\}t|}nt|}i| d}|dksA|rJdt |j vrJ| dd\}}nd}|t vrVd|}n"tj|rxzt|}Wntyw}z td|d|d}~ww|szt|}Wn+ty}z td|d|d}~wty}z td|d||d}~wwt|rt|tr|diS|rz t||diWSty}z td|d |d |d}~wwd d t|D}fd d |DS)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 ' attributecSs*g|]}t|rt|tr|tur|qSr7)r issubclassr>).0rZr7r7r8 os z#_load_extension..csg|] }|diqS)r7r7)rextoptionsr7r8rrsr7) isinstancer>rrdictnextiteritemsrcountrdriverrrrexistsr ImportErrorr rModuleNotFoundErrorrHAttributeErrorvarsvalues)r ext_object import_pathcolonsextension_nameerrorr~r7rr8_load_extensionsd         rextsLoadableExtensionTypecGstt}|D]}t|}t|tr|j|q||qddlm}|jD] }t||ur0|Sq%|jtd|S)zLoad configured extensions. Parameters: exts: Extensions with potential configuration options. Returns: An extensions container. r)DataclassesExtensionr) r}rrlistr'griffe._internal.extensions.dataclassesrrtype)rr~rrrr7r7r8load_extensionsus       r)rrr"r)rrr"r)rrr"r})8 __future__rr/rrr, contextlibrimportlib.utilrrrpathlibrtypingrr r !griffe._internal.agents.nodes.astr r griffe._internal.exceptionsr griffe._internal.importerrasttypesr!griffe._internal.agents.inspectorr%griffe._internal.agents.nodes.runtimergriffe._internal.agents.visitorrgriffe._internal.loaderrgriffe._internal.modelsrrrrrrrrrr>rrrr}r__annotations__rrrr7r7r7r8sF          $  )   [