%jEBddlmZddlZddlmZddlmZmZmZddl m Z ddl m Z m Z mZddlmZerddlmZdd lmZmZmZmZmZmZmZed ZddZGddZGddZGddZGddZ Gddeeee Z!dS)) annotationsN)suppress) TYPE_CHECKINGAnyTypeVar)Kind)AliasResolutionErrorBuiltinModuleErrorCyclicAliasError) merge_stubs)Sequence)Alias AttributeClassFunctionModuleObject TypeAlias_ObjTypekeystr | Sequence[str]return Sequence[str]ct|tr'|std|d}nt |}|std|S)NzEmpty strings are not supported.zEmpty tuples are not supported) isinstancestr ValueErrorsplitlist)rpartss _/home/rurouni/.hermes/hermes-agent/venv/lib/python3.11/site-packages/griffe/_internal/mixins.py _get_partsr#sd#s @>?? ? #S  ;9::: Lc"eZdZdZd dZd dZdS) GetMembersMixinz3Mixin class to share methods for accessing members.rrrrct|}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_membersselfrr!s r" __getitem__zGetMembersMixin.__getitem__%sO"3 u::??#E!H- -a)%)44r$ct|}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+s r"r0zGetMembersMixin.get_member;sV"3 u::??<a) )|E!H%00qrr;;;r$N)rrrr)__name__ __module__ __qualname____doc__r-r0r$r"r&r&"sB==5555,<<<<<>> del griffe_object["foo"] >>> del griffe_object["path.to.bar"] >>> del griffe_object[("path", "to", "qux")] r(rN)r#r)r/KeyErrorinherited_membersr*r,rr!names r" __delitem__zDelMembersMixin.__delitem__Ws"3 u::??8D 1L&&& 1 1 1*40000 1 q*59555s6A  A ct|}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_memberr<s r"r@zDelMembersMixin.del_memberrsd"3 u::??8D T""" Lq " - -eABBi 8 8 8 8 8r$N)rrrr8)r1r2r3r4r>r@r5r$r"r7r7TsB<<66666999999r$r7c"eZdZdZd dZd d Zd S) SetMembersMixinz1Mixin class to share methods for setting members.rrvalueObject | Aliasrr8ct|}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,rrCr!r=s r" __setitem__zSetMembersMixin.__setitem__sz3 u::??8D!&DL ! $,0)))# 05DLq "59 - - -r$ct|}t|dkr8|d}||jvr|j|}|js|jr|js|jstttt5|jrL|j |j kr>> 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_subpackagerr r r filepathrr aliasesvaluestargetrFrGrH set_member)r,rrCr!r=memberaliass r"rSzSetMembersMixin.set_membersr 3 u::??8Dt|##d+ 1'G1LGPVPnG&&:V_3T3T%-j%9%9!G!G,7,F,FE!G!G!G!G!G!G!G!G!G!G!G!G!G!G!GGGGGGGGGGGGGGGG"(!6!6!8!811%&67711+0EL111111111111111!&DL ! $,0)))# Lq " - -eABBi ? ? ? ? ?sH?,C+C< CC CC CC#&C#D--D1 4D1 N)rrrCrDrr8)r1r2r3r4rIrSr5r$r"rBrBsH;;66664)@)@)@)@)@)@r$rBc8eZdZdZdddd ZeddZdS)SerializationMixinz8Mixin class to share methods for de/serializing objects.F)fullrXboolkwargsrrrc 8ddlm}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)clsrX)griffe._internal.encodersr\jsondumps)r,rXrZr\s r"as_jsonzSerializationMixin.as_jsons5 :99999z$EKdEEfEEEr$r]type[_ObjType] json_stringrc ddlm}|d|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 )r^re setdefaultr_loadsr TypeError)r]rcrZreobjs r" from_jsonzSerializationMixin.from_jsonsr ;:::::-666j////#s## JH3HHII I r$N)rXrYrZrrr)r]rbrcrrZrrr)r1r2r3r4ra classmethodrkr5r$r"rWrWsaBB&+ F F F F F F[r$rWczeZdZdZeddZeddZeddZedd Zedd Z eddZ ed dZ ed dZ ed dZ ed dZed dZed dZed dZed dZed dZdS)!ObjectAliasMixinzPMixin class to share methods that appear both in objects and aliases, unchanged.rdict[str, Object | Alias]c>|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_classr;r/r,s r"r*zObjectAliasMixin.all_memberss+ = >=d,= = =|r$dict[str, Module]cHd|jDS)z~The module members. This method is part of the consumer API: do not use when producing Griffe trees! c@i|]\}}|jtju||Sr5)kindrMODULE.0r=rTs r" z,ObjectAliasMixin.modules..s.hhhvV[\`\gMgMgfMgMgMgr$r*itemsrrs r"moduleszObjectAliasMixin.modules s(ih1A1G1G1I1Ihhhhr$dict[str, Class]cHd|jDS)z}The class members. This method is part of the consumer API: do not use when producing Griffe trees! c@i|]\}}|jtju||Sr5)rvrCLASSrxs r"rzz,ObjectAliasMixin.classes..s.gggvV[\`\fMfMffMfMfMfr$r{rrs r"classeszObjectAliasMixin.classess(hg1A1G1G1I1Iggggr$dict[str, Function]cHd|jDS)zThe function members. This method is part of the consumer API: do not use when producing Griffe trees! c@i|]\}}|jtju||Sr5)rvrFUNCTIONrxs r"rzz.ObjectAliasMixin.functions..$s.jjjvV[\`\iMiMifMiMiMir$r{rrs r" functionszObjectAliasMixin.functionss(kj1A1G1G1I1Ijjjjr$dict[str, Attribute]cHd|jDS)zThe attribute members. This method is part of the consumer API: do not use when producing Griffe trees! c@i|]\}}|jtju||Sr5)rvr ATTRIBUTErxs r"rzz/ObjectAliasMixin.attributes..-s.kkkvV[\`\jMjMjfMjMjMjr$r{rrs r" attributeszObjectAliasMixin.attributes&s(lk1A1G1G1I1Ikkkkr$dict[str, TypeAlias]cHd|jDS)zThe type alias members. This method is part of the consumer API: do not use when producing Griffe trees! c@i|]\}}|jtju||Sr5)rvr TYPE_ALIASrxs r"rzz1ObjectAliasMixin.type_aliases..6s.lllvV[\`\kMkMkfMkMkMkr$r{rrs r" type_aliaseszObjectAliasMixin.type_aliases/s(ml1A1G1G1I1Illllr$rYcF|jdo|j S)zGWhether this object/alias is private (starts with `_`) but not special._)r= startswith is_specialrrs r" is_privatezObjectAliasMixin.is_private8s$y##C((@-@@r$cj|jdo|jdS)z[Whether this object/alias is special ("dunder" attribute/method, starts and end with `__`).__)r=rendswithrrs r"rzObjectAliasMixin.is_special=s/y##D))Fdi.@.@.F.FFr$ct|jo@|jjo4|jdo|jd S)zTWhether this object/alias is class-private (starts with `__` and is a class member).r)rYrHrqr=rrrrs r"is_class_privatez!ObjectAliasMixin.is_class_privateBsQ    v$+"6 v49;O;OPT;U;U v^b^g^p^pqu^v^vZv r$cPt|jo|j|jjvS)z;Whether this object/alias was imported from another module.)rYrHr=importsrrs r" is_importedzObjectAliasMixin.is_importedIs%DK  ETY$+2E%EEr$ct|jo7|jjo+t|jjo|j|jjvS)z***X*X%%%X% ***X***r$rn)rrrr)" __future__rr_ contextlibrtypingrrrgriffe._internal.enumerationsrgriffe._internal.exceptionsr r r griffe._internal.mergerr collections.abcr griffe._internal.modelsrrrrrrrrr#r&r7rBrWrnr5r$r"rs#""""" ................bbbbbbbbbb//////e((((((dddddddddddddddddd 7:      -<-<-<-<-<-<-<-