U dd'@sdZddlmZmZmZmZmZmZddlm Z ddl m Z ddl m Z erXddlmZGddde ZGd d d eZGd d d eZGd ddeZGdddeZGdddeZGdddeZGdddeZdS)zFThis module contains objects representing Telegram bot command scopes.) TYPE_CHECKINGClassVarDictOptionalTypeUnion) constants)TelegramObject)JSONDict)BotcseZdZUdZdZejjZee e d<ejj Z ee e d<ejj Z ee e d<ejj Z ee e d<ejjZee e d<ejjZee e d<ejjZee e d <d d e ed fd dZeeededdfdd ZZS)BotCommandScopea/Base class for objects that represent the scope to which bot commands are applied. Currently, the following 7 scopes are supported: * :class:`telegram.BotCommandScopeDefault` * :class:`telegram.BotCommandScopeAllPrivateChats` * :class:`telegram.BotCommandScopeAllGroupChats` * :class:`telegram.BotCommandScopeAllChatAdministrators` * :class:`telegram.BotCommandScopeChat` * :class:`telegram.BotCommandScopeChatAdministrators` * :class:`telegram.BotCommandScopeChatMember` Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`type` is equal. For subclasses with additional attributes, the notion of equality is overridden. Note: Please see the `official docs`_ on how Telegram determines which commands to display. .. _`official docs`: https://core.telegram.org/bots/api#determining-list-of-commands .. versionadded:: 13.7 Args: type (:obj:`str`): Scope type. Attributes: type (:obj:`str`): Scope type. )typeDEFAULTALL_PRIVATE_CHATSALL_GROUP_CHATSALL_CHAT_ADMINISTRATORSCHATCHAT_ADMINISTRATORS CHAT_MEMBERN api_kwargsr rcs*tj|d||_|jf|_|dS)Nr)super__init__r _id_attrs_freeze)selfr r __class__=/tmp/pip-unpacked-wheel-e3anp165/telegram/_botcommandscope.pyrNs zBotCommandScope.__init__r )databotreturncs~||}|sdS|jt|jt|jt|jt|j t |j t |j ti}|tkrn|d|krn||dj||dStj||dS)aTConverts JSON data to the appropriate :class:`BotCommandScope` object, i.e. takes care of selecting the correct subclass. Args: data (Dict[:obj:`str`, ...]): The JSON data. bot (:class:`telegram.Bot`): The bot associated with this object. Returns: The Telegram object. Nr )r!r")Z _parse_datarBotCommandScopeDefaultrBotCommandScopeAllPrivateChatsrBotCommandScopeAllGroupChatsr$BotCommandScopeAllChatAdministratorsrBotCommandScopeChatr!BotCommandScopeChatAdministratorsrBotCommandScopeChatMemberr getpopde_jsonr)clsr!r"Z_class_mappingrrr r-Us*  zBotCommandScope.de_json)__name__ __module__ __qualname____doc__ __slots__rZBotCommandScopeTyperrstr__annotations__rrrrrrr r classmethodrr- __classcell__rrrr r s r cs0eZdZdZdZddedfddZZS)r$aoRepresents the default scope of bot commands. Default commands are used if no commands with a `narrower scope`_ are specified for the user. .. _`narrower scope`: https://core.telegram.org/bots/api#determining-list-of-commands .. versionadded:: 13.7 Attributes: type (:obj:`str`): Scope type :tg-const:`telegram.BotCommandScope.DEFAULT`. rNrcstjtj|d|dSNr)rrr rrrrrrr rszBotCommandScopeDefault.__init__r/r0r1r2r3r rr7rrrr r$vs r$cs0eZdZdZdZddedfddZZS)r%zRepresents the scope of bot commands, covering all private chats. .. versionadded:: 13.7 Attributes: type (:obj:`str`): Scope type :tg-const:`telegram.BotCommandScope.ALL_PRIVATE_CHATS`. rNrcstjtj|d|dSr8)rrr rrr9rrr rsz'BotCommandScopeAllPrivateChats.__init__r:rrrr r%sr%cs0eZdZdZdZddedfddZZS)r&zRepresents the scope of bot commands, covering all group and supergroup chats. .. versionadded:: 13.7 Attributes: type (:obj:`str`): Scope type :tg-const:`telegram.BotCommandScope.ALL_GROUP_CHATS`. rNrcstjtj|d|dSr8)rrr rrr9rrr rsz%BotCommandScopeAllGroupChats.__init__r:rrrr r&sr&cs0eZdZdZdZddedfddZZS)r'zRepresents the scope of bot commands, covering all group and supergroup chat administrators. .. versionadded:: 13.7 Attributes: type (:obj:`str`): Scope type :tg-const:`telegram.BotCommandScope.ALL_CHAT_ADMINISTRATORS`. rNrcstjtj|d|dSr8)rrr rrr9rrr rsz-BotCommandScopeAllChatAdministrators.__init__r:rrrr r'sr'cs:eZdZdZdZddeeefedfddZ Z S)r(aRepresents the scope of bot commands, covering a specific chat. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`type` and :attr:`chat_id` are equal. .. versionadded:: 13.7 Args: chat_id (:obj:`str` | :obj:`int`): |chat_id_group| Attributes: type (:obj:`str`): Scope type :tg-const:`telegram.BotCommandScope.CHAT`. chat_id (:obj:`str` | :obj:`int`): |chat_id_group| chat_idNrr<rc sZtjtj|d|6t|tr4|dr4|nt||_ |j |j f|_ W5QRXdSNr@) rrr r _unfrozen isinstancer4 startswithintr<r rrr<rrrr rs  zBotCommandScopeChat.__init__ r/r0r1r2r3rr4rCr rr7rrrr r(sr(cs:eZdZdZdZddeeefedfddZ Z S)r)a(Represents the scope of bot commands, covering all administrators of a specific group or supergroup chat. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`type` and :attr:`chat_id` are equal. .. versionadded:: 13.7 Args: chat_id (:obj:`str` | :obj:`int`): |chat_id_group| Attributes: type (:obj:`str`): Scope type :tg-const:`telegram.BotCommandScope.CHAT_ADMINISTRATORS`. chat_id (:obj:`str` | :obj:`int`): |chat_id_group| r;Nrr=c sZtjtj|d|6t|tr4|dr4|nt||_ |j |j f|_ W5QRXdSr>) rrr rr@rAr4rBrCr<r rrDrrr rs  z*BotCommandScopeChatAdministrators.__init__rErrrr r)sr)cs<eZdZdZdZddeeefeedfddZ Z S)r*aRepresents the scope of bot commands, covering a specific member of a group or supergroup chat. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`type`, :attr:`chat_id` and :attr:`user_id` are equal. .. versionadded:: 13.7 Args: chat_id (:obj:`str` | :obj:`int`): |chat_id_group| user_id (:obj:`int`): Unique identifier of the target user. Attributes: type (:obj:`str`): Scope type :tg-const:`telegram.BotCommandScope.CHAT_MEMBER`. chat_id (:obj:`str` | :obj:`int`): |chat_id_group| user_id (:obj:`int`): Unique identifier of the target user. )r<user_idNr)r<rFrc sdtjtj|d|@t|tr4|dr4|nt||_ ||_ |j |j |j f|_ W5QRXdSr>) rrr rr@rAr4rBrCr<rFr r)rr<rFrrrr rs  z"BotCommandScopeChatMember.__init__rErrrr r*sr*N)r2typingrrrrrrZtelegramrZtelegram._telegramobjectr Ztelegram._utils.typesr r r r$r%r&r'r(r)r*rrrr s     W