o
    "h1)                     @   s   d Z ddlmZmZmZmZ ddlmZ ddlm	Z	 ddl
mZ ddlmZ er.ddlmZ G dd	 d	e	ZG d
d deZG dd deZG dd deZG dd deZG dd deZG dd deZG dd deZdS )zFThis module contains objects representing Telegram bot command scopes.    )TYPE_CHECKINGFinalOptionalUnion)	constants)TelegramObject)enum)JSONDict)Botc                       s   e Zd ZU dZdZejjZee	 e
d< 	 ejjZee	 e
d< 	 ejjZee	 e
d< 	 ejjZee	 e
d< 	 ejjZee	 e
d< 	 ejjZee	 e
d< 	 ejjZee	 e
d	< 	 d
dde	dee f fddZeddeded dd f fddZ  ZS )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.
    )typeDEFAULTALL_PRIVATE_CHATSALL_GROUP_CHATSALL_CHAT_ADMINISTRATORSCHATCHAT_ADMINISTRATORSCHAT_MEMBERN
api_kwargsr   r   c                   s6   t  j|d ttj||| _| jf| _|   d S )Nr   )	super__init__r   
get_memberr   BotCommandScopeTyper   	_id_attrs_freeze)selfr   r   	__class__ L/var/www/html/venv/lib/python3.10/site-packages/telegram/_botcommandscope.pyr   O   s   
zBotCommandScope.__init__databotr
   returnc                    sv   |  |}| jt| jt| jt| jt| j	t
| jt| jti}| tu r3|d|v r3||d j||dS t j||dS )a6  Converts 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   BotCommandScopeDefaultr   BotCommandScopeAllPrivateChatsr   BotCommandScopeAllGroupChatsr   $BotCommandScopeAllChatAdministratorsr   BotCommandScopeChatr   !BotCommandScopeChatAdministratorsr   BotCommandScopeChatMemberr   getpopde_jsonr   )clsr!   r"   _class_mappingr   r   r    r.   V   s   

zBotCommandScope.de_json)N)__name__
__module____qualname____doc__	__slots__r   r   r   r   str__annotations__r   r   r   r   r   r   r   r	   r   classmethodr.   __classcell__r   r   r   r    r       s(   
  *r   c                       4   e Zd ZdZdZdddee f fddZ  ZS )r%   ao  Represents 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   Nr   r   c                      t  jtj|d |   d S Nr   r   )r   r   r   r   r   r   r   r   r   r    r         zBotCommandScopeDefault.__init__	r1   r2   r3   r4   r5   r   r	   r   r9   r   r   r   r    r%   x   s    
$r%   c                       r:   )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   Nr   r   c                   r;   r<   )r   r   r   r   r   r>   r   r   r    r      r?   z'BotCommandScopeAllPrivateChats.__init__r@   r   r   r   r    r&      s    $r&   c                       r:   )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   Nr   r   c                   r;   r<   )r   r   r   r   r   r>   r   r   r    r      r?   z%BotCommandScopeAllGroupChats.__init__r@   r   r   r   r    r'          $r'   c                       r:   )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   Nr   r   c                   r;   r<   )r   r   r   r   r   r>   r   r   r    r      r?   z-BotCommandScopeAllChatAdministrators.__init__r@   r   r   r   r    r(      rA   r(   c                       @   e Zd ZdZdZdddeeef dee	 f fddZ
  ZS )	r)   a  Represents 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_idNr   rD   r   c                   p   t  jtj|d |  ! t|tr|dr|nt|| _	| j
| j	f| _W d    d S 1 s1w   Y  d S Nr=   @)r   r   r   r   	_unfrozen
isinstancer6   
startswithintrD   r   r   r   rD   r   r   r   r    r         
"zBotCommandScopeChat.__init__r1   r2   r3   r4   r5   r   r6   rK   r   r	   r   r9   r   r   r   r    r)          0r)   c                       rB   )	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|
    rC   Nr   rD   r   c                   rE   rF   )r   r   r   r   rH   rI   r6   rJ   rK   rD   r   r   rL   r   r   r    r      rM   z*BotCommandScopeChatAdministrators.__init__rN   r   r   r   r    r*      rO   r*   c                       sD   e Zd ZdZdZdddeeef dedee	 f fdd	Z
  ZS )
r+   a  Represents 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.
    )rD   user_idNr   rD   rP   r   c                   sz   t  jtj|d |  & t|tr|dr|nt|| _	|| _
| j| j	| j
f| _W d    d S 1 s6w   Y  d S rF   )r   r   r   r   rH   rI   r6   rJ   rK   rD   rP   r   r   )r   rD   rP   r   r   r   r    r     s   
"z"BotCommandScopeChatMember.__init__rN   r   r   r   r    r+      s    
r+   N)r4   typingr   r   r   r   telegramr   telegram._telegramobjectr   telegram._utilsr   telegram._utils.typesr	   r
   r   r%   r&   r'   r(   r)   r*   r+   r   r   r   r    <module>   s    X