o hD@sddlmZddlZddlmZddlmZmZmZddl m Z ddl m Z m Z mZddlmZerJddlmZdd lmZmZmZmZmZmZmZed ZdddZGdddZGdddZGdddZGdddZ Gdddeeee Z!dS)) annotationsN)suppress) TYPE_CHECKINGAnyTypeVar)Kind)AliasResolutionErrorBuiltinModuleErrorCyclicAliasError) merge_stubs)Sequence)Alias AttributeClassFunctionModuleObject TypeAlias_ObjTypekeystr | Sequence[str]return Sequence[str]cCs:t|tr|s td|d}nt|}|std|S)NzEmpty strings are not supported.zEmpty tuples are not supported) isinstancestr ValueErrorsplitlist)rpartsr X/var/www/html/openai_agents/venv/lib/python3.10/site-packages/griffe/_internal/mixins.py _get_partss  r"c@$eZdZdZd ddZd dd Zd S) GetMembersMixinz3Mixin class to share methods for accessing members.rrrrcCs<t|}t|dkr|j|dS|j|d|ddS)aGet a member with its name or path. This method is part of the consumer API: do not use when producing Griffe trees! Members will be looked up in both declared members and inherited ones, triggering computation of the latter. Parameters: key: The name or path of the member. Examples: >>> foo = griffe_object["foo"] >>> bar = griffe_object["path.to.bar"] >>> qux = griffe_object[("path", "to", "qux")] rN)r"len all_membersselfrrr r r! __getitem__%s zGetMembersMixin.__getitem__cCs>t|}t|dkr|j|dS|j|d|ddS)aGet a member with its name or path. This method is part of the producer API: you can use it safely while building Griffe trees (for example in Griffe extensions). Members will be looked up in declared members only, not inherited ones. Parameters: key: The name or path of the member. Examples: >>> foo = griffe_object["foo"] >>> bar = griffe_object["path.to.bar"] >>> bar = griffe_object[("path", "to", "bar")] r%rN)r"r&members get_memberr(r r r!r,;s zGetMembersMixin.get_memberN)rrrr)__name__ __module__ __qualname____doc__r*r,r r r r!r$"s r$c@r#) DelMembersMixinz2Mixin class to share methods for deleting members.rrrNonecCsdt|}t|dkr$|d}z|j|=WdSty#|j|=YdSw|j|d|dd=dS)aDelete a member with its name or path. This method is part of the consumer API: do not use when producing Griffe trees! Members will be looked up in both declared members and inherited ones, triggering computation of the latter. Parameters: key: The name or path of the member. Examples: >>> del griffe_object["foo"] >>> del griffe_object["path.to.bar"] >>> del griffe_object[("path", "to", "qux")] r%rN)r"r&r+KeyErrorinherited_membersr'r)rrnamer r r! __delitem__Ws  zDelMembersMixin.__delitem__cCsHt|}t|dkr|d}|j|=dS|j|d|dddS)aDelete a member with its name or path. This method is part of the producer API: you can use it safely while building Griffe trees (for example in Griffe extensions). Members will be looked up in declared members only, not inherited ones. Parameters: key: The name or path of the member. Examples: >>> griffe_object.del_member("foo") >>> griffe_object.del_member("path.to.bar") >>> griffe_object.del_member(("path", "to", "qux")) r%rN)r"r&r+ del_memberr5r r r!r8rs    zDelMembersMixin.del_memberN)rrrr2)r-r.r/r0r7r8r r r r!r1Ts r1c@s$eZdZdZd dd Zd d d Zd S)SetMembersMixinz1Mixin class to share methods for setting members.rrvalueObject | Aliasrr2cCs^t|}t|dkr |d}||j|<|jr||_dS||_dS||j|d|dd<dS)aSet a member with its name or path. This method is part of the consumer API: do not use when producing Griffe trees! Parameters: key: The name or path of the member. value: The member. Examples: >>> griffe_object["foo"] = foo >>> griffe_object["path.to.bar"] = bar >>> griffe_object[("path", "to", "qux")] = qux r%rN)r"r&r+ is_collection_modules_collectionparent)r)rr:rr6r r r! __setitem__s    zSetMembersMixin.__setitem__c Cs<t|}t|dkr|d}||jvr{|j|}|js{|jr\|js\|js\ttt t *|jrM|j |j krMtt  t ||}Wdn1sHwYWdn1sWwY|jD]}tt  ||_Wdn1suwYqa||j|<|jr||_dS||_dS|j|d|dd|dS)aSet a member with its name or path. This method is part of the producer API: you can use it safely while building Griffe trees (for example in Griffe extensions). Parameters: key: The name or path of the member. value: The member. Examples: >>> griffe_object.set_member("foo", foo) >>> griffe_object.set_member("path.to.bar", bar) >>> griffe_object.set_member(("path", "to", "qux"), qux) r%rN)r"r&r+is_alias is_moduleis_namespace_packageis_namespace_subpackagerrr r filepathrr aliasesvaluestargetr<r=r> set_member)r)rr:rr6memberaliasr r r!rHs0         "zSetMembersMixin.set_memberN)rrr:r;rr2)r-r.r/r0r?rHr r r r!r9s r9c@s.eZdZdZdddd d ZedddZdS)SerializationMixinz8Mixin class to share methods for de/serializing objects.F)fullrLboolkwargsrrrcKs$ddlm}tj|f||d|S)aReturn this object's data as a JSON string. Parameters: full: Whether to return full info, or just base info. **kwargs: Additional serialization options passed to encoder. Returns: A JSON string. r) JSONEncoder)clsrL)griffe._internal.encodersrOjsondumps)r)rLrNrOr r r!as_jsons zSerializationMixin.as_jsonrPtype[_ObjType] json_stringrcKsFddlm}|d|tj|fi|}t||s!td||S)aCreate an instance of this class from a JSON string. Parameters: json_string: JSON to decode into Object. **kwargs: Additional options passed to decoder. Returns: An Object instance. Raises: TypeError: When the json_string does not represent and object of the class from which this classmethod has been called. r) json_decoder object_hookz$provided JSON object is not of type )rQrW setdefaultrRloadsr TypeError)rPrVrNrWobjr r r! from_jsons   zSerializationMixin.from_jsonN)rLrMrNrrr)rPrUrVrrNrrr)r-r.r/r0rT classmethodr]r r r r!rKs rKc@seZdZdZed)ddZed*ddZed+d d Zed,d dZed-ddZ ed.ddZ ed/ddZ ed/ddZ ed/ddZ ed/ddZed/ddZed/d d!Zed/d"d#Zed/d$d%Zed/d&d'Zd(S)0ObjectAliasMixinzPMixin class to share methods that appear both in objects and aliases, unchanged.rdict[str, Object | Alias]cCs|jr i|j|jS|jS)zAll members (declared and inherited). This method is part of the consumer API: do not use when producing Griffe trees! )is_classr4r+r)r r r!r'szObjectAliasMixin.all_membersdict[str, Module]cCdd|jDS)z~The module members. This method is part of the consumer API: do not use when producing Griffe trees! cS"i|] \}}|jtjur||qSr )kindrMODULE.0r6rIr r r! "z,ObjectAliasMixin.modules..r'itemsrbr r r!modules zObjectAliasMixin.modulesdict[str, Class]cCrd)z}The class members. This method is part of the consumer API: do not use when producing Griffe trees! cSrer )rfrCLASSrhr r r!rjrkz,ObjectAliasMixin.classes..rlrbr r r!classesrozObjectAliasMixin.classesdict[str, Function]cCrd)zThe function members. This method is part of the consumer API: do not use when producing Griffe trees! cSrer )rfrFUNCTIONrhr r r!rj$rkz.ObjectAliasMixin.functions..rlrbr r r! functionsrozObjectAliasMixin.functionsdict[str, Attribute]cCrd)zThe attribute members. This method is part of the consumer API: do not use when producing Griffe trees! cSrer )rfr ATTRIBUTErhr r r!rj-rkz/ObjectAliasMixin.attributes..rlrbr r r! attributes&rozObjectAliasMixin.attributesdict[str, TypeAlias]cCrd)zThe type alias members. This method is part of the consumer API: do not use when producing Griffe trees! cSrer )rfr TYPE_ALIASrhr r r!rj6rkz1ObjectAliasMixin.type_aliases..rlrbr r r! type_aliases/rozObjectAliasMixin.type_aliasesrMcCs|jdo |j S)zGWhether this object/alias is private (starts with `_`) but not special._)r6 startswith is_specialrbr r r! is_private8szObjectAliasMixin.is_privatecCs|jdo |jdS)z[Whether this object/alias is special ("dunder" attribute/method, starts and end with `__`).__)r6r}endswithrbr r r!r~=zObjectAliasMixin.is_specialcCs,t|jo|jjo|jdo|jd S)zTWhether this object/alias is class-private (starts with `__` and is a class member).r)rMr>rar6r}rrbr r r!is_class_privateBs*z!ObjectAliasMixin.is_class_privatecCst|jo |j|jjvS)z;Whether this object/alias was imported from another module.)rMr>r6importsrbr r r! is_importedIrzObjectAliasMixin.is_importedcCs,t|jo|jjot|jjo|j|jjvS)zrAexportsr6rbr r r! is_exportedNs zObjectAliasMixin.is_exportedcCsZ|jr t|jr |jjsdS|jjdur|j|jjvS|jdr#dS|jp,|j p,|jS)aWhether this object/alias is exposed to wildcard imports. To be exposed to wildcard imports, an object/alias must: - be available at runtime - have a module as parent - be listed in `__all__` if `__all__` is defined - or not be private (having a name starting with an underscore) Special case for Griffe trees: a submodule is only exposed if its parent imports it. Returns: True or False. FNr|) runtimerMr>rArr6r}r@rrbr r r!is_wildcard_exposedWs  z$ObjectAliasMixin.is_wildcard_exposedcCsl|jdur|jS|js|jr|jdsdS|jr*|jjr*t|jjr*|j|jjvS|jr/dS|j r4dSdS)aWhether this object is considered public. In modules, developers can mark objects as public thanks to the `__all__` variable. In classes however, there is no convention or standard to do so. Therefore, to decide whether an object is public, we follow this algorithm: - If the object's `public` attribute is set (boolean), return its value. - If the object is listed in its parent's (a module) `__all__` attribute, it is public. - If the parent (module) defines `__all__` and the object is not listed in, it is private. - If the object has a private name, it is private. - If the object was imported from another module, it is private. - Otherwise, the object is public. Nr|TF) publicr@rAr6r}r>rMrrrrbr r r! is_publicws zObjectAliasMixin.is_publiccC t|jS)z"Whether this object is deprecated.)rM deprecatedrbr r r! is_deprecateds zObjectAliasMixin.is_deprecatedcCr)zWhether this object is generic.)rMtype_parametersrbr r r! is_generics zObjectAliasMixin.is_genericN)rr`)rrc)rrp)rrs)rrv)rry)rrM)r-r.r/r0propertyr'rnrrrurxr{rr~rrrrrrrr r r r!r_s@             , r_)rrrr)" __future__rrR contextlibrtypingrrrgriffe._internal.enumerationsrgriffe._internal.exceptionsrr r griffe._internal.mergerr collections.abcr griffe._internal.modelsr rrrrrrrr"r$r1r9rKr_r r r r!s"     $  27I)