gsGddlmZddlZddlmZddlmZmZmZddl m Z ddl m Z m Z mZddlmZerddlmZdd lmZmZmZmZmZmZed Zdd ZGd d ZGddZGddZGddZGddeeeeZ y)) annotationsN)suppress) TYPE_CHECKINGAnyTypeVar)Kind)AliasResolutionErrorBuiltinModuleErrorCyclicAliasError) merge_stubs)Sequence)Alias AttributeClassFunctionModuleObject_ObjTypect|tr|s td|jd}n t |}|s td|S)NzEmpty strings are not supported.zEmpty tuples are not supported) isinstancestr ValueErrorsplitlist)keypartss C/var/www/openai/venv/lib/python3.12/site-packages/_griffe/mixins.py _get_partsrsE#s>? ? #S  9:: Lc eZdZdZddZddZy)GetMembersMixinzMixin class to share methods for accessing members. Methods: get_member: Get a member with its name or path. __getitem__: Same as `get_member`, with the item syntax `[]`. ct|}t|dk(r|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)rlen all_membersselfrrs r __getitem__zGetMembersMixin.__getitem__*sM"3 u:?##E!H- -a)%)44r ct|}t|dk(r|j|dS|j|dj|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)rr%members get_memberr's rr,zGetMembersMixin.get_member@sO"3 u:?<<a) )||E!H%00qr;;r N)rstr | Sequence[str]returnr)__name__ __module__ __qualname____doc__r)r,r rr"r""s5,>> del griffe_object["foo"] >>> del griffe_object["path.to.bar"] >>> del griffe_object[("path", "to", "qux")] r$rN)rr%r+KeyErrorinherited_membersr&r(rrnames r __delitem__zDelMembersMixin.__delitem__asp"3 u:?8D 1LL&  q*595 1**40 1s AAAct|}t|dk(r|d}|j|=y|j|dj|ddy)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)rr%r+ del_memberr9s rr=zDelMembersMixin.del_member|sN"3 u:?8D T" LLq " - -eABi 8r N)rr-r.None)r/r0r1r2r;r=r3r rr5r5Ys669r r5c eZdZdZddZddZy)SetMembersMixinzMixin class to share methods for setting members. Methods: set_member: Set a member with its name or path. __setitem__: Same as `set_member`, with the item syntax `[]`. ct|}t|dk(r0|d}||j|<|jr||_y||_y||j|d|dd<y)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)rr%r+ is_collection_modules_collectionparent)r(rvaluerr:s r __setitem__zSetMembersMixin.__setitem__sd3 u:?8D!&DLL !!,0)# 05DLLq "59 -r ct|}t|dk(r&|d}||jvr|j|}|js|jr|j sw|j sktttt5|jr=|j|jk7r$tt5t||}dddddd|jjD]!}tt5||_ddd#||j|<|j"r||_y||_y|j|dj)|dd|y#1swYxYw#1swYxYw#1swYxYw)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)rr%r+is_alias is_moduleis_namespace_packageis_namespace_subpackagerr r r filepathrr aliasesvaluestargetrBrCrD set_member)r(rrErr:memberaliass rrPzSetMembersMixin.set_members< 3 u:?8Dt||#d+''1L1LPVPnPn&&:>V__3T%-j%9,7,FE&:b"(!6!6!8%&67+0EL87"9"'DLL !!,0)# LLq " - -eABi ?&:%9ba 87s05E3; E'E3E?'E0 ,E33E<?F N)rr-rEzObject | Aliasr.r>)r/r0r1r2rFrPr3r rr@r@s64)@r r@c0eZdZdZddddZeddZy) SerializationMixinzMixin class to share methods for de/serializing objects. Methods: as_json: Return this object's data as a JSON string. from_json: Create an instance of this class from a JSON string. F)fullc @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)clsrU)_griffe.encodersrWjsondumps)r(rUkwargsrWs ras_jsonzSerializationMixin.as_jsons" 1zz$EKdEfEEr c ddlm}|jd|tj|fi|}t ||st d||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 )rYr_ setdefaultrZloadsr TypeError)rX json_stringr\r_objs r from_jsonzSerializationMixin.from_jsonsL 2-6jj//#s#B3%HI I r N)rUboolr\rr.r)rXztype[_ObjType]rdrr\rr.r)r/r0r1r2r] classmethodrfr3r rrTrTs&', Fr rTceZdZdZeddZeddZeddZeddZeddZ eddZ eddZ edd Z edd Z edd Zedd Zedd ZeddZy)ObjectAliasMixinaMixin class to share methods that appear both in objects and aliases, unchanged. Attributes: all_members: All members (declared and inherited). modules: The module members. classes: The class members. functions: The function members. attributes: The attribute members. is_private: Whether this object/alias is private (starts with `_`) but not special. is_class_private: Whether this object/alias is class-private (starts with `__` and is a class member). is_special: Whether this object/alias is special ("dunder" attribute/method, starts and end with `__`). is_imported: Whether this object/alias was imported from another module. is_exported: Whether this object/alias is exported (listed in `__all__`). is_wildcard_exposed: Whether this object/alias is exposed to wildcard imports. is_public: Whether this object is considered public. is_deprecated: Whether this object is deprecated. cf|jri|j|jS|jS)zAll members (declared and inherited). This method is part of the consumer API: do not use when producing Griffe trees! )is_classr8r+r(s rr&zObjectAliasMixin.all_members$s/ ===d,,= = =||r c|jjDcic]%\}}|jtjus#||'c}}Scc}}w)z~The module members. This method is part of the consumer API: do not use when producing Griffe trees! )r&itemskindrMODULEr(r:rQs rmoduleszObjectAliasMixin.modules/sG261A1A1G1G1Ih1IvV[[\`\g\gMgf 1Ihhh $A A c|jjDcic]%\}}|jtjus#||'c}}Scc}}w)z}The class members. This method is part of the consumer API: do not use when producing Griffe trees! )r&rorprCLASSrrs rclasseszObjectAliasMixin.classes8sG261A1A1G1G1Ig1IvV[[\`\f\fMff 1Igggrtc|jjDcic]%\}}|jtjus#||'c}}Scc}}w)zThe function members. This method is part of the consumer API: do not use when producing Griffe trees! )r&rorprFUNCTIONrrs r functionszObjectAliasMixin.functionsAsG261A1A1G1G1Ij1IvV[[\`\i\iMif 1Ijjjrtc|jjDcic]%\}}|jtjus#||'c}}Scc}}w)zThe attribute members. This method is part of the consumer API: do not use when producing Griffe trees! )r&rorpr ATTRIBUTErrs r attributeszObjectAliasMixin.attributesJsG261A1A1G1G1Ik1IvV[[\`\j\jMjf 1IkkkrtcV|jjdxr |j S)zGWhether this object/alias is private (starts with `_`) but not special._)r: startswith is_specialrms r is_privatezObjectAliasMixin.is_privateSs%yy##C(@-@@r cr|jjdxr|jjdS)z[Whether this object/alias is special ("dunder" attribute/method, starts and end with `__`).__)r:rendswithrms rrzObjectAliasMixin.is_specialXs-yy##D)Fdii.@.@.FFr c|jxrQ|jjxr9|jjdxr|jj d S)zTWhether this object/alias is class-private (starts with `__` and is a class member).r)rDrlr:rrrms ris_class_privatez!ObjectAliasMixin.is_class_private]sL{{st{{33s 8L8LT8Rs[_[d[d[m[mnr[sWssr cb|jxr"|j|jjvS)z;Whether this object/alias was imported from another module.)rDr:importsrms r is_importedzObjectAliasMixin.is_importedbs&{{?tyyDKK,?,???r c|jjxrCt|jjxr"|j|jjvS)z**X%%r rj)rr-r.z Sequence[str])! __future__rrZ contextlibrtypingrrr_griffe.enumerationsr_griffe.exceptionsr r r _griffe.mergerr collections.abcr _griffe.modelsrrrrrrrrr"r5r@rTrjr3r rrs# ..%YY&(PP :  2<2