o w!guG@sddlmZddlZddlmZddlmZmZmZddl m Z ddl m Z m Z mZddlmZerHddlmZdd lmZmZmZmZmZmZed ZdddZGdddZGdddZGdddZGdddZGdddeeeeZ dS)) annotationsN)suppress) TYPE_CHECKINGAnyTypeVar)Kind)AliasResolutionErrorBuiltinModuleErrorCyclicAliasError) merge_stubs)Sequence)Alias AttributeClassFunctionModuleObject_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)rpartsrP/mnt/skqttb/ctump_chatbot/chatbot/lib/python3.10/site-packages/_griffe/mixins.py _get_partss  r!c@$eZdZdZd ddZd dd Zd S) 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 `[]`. 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_membersselfrrrrr __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'rrr r+@s zGetMembersMixin.get_memberN)rrrr)__name__ __module__ __qualname____doc__r)r+rrrr r#"s r#c@r") DelMembersMixinzMixin class to share methods for deleting members. Methods: del_member: Delete a member with its name or path. __delitem__: Same as `del_member`, with the item syntax `[]`. 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(rrnamerrr __delitem__as  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_memberr4rrr r7|s    zDelMembersMixin.del_memberN)rrrr1)r,r-r.r/r6r7rrrr r0Ys r0c@s$eZdZdZd dd Zd d 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 | Aliasrr1cCs^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(rr9rr5rrr __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(rr9rr5memberaliasrrr rGs0         "zSetMembersMixin.set_memberN)rrr9r:rr1)r,r-r.r/r>rGrrrr r8s r8c@s.eZdZdZdddd d ZedddZdS)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)fullrKboolkwargsrrrcKs$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)clsrK)_griffe.encodersrNjsondumps)r(rKrMrNrrr as_jsons zSerializationMixin.as_jsonrOtype[_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 )rPrV setdefaultrQloadsr TypeError)rOrUrMrVobjrrr from_jsons   zSerializationMixin.from_jsonN)rKrLrMrrr)rOrTrUrrMrrr)r,r-r.r/rS classmethodr\rrrr rJs rJc@seZdZdZed$ddZed%ddZed&d d Zed'd dZed(ddZ ed)ddZ ed)ddZ ed)ddZ ed)ddZ ed)ddZed)ddZed)dd Zed)d!d"Zd#S)*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]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_classr3r*r(rrr 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.0r5rHrrr 6"z,ObjectAliasMixin.modules..r&itemsrarrr modules/zObjectAliasMixin.modulesdict[str, Class]cCrc)z}The class members. This method is part of the consumer API: do not use when producing Griffe trees! cSrdr)rerCLASSrgrrr ri?rjz,ObjectAliasMixin.classes..rkrarrr classes8rnzObjectAliasMixin.classesdict[str, Function]cCrc)zThe function members. This method is part of the consumer API: do not use when producing Griffe trees! cSrdr)rerFUNCTIONrgrrr riHrjz.ObjectAliasMixin.functions..rkrarrr functionsArnzObjectAliasMixin.functionsdict[str, Attribute]cCrc)zThe attribute members. This method is part of the consumer API: do not use when producing Griffe trees! cSrdr)rer ATTRIBUTErgrrr riQrjz/ObjectAliasMixin.attributes..rkrarrr attributesJrnzObjectAliasMixin.attributesrLcCs|jdo |j S)zGWhether this object/alias is private (starts with `_`) but not special._)r5 startswith is_specialrarrr is_privateSzObjectAliasMixin.is_privatecCs|jdo |jdS)z[Whether this object/alias is special ("dunder" attribute/method, starts and end with `__`).__)r5ryendswithrarrr rzXszObjectAliasMixin.is_specialcCs(|jo|jjo|jdo|jd S)zTWhether this object/alias is class-private (starts with `__` and is a class member).r})r=r`r5ryr~rarrr is_class_private]s(z!ObjectAliasMixin.is_class_privatecCs|jo |j|jjvS)z;Whether this object/alias was imported from another module.)r=r5importsrarrr is_importedbr|zObjectAliasMixin.is_importedcCs"|jjot|jjo|j|jjvS)zs"        7<N.