i(:dZddlmZmZddlmZddlmZddlm Z ddl m Z erddlm Z Gdd eZ Gd d e ZGd d e ZGdde ZGdde ZGdde ZGdde ZGdde ZdS)zFThis module contains objects representing Telegram bot command scopes.) TYPE_CHECKINGFinal) constants)TelegramObject)enum)JSONDict)BotceZdZUdZdZejjZee 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 d e d ed zffdZeddeddddffd ZxZS)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 rct|tjtj|||_|jf|_|dS)Nr) super__init__r get_memberrBotCommandScopeTyper _id_attrs_freeze)selfr r __class__s Y/Users/shanyulin/my-agent/.venv/lib/python3.11/site-packages/telegram/_botcommandscope.pyrzBotCommandScope.__init__PsR J///)FdSS ) databotz Bot | Nonereturnc||}|jt|jt|jt |jt|j t|j t|j ti}|turG|d|vr0||d||St'||S)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. r )r!r") _parse_datar BotCommandScopeDefaultrBotCommandScopeAllPrivateChatsrBotCommandScopeAllGroupChatsr$BotCommandScopeAllChatAdministratorsrBotCommandScopeChatr!BotCommandScopeChatAdministratorsrBotCommandScopeChatMemberr getpopde_jsonr)clsr!r"_class_mappingrs rr/zBotCommandScope.de_jsonWs"t$$ K/  !#A  !=  ')M H)  #%F O6<  / ! !dhhv&6&6.&H&H!$((6"2"23;;3;OO OwwDc222r )N)__name__ __module__ __qualname____doc__ __slots__rrr rstr__annotations__rrrrrrrr classmethodr/ __classcell__rs@rr r !s:I#7?GU3Z???A$-$A$SuSzSSSK"+"?"OOU3ZOOOI*3*G*_U3Z___Q 49D%*999>&/&C&WsWWWM';GKsGGGECGSD3383,3BS33333[33333r r c8eZdZdZdZdddedzffdZxZS)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`. Nrrcttj||dSNr r)rrr r rrrrs rrzBotCommandScopeDefault.__init__s4 o5*MMM r r2r3r4r5r6rrr:r;s@rr&r&ysfI8<hor r&c8eZdZdZdZdddedzffdZxZS)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=Nrrcttj||dSr?)rrr rrrAs rrz'BotCommandScopeAllPrivateChats.__init__s4 o?JWWW r rBr;s@rr'r'sfI8<hor r'c8eZdZdZdZdddedzffdZxZS)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=Nrrcttj||dSr?)rrr rrrAs rrz%BotCommandScopeAllGroupChats.__init__s4 o=*UUU r rBr;s@rr(r(fI8<hor r(c8eZdZdZdZdddedzffdZxZS)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=Nrrcttj||dSr?)rrr rrrAs rrz-BotCommandScopeAllChatAdministrators.__init__s5 oER\]]] r rBr;s@rr)r)rGr r)cBeZdZdZdZdddeezdedzffdZxZ 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_idNrrLrcbttj||5t |t r|dr|nt||_ |j |j f|_ ddddS#1swxYwYdSNr@@) rrr r _unfrozen isinstancer7 startswithintrLr rrrLrrs rrzBotCommandScopeChat.__init__s o2zJJJ ^^   7 7%gs33a8J8J38O8OaUXY`UaUa L#i6DN  7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7AB$$B(+B( r2r3r4r5r6r7rSrrr:r;s@rr*r*q  ILP777c 7(T/7777777777r r*cBeZdZdZdZdddeezdedzffdZxZ 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| rKNrrLrcbttj||5t |t r|dr|nt||_ |j |j f|_ ddddS#1swxYwYdSrN) rrr rrPrQr7rRrSrLr rrTs rrz*BotCommandScopeChatAdministrators.__init__s oAjYYY ^^   7 7%gs33a8J8J38O8OaUXY`UaUa L#i6DN  7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7rUrVr;s@rr+r+rWr r+cFeZdZdZdZdddeezdededzffdZxZ 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. )rLuser_idNrrLr[rc|ttj||5t |t r|dr|nt||_ ||_ |j |j |j f|_ ddddS#1swxYwYdSrN) rrr rrPrQr7rRrSrLr[r r)rrLr[rrs rrz"BotCommandScopeChatMember.__init__s o9jQQQ ^^   E E%gs33a8J8J38O8OaUXY`UaUa L!(DL"it|DDN  E E E E E E E E E E E E E E E E E EsA!B11B58B5rVr;s@rr,r,s$'IZ^EEEc ECESWEEEEEEEEEEr r,N)r5typingrrtelegramrtelegram._telegramobjectrtelegram._utilsrtelegram._utils.typesrr r r&r'r(r)r*r+r,r=r rrbs(ML''''''''333333 ******U3U3U3U3U3nU3U3U3p_$     _        ?        ?   77777/7776777777776EEEEEEEEEEr