-huG>ddlmZddlZddlmZddlmZmZmZddl m Z ddl m Z m Z mZddlmZerddlmZdd lmZmZmZmZmZmZed ZddZGddZGddZGddZGddZGddeeeeZ dS)) annotationsN)suppress) TYPE_CHECKINGAnyTypeVar)Kind)AliasResolutionErrorBuiltinModuleErrorCyclicAliasError) merge_stubs)Sequence)Alias AttributeClassFunctionModuleObject_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 K/var/www/FlaskApp/flask-venv/lib/python3.11/site-packages/_griffe/mixins.py _get_partsr"sd#s @>?? ? #S  ;9::: Lc"eZdZdZd dZd dZdS) 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 `[]`. 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!r/zGetMembersMixin.get_member@sV"3 u::??<a) )|E!H%00qrr;;;r#N)rrrr)__name__ __module__ __qualname____doc__r,r/r#r!r%r%"sF5555,<<<<<>> 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__as"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_member|sd"3 u::??8D T""" Lq " - -eABBi 8 8 8 8 8r#N)rrrr7)r0r1r2r3r=r?r4r#r!r6r6YsF66666999999r#r6c"eZdZdZd dZd d Zd S) 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 `[]`. rrvalueObject | Aliasrr7ct|}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+rrBr 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 aliasesvaluestargetrErFrG set_member)r+rrBr r<memberaliass r!rRzSetMembersMixin.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)rrrBrCrr7)r0r1r2r3rHrRr4r#r!rArAsL66664)@)@)@)@)@)@r#rAc8eZdZdZdddd ZeddZdS)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)fullrWboolkwargsrrrc 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)clsrW)_griffe.encodersr[jsondumps)r+rWrYr[s r!as_jsonzSerializationMixin.as_jsons5 100000z$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]rd setdefaultr^loadsr TypeError)r\rbrYrdobjs r! from_jsonzSerializationMixin.from_jsonsr 211111-666j////#s## JH3HHII I r#N)rWrXrYrrr)r\rarbrrYrrr)r0r1r2r3r` classmethodrjr4r#r!rVrVsg', F F F F F F[r#rVcJeZdZdZeddZeddZeddZedd Zedd Z eddZ eddZ eddZ eddZ eddZeddZeddZeddZdS)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. 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_members$s+ = >=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||Sr4)kindrMODULE.0r<rSs r! z,ObjectAliasMixin.modules..6s.hhhvV[\`\gMgMgfMgMgMgr#r)itemsrqs 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||Sr4)rurCLASSrws r!ryz,ObjectAliasMixin.classes..?s.gggvV[\`\fMfMffMfMfMfr#rzrqs r!classeszObjectAliasMixin.classes8s(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||Sr4)rurFUNCTIONrws r!ryz.ObjectAliasMixin.functions..Hs.jjjvV[\`\iMiMifMiMiMir#rzrqs r! functionszObjectAliasMixin.functionsAs(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||Sr4)rur ATTRIBUTErws r!ryz/ObjectAliasMixin.attributes..Qs.kkkvV[\`\jMjMjfMjMjMjr#rzrqs r! attributeszObjectAliasMixin.attributesJs(lk1A1G1G1I1Ikkkkr#rXcF|jdo|j S)zGWhether this object/alias is private (starts with `_`) but not special._)r< startswith is_specialrqs r! is_privatezObjectAliasMixin.is_privateSs$y##C((@-@@r#cj|jdo|jdS)z[Whether this object/alias is special ("dunder" attribute/method, starts and end with `__`).__)r<rendswithrqs r!rzObjectAliasMixin.is_specialXs/y##D))Fdi.@.@.F.FFr#c|jo@|jjo4|jdo|jd S)zTWhether this object/alias is class-private (starts with `__` and is a class member).r)rGrpr<rrrqs r!is_class_privatez!ObjectAliasMixin.is_class_private]sF{st{3s 8L8LT8R8Rs[_[d[m[mnr[s[sWssr#c6|jo|j|jjvS)z;Whether this object/alias was imported from another module.)rGr<importsrqs r! is_importedzObjectAliasMixin.is_importedbs{?tyDK,???r#cr|jjo+t|jjo|j|jjvS)z***X*X%%%X%%%r#rm)rrrr)! __future__rr^ contextlibrtypingrrr_griffe.enumerationsr_griffe.exceptionsr r r _griffe.mergerr collections.abcr _griffe.modelsrrrrrrrr"r%r6rArVrmr4r#r!rs#""""" ..........%%%%%%YYYYYYYYYY&&&&&&Q((((((PPPPPPPPPPPPPPPP 7:      2<2<2<2<2<2<2<2