U g)@sdZddlmZmZmZmZmZmZddlm Z ddl m Z ddl m Z ddlmZerdddlmZGdd d e ZGd d d eZGd d d eZGdddeZGdddeZGdddeZGdddeZGdddeZdS)zFThis module contains objects representing Telegram bot command scopes.) TYPE_CHECKINGDictFinalOptionalTypeUnion) constants)TelegramObject)enum)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 eed fd dZedeeededdfdd 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_kwargsrrcs6tj|dttj|||_|jf|_|dS)Nr) super__init__r Z get_memberrBotCommandScopeTyper _id_attrs_freeze)selfrr __class__=/tmp/pip-unpacked-wheel-swnnwir2/telegram/_botcommandscope.pyrOs zBotCommandScope.__init__r )databotreturncs~||}|sdS|jt|jt|jt|jt|j t |j t |j ti}|tkrn|d|krn||dj||dStj||dS)a6Converts 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`, optional): The bot associated with this object. Defaults to :obj:`None`, in which case shortcut methods will not be available. .. versionchanged:: 21.4 :paramref:`bot` is now optional and defaults to :obj:`None` Returns: The Telegram object. Nr)r#r$)Z _parse_datarBotCommandScopeDefaultrBotCommandScopeAllPrivateChatsrBotCommandScopeAllGroupChatsr$BotCommandScopeAllChatAdministratorsrBotCommandScopeChatr!BotCommandScopeChatAdministratorsrBotCommandScopeChatMemberr getpopde_jsonr)clsr#r$Z_class_mappingrr!r"r/Vs*  zBotCommandScope.de_json)N)__name__ __module__ __qualname____doc__ __slots__rrrrstr__annotations__rrrrrrrr r classmethodr/ __classcell__r!r!rr"r s" r cs4eZdZdZdZddeedfddZZS)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`. r!Nrcstjtj|d|dSNr)rrr rrrrrr!r"rszBotCommandScopeDefault.__init__ r1r2r3r4r5rr rr9r!r!rr"r&}s r&cs4eZdZdZdZddeedfddZZS)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`. r!Nrcstjtj|d|dSr:)rrr rrr;rr!r"rsz'BotCommandScopeAllPrivateChats.__init__r<r!r!rr"r'sr'cs4eZdZdZdZddeedfddZZS)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`. r!Nrcstjtj|d|dSr:)rrr rrr;rr!r"rsz%BotCommandScopeAllGroupChats.__init__r<r!r!rr"r(sr(cs4eZdZdZdZddeedfddZZS)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`. r!Nrcstjtj|d|dSr:)rrr rrr;rr!r"rsz-BotCommandScopeAllChatAdministrators.__init__r<r!r!rr"r)sr)cs>eZdZdZdZddeeefee dfddZ 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 isinstancer6 startswithintr>rrrr>rrr!r"rs  zBotCommandScopeChat.__init__ r1r2r3r4r5rr6rErr rr9r!r!rr"r*sr*cs>eZdZdZdZddeeefee dfddZ 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 rrBrCr6rDrEr>rrrFrr!r"rs  z*BotCommandScopeChatAdministrators.__init__rGr!r!rr"r+sr+cs@eZdZdZdZddeeefeee dfddZ 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>rHrc sdtjtj|d|@t|tr4|dr4|nt||_ ||_ |j |j |j f|_ W5QRXdSr@) rrr rrBrCr6rDrEr>rHrr)rr>rHrrr!r"rs  z"BotCommandScopeChatMember.__init__rGr!r!rr"r,s r,N)r4typingrrrrrrZtelegramrZtelegram._telegramobjectr Ztelegram._utilsr Ztelegram._utils.typesr r r r&r'r(r)r*r+r,r!r!r!r"s      ]