o
    GCh                     @   s|  d Z ddlmZ ddlmZ ddlm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 dd
lmZ ddlmZ ddlmZ ddlmZ ddlmZmZmZmZm Z  ddl!m"Z" ddl!m#Z$ ddl!m%Z& erddlm'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;m<Z<m=Z=m>Z>m?Z?m@Z@mAZA G dd deZBG dd deBZCdS )z?This module contains an object that represents a Telegram Chat.    )Sequence)datetime)escape)TYPE_CHECKINGFinalOptionalUnion)	constants)ChatPermissions)
ForumTopic)
MenuButton)ReactionType)TelegramObject)enum)DEFAULT_NONE)CorrectOptionID	FileInputJSONDictODVInputReplyMarkup)escape_markdown)mention_html)mention_markdown)	AnimationAudioChatInviteLink
ChatMemberContactDocumentInlineKeyboardMarkupInputMediaAudioInputMediaDocumentInputMediaPhotoInputMediaVideoInputPaidMediaInputPollOptionLabeledPriceLinkPreviewOptionsLocationMessageMessageEntity	MessageId	PhotoSizeReplyParametersStickerUserChatBoostsVenueVideo	VideoNoteVoicec                J       s'  e Zd ZU dZdZ					d^dddededee dee d	ee d
ee dee dee	 f fd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dee fddZedee fddZedee fddZd_dee defddZd_dee defddZd_dee defd d!Zeeeedd"d#ee d$ee d%ee d&ee dee	 defd'd(Zeeeedd"d#ee d$ee d%ee d&ee dee	 ded) fd*d+Z eeeedd"d#ee d$ee d%ee d&ee dee	 defd,d-Z!eeeedd"d.ed#ee d$ee d%ee d&ee dee	 dd/fd0d1Z"		d`eeeedd"d.ed2ee d3ee#ee$f  d#ee d$ee d%ee d&ee dee	 defd4d5Z%eeeedd"d6ed#ee d$ee d%ee d&ee dee	 defd7d8Z&eeeedd"d9e#eef d#ee d$ee d%ee d&ee dee	 defd:d;Z'eeeedd"d6ed#ee d$ee d%ee d&ee dee	 defd<d=Z(eeeedd"d9e#eef d#ee d$ee d%ee d&ee dee	 defd>d?Z)	d_eeeedd"d.ed@ee d#ee d$ee d%ee d&ee dee	 defdAdBZ*															daeeeedd"d.edCee dDee dEee dFee dGee dHee dIee dJee dKee dLee dMee dNee dOee dPee dQee d#ee d$ee d%ee d&ee dee	 def,dRdSZ+		d`eeeedd"d.edTe,d3ee#ee$f  dUee d#ee d$ee d%ee d&ee dee	 defdVdWZ-	d_eeeedd"dTe,dUee d#ee d$ee d%ee d&ee dee	 defdXdYZ.eeeedd"d.edZed#ee d$ee d%ee d&ee dee	 defd[d\Z/eeeedd"d]e0d#ee d$ee d%ee d&ee dee	 defd^d_Z1eeeedd"d#ee d$ee d%ee d&ee dee	 defd`daZ2eeeedd"ded#ee d$ee d%ee d&ee dee	 defdbdcZ3	d_eeeedd"ddee d#ee d$ee d%ee d&ee dee	 defdedfZ4edfeeeedd"dgedhee diee d#ee d$ee d%ee d&ee dee	 defdjdkZ5		d`eeeedd"dgee diee d#ee d$ee d%ee d&ee dee	 defdldmZ6eeeedd"d#ee d$ee d%ee d&ee dee	 defdndoZ7eeddededdddfdedeeeeddpdqedree dhee dsee8 dtee9du  dvee dwee dxedy dzed{ diee d|ee d}ee d~ee dee dee d#ee d$ee d%ee d&ee dee	 ddf*ddZ:eeeedd"dged#ee d$ee d%ee d&ee dee	 defddZ;eeeedd"de9e d#ee d$ee d%ee d&ee dee	 defddZ<eedddddfdeeeeeddedd
de9e#d  dhee dvee dwee dzed{ diee d|ee d}ee d~ee dee d#ee d$ee d%ee d&ee dee	 dee dree dee9du  ded f&ddZ=		d`eeeedd"dedwee diee d#ee d$ee d%ee d&ee dee	 defddZ>e>Z?	 dedededddddddfdedeeeeddd]e#e0df dee dhee dsee8 dree dee9du  dvee dwee dee dzed{ diee d|ee d}ee dee d~ee dee dee d#ee d$ee d%ee d&ee dee	 ddf.ddZ@dddeddedddddfdedeeeedddee d	ee d
ee dhee dsee8 dee dvee dwee dzed{ diee d|ee d}ee d~ee dee ded d#ee d$ee d%ee d&ee dee	 ddf*ddZAddddedededdddddfdedeeeeddde#e0df dee dee dee dee dhee dsee8 dree dee9du  dvee dwee dee0 dzed{ diee d|ee d}ee d~ee dee dee d#ee d$ee d%ee d&ee dee	 ddf2ddZBdededdeddddddfdedeeeeddde#e0df dee dhee dsee8 dree dee dee9du  dvee dwee dee0 dzed{ diee d|ee d}ee d~ee dee dee d#ee d$ee d%ee d&ee dee	 ddf.ddZCeddedddddf	deeeeedddhee dsee8 dee dvee dwee dzed{ diee d|ee d}ee d~ee dee d#ee d$ee d%ee d&ee dee	 ddf"ddZDededddddfdeeeeedddedhee dsed dvee dwee dzed{ diee d|ee d}ee d~ee dee d#ee d$ee d%ee d&ee dee	 ddf"ddZEddddddddddeddddddeddddfdeeeeedddeddededee dede9d dee dee dee dee dee dee dee dee dee dee dhee dsed dee#eeFf  dee dee dee dee9e  dvee dwee dzed{ d|ee d}ee d~ee dee d#ee d$ee d%ee d&ee dee	 ddfHdd˄ZGddedddddedddddfdedeeeedd̜dee dee dhee dsee8 dee dee dee dee dvee dwee dzed{ diee d|ee d}ee d~ee dee ded d#ee d$ee d%ee d&ee dee	 ddf.ddքZHddddeeddeddddddddfdedeeeeddde#e0df dee dee dee dee dree dhee dsee8 dee9du  dvee dwee dee dee0 dzed{ diee d|ee d}ee dee d~ee dee dee d#ee d$ee d%ee d&ee dee	 ddf6dd܄ZIededdddddf	deeeeeddde#e0df dhee dsee8 dvee dwee dee dzed{ diee d|ee d}ee d~ee dee d#ee d$ee d%ee d&ee dee	 ddf$ddZJdddddeddddedddddfdedeeeedddee dee dee dee dee dhee dsee8 dee dee dee dvee dwee dzed{ diee d|ee d}ee d~ee dee ded d#ee d$ee d%ee d&ee dee	 ddf2ddZKddedddeddeddddddddfdedeeeeddde#e0df dee dee dhee dsee8 dee dee dree dee dee9du  dvee dwee dee dee0 dzed{ diee d|ee d}ee dee d~ee dee dee d#ee d$ee d%ee d&ee dee	 ddf8ddZLddededdddddfdedeeeeddde#e0df dee dee dhee dsee8 dvee dwee dee0 dzed{ diee d|ee d}ee d~ee dee dee d#ee d$ee d%ee d&ee dee	 ddf*ddZMddedededddddfdedeeeeddde#e0df dee dee dhee dsee8 dree dee9du  dvee dwee dzed{ diee d|ee d}ee d~ee dee dee d#ee d$ee d%ee d&ee dee	 ddf,ddZNdddddeddedddedddedddfdeeeeedddede9e#edf  dKee dee dee deeO dee dhee dsee8 dee d ee dee dee#ee$f  dee9du  dvee dwee dzed{ diee dee dee9du  d|ee d}ee d~ee dee d#ee d$ee d%ee d&ee dee	 ddf<ddZPdedededdddf
deeeeeddde#eef dgedee dree dee9du  dhee dsee8 dvee dwee dzed{ dee d}ee d~ee dee d#ee d$ee d%ee d&ee dee	 dd	f(d
dZQdedededdddf
deeeeeddd9e#eef dgedee dree dee9du  dhee dsee8 dvee dwee dzed{ dee d}ee d~ee dee d#ee d$ee d%ee d&ee dee	 dd	f(ddZReeddfeeeedd"de#eef de9e dhee dvee dwee dee d#ee d$ee d%ee d&ee dee	 ded fddZSeeddfeeeedd"d9e#eef de9e dhee dvee dwee dee d#ee d$ee d%ee d&ee dee	 ded fddZTeedfeeeedd"de#eef dgedhee dvee dwee d#ee d$ee d%ee d&ee dee	 ddfddZUeedfeeeedd"d9e#eef dgedhee dvee dwee d#ee d$ee d%ee d&ee dee	 ddfddZVeedfeeeedd"de#eef de9e dhee dvee dwee d#ee d$ee d%ee d&ee dee	 ded fddZWeedfeeeedd"d9e#eef de9e dhee dvee dwee d#ee d$ee d%ee d&ee dee	 ded fddZXeeeedd"d#ee d$ee d%ee d&ee dee	 defddZY				dbeeeedd"dee#ee$f  dee dee d ee d#ee d$ee d%ee d&ee dee	 dd!fd"d#ZZ				dbeeeedd"d$e#ed!f dee#ee$f  dee dee d ee d#ee d$ee d%ee d&ee dee	 dd!fd%d&Z[eeeedd"d$e#ed!f d#ee d$ee d%ee d&ee dee	 dd!fd'd(Z\	d_eeeedd"d)ed*edee d#ee d$ee d%ee d&ee dee	 dd!fd+d,Z]	d_eeeedd"d$e#ed!f dee d#ee d$ee d%ee d&ee dee	 dd!fd-d.Z^eeeedd"d.ed#ee d$ee d%ee d&ee dee	 defd/d0Z_eeeedd"d.ed#ee d$ee d%ee d&ee dee	 defd1d2Z`	d_eeeedd"d3eea d#ee d$ee d%ee d&ee dee	 defd4d5Zb		d`eeeedd"ded6ee d7ee d#ee d$ee d%ee d&ee dee	 decfd8d9Zd		d`eeeedd"dwedee d7ee d#ee d$ee d%ee d&ee dee	 defd:d;Zeeeeedd"dwed#ee d$ee d%ee d&ee dee	 defd<d=Zfeeeedd"dwed#ee d$ee d%ee d&ee dee	 defd>d?Zgeeeedd"dwed#ee d$ee d%ee d&ee dee	 defd@dAZheeeedd"dwed#ee d$ee d%ee d&ee dee	 defdBdCZieeeedd"d#ee d$ee d%ee d&ee dee	 defdDdEZjeeeedd"ded#ee d$ee d%ee d&ee dee	 defdFdGZkeeeedd"d#ee d$ee d%ee d&ee dee	 defdHdIZleeeedd"d#ee d$ee d%ee d&ee dee	 defdJdKZmeeeedd"d#ee d$ee d%ee d&ee dee	 defdLdMZneeeedd"d#ee d$ee d%ee d&ee dee	 defdNdOZoeeeedd"d#ee d$ee d%ee d&ee dee	 deafdPdQZpeeeedd"d.ed#ee d$ee d%ee d&ee dee	 ddRfdSdTZq		d`eeeedd"dgedUee#e9e#eref  eref  dVee d#ee d$ee d%ee d&ee dee	 defdWdXZsdeddeedddddfedeeeeddYdZede9d[ dee dree dee9du  dee dhee dvee dzed{ dsee8 diee dee d}ee dee d~ee d#ee d$ee d%ee d&ee dee	 ddf*d\d]Zt  ZuS (c  	_ChatBasezjBase class for :class:`telegram.Chat` and :class:`telegram.ChatFullInfo`.

    .. versionadded:: 21.3
    )
first_nameidis_forum	last_nametitletypeusernameN
api_kwargsr6   r:   r9   r;   r5   r8   r7   r=   c          	         sZ   t  j|d || _ttj||| _|| _|| _	|| _
|| _|| _| jf| _|   d S )Nr<   )super__init__r6   r   
get_memberr	   ChatTyper:   r9   r;   r5   r8   r7   	_id_attrs_freeze)	selfr6   r:   r9   r;   r5   r8   r7   r=   	__class__ G/var/www/html/govbot/env/lib/python3.10/site-packages/telegram/_chat.pyr?   O   s   
z_ChatBase.__init__SENDERPRIVATEGROUP
SUPERGROUPCHANNELreturnc                 C   s$   | j dur| j S | jdur| jS dS )z
        :obj:`str`: Convenience property. Gives :attr:`~Chat.title` if not :obj:`None`,
        else :attr:`~Chat.full_name` if not :obj:`None`.

        .. versionadded:: 20.1
        N)r9   	full_namerD   rG   rG   rH   effective_namex   s
   

z_ChatBase.effective_namec                 C   s(   | j sdS | jr| j  d| j S | j S )a]  
        :obj:`str`: Convenience property. If :attr:`~Chat.first_name` is not :obj:`None`, gives
        :attr:`~Chat.first_name` followed by (if available) :attr:`~Chat.last_name`.

        Note:
            :attr:`full_name` will always be :obj:`None`, if the chat is a (super)group or
            channel.

        .. versionadded:: 13.2
        N )r5   r8   rP   rG   rG   rH   rO      s
   z_ChatBase.full_namec                 C   s   | j r	d| j  S dS )z}:obj:`str`: Convenience property. If the chat has a :attr:`~Chat.username`, returns a
        t.me link of the chat.
        zhttps://t.me/N)r;   rP   rG   rG   rH   link   s   z_ChatBase.linknamec                 C   s   | j | jkr|rt| j|S | jrt| j| jS td| jr=|r+d| d| j dS | jr9d| j d| j dS tdtd)a  
        Note:
            :tg-const:`telegram.constants.ParseMode.MARKDOWN` is a legacy mode, retained by
            Telegram for backward compatibility. You should use :meth:`mention_markdown_v2`
            instead.

        .. versionadded:: 20.0

        Args:
            name (:obj:`str`): The name used as a link for the chat. Defaults to
                :attr:`~Chat.full_name`.

        Returns:
            :obj:`str`: The inline mention for the chat as markdown (version 1).

        Raises:
            :exc:`TypeError`: If the chat is a private chat and neither the :paramref:`name`
                nor the :attr:`~Chat.first_name` is set, then throw an :exc:`TypeError`.
                If the chat is a public chat and neither the :paramref:`name` nor the
                :attr:`~Chat.title` is set, then throw an :exc:`TypeError`. If chat is a
                private group chat, then throw an :exc:`TypeError`.

        =Can not create a mention to a private chat without first name[]()7Can not create a mention to a public chat without title0Can not create a mention to a private group chat)	r:   rJ   helpers_mention_markdownr6   rO   	TypeErrorr;   rS   r9   rD   rT   rG   rG   rH   r      s   z_ChatBase.mention_markdownc                 C   s   | j | jkr |rt| j|ddS | jrt| j| jddS td| jrI|r3dt|dd d| j dS | j	rEdt| j	dd d| j dS tdtd)	a  
        .. versionadded:: 20.0

        Args:
            name (:obj:`str`): The name used as a link for the chat. Defaults to
                :attr:`~Chat.full_name`.

        Returns:
            :obj:`str`: The inline mention for the chat as markdown (version 2).

        Raises:
            :exc:`TypeError`: If the chat is a private chat and neither the :paramref:`name`
                nor the :attr:`~Chat.first_name` is set, then throw an :exc:`TypeError`.
                If the chat is a public chat and neither the :paramref:`name` nor the
                :attr:`~Chat.title` is set, then throw an :exc:`TypeError`. If chat is a
                private group chat, then throw an :exc:`TypeError`.

           )versionrU   rV   rW   rX   rY   rZ   )
r:   rJ   r[   r6   rO   r\   r;   r   rS   r9   r]   rG   rG   rH   mention_markdown_v2   s   z_ChatBase.mention_markdown_v2c                 C   s   | j | jkr|rt| j|S | jrt| j| jS td| jrA|r-d| j dt| dS | j	r=d| j dt| j	 dS tdtd)a  
        .. versionadded:: 20.0

        Args:
            name (:obj:`str`): The name used as a link for the chat. Defaults to :attr:`full_name`.

        Returns:
            :obj:`str`: The inline mention for the chat as HTML.

        Raises:
            :exc:`TypeError`: If the chat is a private chat and neither the :paramref:`name`
                nor the :attr:`~Chat.first_name` is set, then throw an :exc:`TypeError`.
                If the chat is a public chat and neither the :paramref:`name` nor the
                :attr:`~Chat.title` is set, then throw an :exc:`TypeError`.
                If chat is a private group chat, then throw an :exc:`TypeError`.

        rU   z	<a href="z">z</a>rY   rZ   )
r:   rJ   helpers_mention_htmlr6   rO   r\   r;   rS   r   r9   r]   rG   rG   rH   r      s   z_ChatBase.mention_html)read_timeoutwrite_timeoutconnect_timeoutpool_timeoutr=   rb   rc   rd   re   c                   $   |   j| j|||||dI dH S )a  Shortcut for::

             await bot.leave_chat(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.leave_chat`.

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        chat_idrb   rc   rd   re   r=   N)get_bot
leave_chatr6   rD   rb   rc   rd   re   r=   rG   rG   rH   leave     z_ChatBase.leave)r   .c                   rf   )a]  Shortcut for::

             await bot.get_chat_administrators(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.get_chat_administrators`.

        Returns:
            tuple[:class:`telegram.ChatMember`]: A tuple of administrators in a chat. An Array of
            :class:`telegram.ChatMember` objects that contains information about all
            chat administrators except other bots. If the chat is a group or a supergroup
            and no administrators were appointed, only the creator will be returned.

        rg   N)ri   get_chat_administratorsr6   rk   rG   rG   rH   get_administrators$     z_ChatBase.get_administratorsc                   rf   )a	  Shortcut for::

             await bot.get_chat_member_count(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.get_chat_member_count`.

        Returns:
            :obj:`int`
        rg   N)ri   get_chat_member_countr6   rk   rG   rG   rH   get_member_countD  rm   z_ChatBase.get_member_countuser_idr   c             	      &   |   j| j||||||dI dH S )a  Shortcut for::

             await bot.get_chat_member(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.get_chat_member`.

        Returns:
            :class:`telegram.ChatMember`

        rh   rs   rb   rc   rd   re   r=   N)ri   get_chat_memberr6   rD   rs   rb   rc   rd   re   r=   rG   rG   rH   r@   `  s   z_ChatBase.get_memberrevoke_messages
until_datec          	         s*   |   j| j||||||||d	I dH S )a$  Shortcut for::

             await bot.ban_chat_member(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.ban_chat_member`.

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.
        )	rh   rs   rb   rc   rd   re   ry   r=   rx   N)ri   ban_chat_memberr6   )	rD   rs   rx   ry   rb   rc   rd   re   r=   rG   rG   rH   
ban_member~     z_ChatBase.ban_membersender_chat_idc             	      rt   )aW  Shortcut for::

             await bot.ban_chat_sender_chat(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.ban_chat_sender_chat`.

        .. versionadded:: 13.9

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        rh   r}   rb   rc   rd   re   r=   Nri   ban_chat_sender_chatr6   rD   r}   rb   rc   rd   re   r=   rG   rG   rH   ban_sender_chat     z_ChatBase.ban_sender_chatrh   c             	      &   |   j|| j|||||dI dH S )a~  Shortcut for::

             await bot.ban_chat_sender_chat(
                 sender_chat_id=update.effective_chat.id, *args, **kwargs
             )

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.ban_chat_sender_chat`.

        .. versionadded:: 13.9

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        r~   Nr   rD   rh   rb   rc   rd   re   r=   rG   rG   rH   ban_chat     z_ChatBase.ban_chatc             	      rt   )a[  Shortcut for::

             await bot.unban_chat_sender_chat(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.unban_chat_sender_chat`.

        .. versionadded:: 13.9

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        r~   Nri   unban_chat_sender_chatr6   r   rG   rG   rH   unban_sender_chat  r   z_ChatBase.unban_sender_chatc             	      r   )a  Shortcut for::

             await bot.unban_chat_sender_chat(
                 sender_chat_id=update.effective_chat.id, *args, **kwargs
             )

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.unban_chat_sender_chat`.

        .. versionadded:: 13.9

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        r~   Nr   r   rG   rG   rH   
unban_chat  r   z_ChatBase.unban_chatonly_if_bannedc             
      (   |   j| j|||||||dI dH S )a!  Shortcut for::

             await bot.unban_chat_member(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.unban_chat_member`.

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        )rh   rs   rb   rc   rd   re   r=   r   N)ri   unban_chat_memberr6   )rD   rs   r   rb   rc   rd   re   r=   rG   rG   rH   unban_member(  s   z_ChatBase.unban_membercan_change_infocan_post_messagescan_edit_messagescan_delete_messagescan_invite_userscan_restrict_memberscan_pin_messagescan_promote_membersis_anonymouscan_manage_chatcan_manage_video_chatscan_manage_topicscan_post_storiescan_edit_storiescan_delete_storiesc                   s   |   jdi d| jd|d|d|d|d|d|d|d	|d
|	d|d|d|d|d|d|
d|d|d|d|d|d|I dH S )a  Shortcut for::

             await bot.promote_chat_member(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.promote_chat_member`.

        .. versionadded:: 13.2
        .. versionchanged:: 20.0
           The argument ``can_manage_voice_chats`` was renamed to
           :paramref:`~telegram.Bot.promote_chat_member.can_manage_video_chats` in accordance to
           Bot API 6.0.
        .. versionchanged:: 20.6
           The arguments `can_post_stories`, `can_edit_stories` and `can_delete_stories` were
           added.

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        rh   rs   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   r   r   r   r   r   r   r   NrG   )ri   promote_chat_memberr6   )rD   rs   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   promote_memberH  s\   -	

z_ChatBase.promote_memberpermissions use_independent_chat_permissionsc          
         s,   |   j| j|||||||||	d
I dH S )a  Shortcut for::

             await bot.restrict_chat_member(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.restrict_chat_member`.

        .. versionadded:: 13.2

        .. versionadded:: 20.1
            Added :paramref:`~telegram.Bot.restrict_chat_member.use_independent_chat_permissions`.

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        )
rh   rs   r   ry   r   rb   rc   rd   re   r=   N)ri   restrict_chat_memberr6   )
rD   rs   r   ry   r   rb   rc   rd   re   r=   rG   rG   rH   restrict_member  s   z_ChatBase.restrict_memberc             
      (   |   j| j|||||||dI dH S )a  Shortcut for::

             await bot.set_chat_permissions(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.set_chat_permissions`.

        .. versionadded:: 20.1
            Added :paramref:`~telegram.Bot.set_chat_permissions.use_independent_chat_permissions`.

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        )rh   r   r   rb   rc   rd   re   r=   N)ri   set_chat_permissionsr6   )rD   r   r   rb   rc   rd   re   r=   rG   rG   rH   set_permissions  s   z_ChatBase.set_permissionscustom_titlec             
      r   )am  Shortcut for::

             await bot.set_chat_administrator_custom_title(
                 update.effective_chat.id, *args, **kwargs
             )

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.set_chat_administrator_custom_title`.

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        )rh   rs   r   rb   rc   rd   re   r=   N)ri   #set_chat_administrator_custom_titler6   )rD   rs   r   rb   rc   rd   re   r=   rG   rG   rH   set_administrator_custom_title  s   z(_ChatBase.set_administrator_custom_titlephotoc             	      rt   )ak  Shortcut for::

             await bot.set_chat_photo(
                 chat_id=update.effective_chat.id, *args, **kwargs
             )

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.set_chat_photo`.

        .. versionadded:: 20.0

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        )rh   r   rb   rc   rd   re   r=   N)ri   set_chat_photor6   )rD   r   rb   rc   rd   re   r=   rG   rG   rH   	set_photo     z_ChatBase.set_photoc                   rf   )aq  Shortcut for::

             await bot.delete_chat_photo(
                 chat_id=update.effective_chat.id, *args, **kwargs
             )

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.delete_chat_photo`.

        .. versionadded:: 20.0

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        rg   N)ri   delete_chat_photor6   rk   rG   rG   rH   delete_photo"  s   z_ChatBase.delete_photoc             	      rt   )ak  Shortcut for::

             await bot.set_chat_title(
                 chat_id=update.effective_chat.id, *args, **kwargs
             )

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.set_chat_title`.

        .. versionadded:: 20.0

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        )rh   r9   rb   rc   rd   re   r=   N)ri   set_chat_titler6   )rD   r9   rb   rc   rd   re   r=   rG   rG   rH   	set_titleC  r   z_ChatBase.set_titledescriptionc             	      rt   )aw  Shortcut for::

             await bot.set_chat_description(
                 chat_id=update.effective_chat.id, *args, **kwargs
             )

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.set_chat_description`.

        .. versionadded:: 20.0

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        )rh   r   rb   rc   rd   re   r=   N)ri   set_chat_descriptionr6   )rD   r   rb   rc   rd   re   r=   rG   rG   rH   set_descriptionf  r   z_ChatBase.set_description
message_iddisable_notificationbusiness_connection_idc          	         *   |   j| j||||||||d	I dH S )a0  Shortcut for::

              await bot.pin_chat_message(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.pin_chat_message`.

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        )	rh   r   r   rb   rc   rd   re   r=   r   N)ri   pin_chat_messager6   )	rD   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   pin_message  s   z_ChatBase.pin_messagec             
      s(   |   j| j|||||||dI dH S )a4  Shortcut for::

              await bot.unpin_chat_message(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.unpin_chat_message`.

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        )rh   rb   rc   rd   re   r=   r   r   N)ri   unpin_chat_messager6   )rD   r   r   rb   rc   rd   re   r=   rG   rG   rH   unpin_message  s   z_ChatBase.unpin_messagec                   rf   )a>  Shortcut for::

              await bot.unpin_all_chat_messages(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.unpin_all_chat_messages`.

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        rg   N)ri   unpin_all_chat_messagesr6   rk   rG   rG   rH   unpin_all_messages  s   z_ChatBase.unpin_all_messages)reply_to_message_idallow_sending_without_replydisable_web_page_previewrb   rc   rd   re   r=   text
parse_modereply_markupentitiesr*   protect_contentmessage_thread_idlink_preview_optionsr'   reply_parametersr-   message_effect_idallow_paid_broadcastr   r   r   r)   c                   s   |   jdi d| jd|d|d|d|d|d|d|	d	|d
|d|d|d|d|d|d|d|d|d|
d|d|I dH S )a6  Shortcut for::

             await bot.send_message(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.send_message`.

        Returns:
            :class:`telegram.Message`: On success, instance representing the message posted.

        rh   r   r   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   r   r   r   NrG   )ri   send_messager6   )rD   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   r     X   "	

z_ChatBase.send_messagec             	      rt   )a;  Shortcut for::

             await bot.delete_message(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.delete_message`.

        .. versionadded:: 20.8

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        )rh   r   rb   rc   rd   re   r=   N)ri   delete_messager6   )rD   r   rb   rc   rd   re   r=   rG   rG   rH   r   $     z_ChatBase.delete_messagemessage_idsc             	      rt   )a=  Shortcut for::

             await bot.delete_messages(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.delete_messages`.

        .. versionadded:: 20.8

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        )rh   r   rb   rc   rd   re   r=   N)ri   delete_messagesr6   )rD   r   rb   rc   rd   re   r=   rG   rG   rH   r   D  r   z_ChatBase.delete_messages)
r   r   rb   rc   rd   re   r=   captionr   caption_entitiesmedia)r    r!   r"   r#   r   r   )r)   .c	       
            s   |   jdi d| jd|d|d|	d|d|d|d|d	|d
|
d|d|d|d|d|d|d|d|d|I dH S )as  Shortcut for::

             await bot.send_media_group(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.send_media_group`.

        Returns:
            tuple[:class:`telegram.Message`]: On success, a tuple of :class:`~telegram.Message`
            instances that were sent is returned.

        rh   r   r   r   rb   rc   rd   re   r=   r   r   r   r   r   r   r   r   r   r   NrG   )ri   send_media_groupr6   )rD   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   r   r   r   rG   rG   rH   r   d  sP   #	

z_ChatBase.send_media_groupactionc          	         r   )a  Shortcut for::

             await bot.send_chat_action(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.send_chat_action`.

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        )	rh   r   r   rb   rc   rd   re   r=   r   N)ri   send_chat_actionr6   )	rD   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   r     r|   z_ChatBase.send_chat_action)r   r   filenamerb   rc   rd   re   r=   r,   has_spoilershow_caption_above_mediar   c                   s   |   jdi d| jd|d|d|d|d|
d|d|d	|d
|d|d|d|d|d|d|d|d|d|	d|d|d|d|I dH S )a2  Shortcut for::

             await bot.send_photo(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.send_photo`.

        Returns:
            :class:`telegram.Message`: On success, instance representing the message posted.

        rh   r   r   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   r   r   r   r   r   NrG   )ri   
send_photor6   )rD   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   r     `   $	

z_ChatBase.send_photo)r   r   contactrb   rc   rd   re   r=   phone_numbervcardr   r   c                   s   |   jdi d| jd|d|d|d|d|d|	d|d	|d
|d|d|d|d|d|d|d|d|d|
d|d|I dH S )a6  Shortcut for::

             await bot.send_contact(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.send_contact`.

        Returns:
            :class:`telegram.Message`: On success, instance representing the message posted.

        rh   r   r5   r8   r   r   r   r   rb   rc   rd   re   r   r   r=   r   r   r   r   r   r   NrG   )ri   send_contactr6   )rD   r   r5   r8   r   r   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   r      r   z_ChatBase.send_contactaudior   duration	performer	thumbnailc                   s   |   jdi d| jd|d|d|d|d|d|d|d	|d
|d|d|d|	d|d|
d|d|d|d|d|d|d|d|d|d|I dH S )a2  Shortcut for::

             await bot.send_audio(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.send_audio`.

        Returns:
            :class:`telegram.Message`: On success, instance representing the message posted.

        rh   r   r   r   r9   r   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   r   r   r   r   NrG   )ri   
send_audior6   )rD   r   r   r   r9   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   r   :  h   &	

z_ChatBase.send_audiodocumentr   disable_content_type_detectionc                   s   |   jdi d| jd|d|d|d|d|d|d|d	|d
|d|d|d|d|
d|d|d|d|d|d|	d|d|d|I dH S )a8  Shortcut for::

             await bot.send_document(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.send_document`.

        Returns:
            :class:`telegram.Message`: On success, instance representing the message posted.

        rh   r   r   r   r   r   r   r   rb   rc   rd   re   r   r   r=   r   r   r   r   r   r   r   r   NrG   )ri   send_documentr6   )rD   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   r   |  r   z_ChatBase.send_document)r   r   rb   rc   rd   re   r=   emojic
                   s   |   jdi d| jd|d|
d|d|d|d|d|d	|d
|d|d|d|d|d|d|d|	I dH S )a0  Shortcut for::

             await bot.send_dice(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.send_dice`.

        Returns:
            :class:`telegram.Message`: On success, instance representing the message posted.

        rh   r   r   r   r   rb   rc   rd   re   r   r=   r   r   r   r   r   r   NrG   )ri   	send_dicer6   )rD   r   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   r     H   	

z_ChatBase.send_dicegame_short_namer   c
                   s   |   jdi d| jd|d|d|
d|d|d|d|d	|d
|d|d|d|d|d|d|d|	I dH S )a0  Shortcut for::

             await bot.send_game(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.send_game`.

        Returns:
            :class:`telegram.Message`: On success, instance representing the message posted.

        rh   r   r   r   r   r   rb   rc   rd   re   r=   r   r   r   r   r   r   NrG   )ri   	send_gamer6   )rD   r   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   r     r   z_ChatBase.send_gamepayloadprovider_tokencurrencypricesr&   start_parameter	photo_url
photo_sizephoto_widthphoto_height	need_nameneed_phone_number
need_emailneed_shipping_addressis_flexibleprovider_datasend_phone_number_to_providersend_email_to_providermax_tip_amountsuggested_tip_amountsc          $         s   |   jd&i d| jd|d|d|d|d|d|d|d	|d
|	d|
d|d|d|d|d|d|d|d|d|d|d|d|d|d| d|!d|"d|#d|d|d|d |d!|d"|d#|d$|I d%H S )'a  Shortcut for::

             await bot.send_invoice(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.send_invoice`.

        Warning:
            As of API 5.2 :paramref:`start_parameter <telegram.Bot.send_invoice.start_parameter>`
            is an optional argument and therefore the
            order of the arguments had to be changed. Use keyword arguments to make sure that the
            arguments are passed correctly.

        .. versionchanged:: 13.5
            As of Bot API 5.2, the parameter
            :paramref:`start_parameter <telegram.Bot.send_invoice.start_parameter>` is optional.

        Returns:
            :class:`telegram.Message`: On success, instance representing the message posted.

        rh   r9   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   r   r  r  r   r   r   r   r   NrG   )ri   send_invoicer6   )$rD   r9   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r  r  r   r   r   r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   r    s   ;	
 !"#$
z_ChatBase.send_invoice)r   r   locationrb   rc   rd   re   r=   latitude	longitudelive_periodhorizontal_accuracyheadingproximity_alert_radiusr  r(   c                   s   |   jdi d| jd|d|d|d|d|d|d|d	|d
|d|d|d|d|d|d|d|d|d|	d|
d|d|d|I dH S )a8  Shortcut for::

             await bot.send_location(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.send_location`.

        Returns:
            :class:`telegram.Message`: On success, instance representing the message posted.

        rh   r  r  r   r   r   r   rb   rc   rd   re   r  r  r=   r  r	  r
  r   r   r   r   r   r   NrG   )ri   send_locationr6   )rD   r  r  r   r   r  r  r	  r
  r   r   r   r   r   r   r   r   r  rb   rc   rd   re   r=   rG   rG   rH   r    r   z_ChatBase.send_location	animationr   widthheightc                   s   |   jdi d| jd|d|d|d|d|d|d|d	|d
|d|d|d|d|d|d|d|d|	d|d|
d|d|d|d|d|d|d|I dH S )a:  Shortcut for::

             await bot.send_animation(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.send_animation`.

        Returns:
            :class:`telegram.Message`: On success, instance representing the message posted.

        rh   r  r   r  r  r   r   r   r   r   r   rb   rc   rd   re   r=   r   r   r   r   r   r   r   r   r   r   r   NrG   )ri   send_animationr6   )rD   r  r   r  r  r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   r    sp   (	

z_ChatBase.send_animationstickerr.   c                   s   |   jdi d| jd|d|d|d|d|d|d|d	|d
|d|d|d|d|d|d|d|	d|
I dH S )a6  Shortcut for::

             await bot.send_sticker(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.send_sticker`.

        Returns:
            :class:`telegram.Message`: On success, instance representing the message posted.

        rh   r  r   r   r   r   rb   rc   rd   re   r=   r   r   r   r   r   r   r   NrG   )ri   send_stickerr6   )rD   r  r   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   r    sL   	

z_ChatBase.send_sticker)r   r   venuerb   rc   rd   re   r=   addressfoursquare_idfoursquare_typegoogle_place_idgoogle_place_typer  r0   c                   s   |   jdi d| jd|d|d|d|d|d|d|d	|d
|d|d|d|d|d|d|d|d|	d|
d|d|d|d|d|d|I dH S )a2  Shortcut for::

             await bot.send_venue(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.send_venue`.

        Returns:
            :class:`telegram.Message`: On success, instance representing the message posted.

        rh   r  r  r9   r  r  r   r   r   r   rb   rc   rd   re   r  r  r=   r  r  r   r   r   r   r   r   NrG   )ri   
send_venuer6   )rD   r  r  r9   r  r  r   r   r  r  r  r   r   r   r   r   r   r   r   r  rb   rc   rd   re   r=   rG   rG   rH   r  8  r   z_ChatBase.send_venuevideor1   supports_streamingc                   s   |   jdi d| jd|d|d|d|d|d|d|d	|d
|d|d|d|d|d|d|	d|d|d|d|
d|d|d|d|d|d|d|d|I dH S )a2  Shortcut for::

             await bot.send_video(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.send_video`.

        Returns:
            :class:`telegram.Message`: On success, instance representing the message posted.

        rh   r  r   r   r   r   r   r   rb   rc   rd   re   r  r  r   r  r   r=   r   r   r   r   r   r   r   r   r   r   NrG   )ri   
send_videor6   )rD   r  r   r   r   r   r  r  r   r  r   r   r   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   r  z  st   )	

z_ChatBase.send_video
video_noter2   lengthc                   s   |   jdi d| jd|d|d|d|d|d|	d|d	|d
|d|d|d|d|d|d|d|d|d|
d|d|I dH S )a<  Shortcut for::

             await bot.send_video_note(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.send_video_note`.

        Returns:
            :class:`telegram.Message`: On success, instance representing the message posted.

        rh   r  r   r  r   r   r   r   rb   rc   rd   re   r   r=   r   r   r   r   r   r   r   NrG   )ri   send_video_noter6   )rD   r  r   r  r   r   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   r    r   z_ChatBase.send_video_notevoicer3   c                   s   |   jdi d| jd|d|d|d|d|d|
d|d	|d
|d|d|d|d|d|d|d|d|d|	d|d|d|I dH S )a2  Shortcut for::

             await bot.send_voice(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.send_voice`.

        Returns:
            :class:`telegram.Message`: On success, instance representing the message posted.

        rh   r  r   r   r   r   r   r   rb   rc   rd   re   r   r=   r   r   r   r   r   r   r   r   NrG   )ri   
send_voicer6   )rD   r  r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   r     s\   #	

z_ChatBase.send_voicequestionoptionsr%   allows_multiple_answerscorrect_option_id	is_closedexplanationexplanation_parse_modeopen_period
close_dateexplanation_entitiesquestion_parse_modequestion_entitiesc                   s   |   jd i d| jd|d|d|d|d|d|d|d	|d
|d|d|	d|d|d|d|d|d|d|
d|d|d|d|d|d|d|d|d|d|d|I dH S )!a0  Shortcut for::

             await bot.send_poll(update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.send_poll`.

        Returns:
            :class:`telegram.Message`: On success, instance representing the message posted.

        rh   r!  r"  r   r:   r#  r$  r%  r   r   r   r   rb   rc   rd   re   r   r   r&  r'  r(  r)  r=   r   r*  r   r   r   r+  r,  NrG   )ri   	send_pollr6   )rD   r!  r"  r   r:   r#  r$  r%  r   r   r&  r'  r(  r)  r*  r   r   r   r   r+  r,  r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   r-  8  s|   +	

z_ChatBase.send_pollfrom_chat_idr+   c                      |   jdi d| jd|d|d|d|d|d|d|d	|
d
|d|d|d|d|d|d|d|d|	d|d|I dH S )a  Shortcut for::

             await bot.copy_message(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.copy_message`.

        .. seealso:: :meth:`copy_message`, :meth:`send_copies`, :meth:`copy_messages`.

        Returns:
            :class:`telegram.Message`: On success, instance representing the message posted.

        rh   r.  r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   r   r   r   r   NrG   ri   copy_messager6   )rD   r.  r   r   r   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   	send_copy  T   #	

z_ChatBase.send_copyc                   r/  )a  Shortcut for::

             await bot.copy_message(from_chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.copy_message`.

        .. seealso:: :meth:`send_copy`, :meth:`send_copies`, :meth:`copy_messages`.

        Returns:
            :class:`telegram.MessageId`: On success, returns the MessageId of the sent message.

        r.  rh   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   r   r   r   r   NrG   r0  )rD   rh   r   r   r   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   r1    r3  z_ChatBase.copy_messageremove_caption)r+   .c                   0   |   j| j|||||||||	|
|dI dH S )a  Shortcut for::

             await bot.copy_messages(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.copy_messages`.

        .. seealso:: :meth:`copy_message`, :meth:`send_copy`, :meth:`copy_messages`.

        .. versionadded:: 20.8

        Returns:
            tuple[:class:`telegram.MessageId`]: On success, a tuple of :class:`~telegram.MessageId`
            of the sent messages is returned.

        )rh   r.  r   r   r   r   r4  rb   rc   rd   re   r=   Nri   copy_messagesr6   )rD   r.  r   r   r   r   r4  rb   rc   rd   re   r=   rG   rG   rH   send_copies     z_ChatBase.send_copiesc                   r5  )a  Shortcut for::

             await bot.copy_messages(from_chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.copy_messages`.

        .. seealso:: :meth:`copy_message`, :meth:`send_copy`, :meth:`send_copies`.

        .. versionadded:: 20.8

        Returns:
            tuple[:class:`telegram.MessageId`]: On success, a tuple of :class:`~telegram.MessageId`
            of the sent messages is returned.

        )r.  rh   r   r   r   r   r4  rb   rc   rd   re   r=   Nr6  )rD   rh   r   r   r   r   r4  rb   rc   rd   re   r=   rG   rG   rH   r7  %	  r9  z_ChatBase.copy_messagesc                   .   |   j| j|||||||	|
||dI dH S )a  Shortcut for::

             await bot.forward_message(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.forward_message`.

        .. seealso:: :meth:`forward_to`, :meth:`forward_messages_from`, :meth:`forward_messages_to`

        .. versionadded:: 20.0

        Returns:
            :class:`telegram.Message`: On success, instance representing the message posted.

        )rh   r.  r   r   rb   rc   rd   re   r=   r   r   Nri   forward_messager6   )rD   r.  r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   forward_fromR	  s   z_ChatBase.forward_fromc                   r:  )a  Shortcut for::

             await bot.forward_message(from_chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.forward_message`.

        .. seealso:: :meth:`forward_from`, :meth:`forward_messages_from`,
            :meth:`forward_messages_to`

        .. versionadded:: 20.0

        Returns:
            :class:`telegram.Message`: On success, instance representing the message posted.

        )r.  rh   r   r   rb   rc   rd   re   r=   r   r   Nr;  )rD   rh   r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   
forward_to|	     z_ChatBase.forward_toc                   .   |   j| j|||||||||	|
dI dH S )a  Shortcut for::

             await bot.forward_messages(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.forward_messages`.

        .. seealso:: :meth:`forward_to`, :meth:`forward_from`, :meth:`forward_messages_to`.

        .. versionadded:: 20.8

        Returns:
            tuple[:class:`telegram.MessageId`]: On success, a tuple of :class:`~telegram.MessageId`
            of sent messages is returned.

        )rh   r.  r   r   r   r   rb   rc   rd   re   r=   Nri   forward_messagesr6   )rD   r.  r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   forward_messages_from	  r?  z_ChatBase.forward_messages_fromc                   r@  )a  Shortcut for::

             await bot.forward_messages(from_chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see :meth:`telegram.Bot.forward_messages`.

        .. seealso:: :meth:`forward_from`, :meth:`forward_to`, :meth:`forward_messages_from`.

        .. versionadded:: 20.8

        Returns:
            tuple[:class:`telegram.MessageId`]: On success, a tuple of :class:`~telegram.MessageId`
            of sent messages is returned.

        )r.  rh   r   r   r   r   rb   rc   rd   re   r=   NrA  )rD   rh   r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   forward_messages_to	  r?  z_ChatBase.forward_messages_toc                   rf   )aS  Shortcut for::

             await bot.export_chat_invite_link(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.export_chat_invite_link`.

        .. versionadded:: 13.4

        Returns:
            :obj:`str`: New invite link on success.

        rg   N)ri   export_chat_invite_linkr6   rk   rG   rG   rH   export_invite_link	     z_ChatBase.export_invite_linkexpire_datemember_limitcreates_join_requestr   c          
         s,   |   j| j|||||||	||d
I dH S )a  Shortcut for::

             await bot.create_chat_invite_link(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.create_chat_invite_link`.

        .. versionadded:: 13.4

        .. versionchanged:: 13.8
           Edited signature according to the changes of
           :meth:`telegram.Bot.create_chat_invite_link`.

        Returns:
            :class:`telegram.ChatInviteLink`

        )
rh   rH  rI  rb   rc   rd   re   r=   rT   rJ  N)ri   create_chat_invite_linkr6   )
rD   rH  rI  rT   rJ  rb   rc   rd   re   r=   rG   rG   rH   create_invite_link
  s   z_ChatBase.create_invite_linkinvite_linkc                   r:  )a  Shortcut for::

             await bot.edit_chat_invite_link(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.edit_chat_invite_link`.

        .. versionadded:: 13.4

        .. versionchanged:: 13.8
           Edited signature according to the changes of :meth:`telegram.Bot.edit_chat_invite_link`.

        Returns:
            :class:`telegram.ChatInviteLink`

        )rh   rM  rH  rI  rb   rc   rd   re   r=   rT   rJ  N)ri   edit_chat_invite_linkr6   )rD   rM  rH  rI  rT   rJ  rb   rc   rd   re   r=   rG   rG   rH   edit_invite_linkG
  s   z_ChatBase.edit_invite_linkc             	      rt   )aL  Shortcut for::

             await bot.revoke_chat_invite_link(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.revoke_chat_invite_link`.

        .. versionadded:: 13.4

        Returns:
            :class:`telegram.ChatInviteLink`

        )rh   rM  rb   rc   rd   re   r=   N)ri   revoke_chat_invite_linkr6   )rD   rM  rb   rc   rd   re   r=   rG   rG   rH   revoke_invite_links
  r   z_ChatBase.revoke_invite_linksubscription_periodsubscription_pricec          	         *   |   j| j||||||||d	I dH S )a  Shortcut for::

            await bot.create_chat_subscription_invite_link(
                chat_id=update.effective_chat.id, *args, **kwargs
            )

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.create_chat_subscription_invite_link`.

        .. versionadded:: 21.5

        Returns:
            :class:`telegram.ChatInviteLink`
        )	rh   rR  rS  rT   rb   rc   rd   re   r=   N)ri   $create_chat_subscription_invite_linkr6   )	rD   rR  rS  rT   rb   rc   rd   re   r=   rG   rG   rH   create_subscription_invite_link
  s   z)_ChatBase.create_subscription_invite_linkc             
      r   )a  Shortcut for::

            await bot.edit_chat_subscription_invite_link(
                chat_id=update.effective_chat.id, *args, **kwargs
            )

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.edit_chat_subscription_invite_link`.

        .. versionadded:: 21.5

        Returns:
            :class:`telegram.ChatInviteLink`

        )rh   rM  rb   rc   rd   re   r=   rT   N)ri   "edit_chat_subscription_invite_linkr6   )rD   rM  rT   rb   rc   rd   re   r=   rG   rG   rH   edit_subscription_invite_link
  s   z'_ChatBase.edit_subscription_invite_linkc             	      rt   )aa  Shortcut for::

             await bot.approve_chat_join_request(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.approve_chat_join_request`.

        .. versionadded:: 13.8

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        ru   N)ri   approve_chat_join_requestr6   rw   rG   rG   rH   approve_join_request
  r   z_ChatBase.approve_join_requestc             	      rt   )aa  Shortcut for::

             await bot.decline_chat_join_request(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.decline_chat_join_request`.

        .. versionadded:: 13.8

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.

        ru   N)ri   decline_chat_join_requestr6   rw   rG   rG   rH   decline_join_request   r   z_ChatBase.decline_join_requestmenu_buttonc             	      rt   )a  Shortcut for::

             await bot.set_chat_menu_button(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.set_chat_menu_button`.

        Caution:
            Can only work, if the chat is a private chat.

        .. seealso:: :meth:`get_menu_button`

        .. versionadded:: 20.0

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.
        )rh   r]  rb   rc   rd   re   r=   N)ri   set_chat_menu_buttonr6   )rD   r]  rb   rc   rd   re   r=   rG   rG   rH   set_menu_button!  s   z_ChatBase.set_menu_button
icon_coloricon_custom_emoji_idc          	         rT  )a=  Shortcut for::

             await bot.create_forum_topic(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.create_forum_topic`.

        .. versionadded:: 20.0

        Returns:
            :class:`telegram.ForumTopic`
        )	rh   rT   r`  ra  rb   rc   rd   re   r=   N)ri   create_forum_topicr6   )	rD   rT   r`  ra  rb   rc   rd   re   r=   rG   rG   rH   rb  F     z_ChatBase.create_forum_topicc          	         rT  )aN  Shortcut for::

             await bot.edit_forum_topic(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.edit_forum_topic`.

        .. versionadded:: 20.0

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.
        )	rh   r   rT   ra  rb   rc   rd   re   r=   N)ri   edit_forum_topicr6   )	rD   r   rT   ra  rb   rc   rd   re   r=   rG   rG   rH   rd  j  rc  z_ChatBase.edit_forum_topicc             	      rt   )aP  Shortcut for::

             await bot.close_forum_topic(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.close_forum_topic`.

        .. versionadded:: 20.0

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.
        rh   r   rb   rc   rd   re   r=   N)ri   close_forum_topicr6   rD   r   rb   rc   rd   re   r=   rG   rG   rH   rf    r   z_ChatBase.close_forum_topicc             	      rt   )aR  Shortcut for::

             await bot.reopen_forum_topic(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.reopen_forum_topic`.

        .. versionadded:: 20.0

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.
        re  N)ri   reopen_forum_topicr6   rg  rG   rG   rH   rh    r   z_ChatBase.reopen_forum_topicc             	      rt   )aR  Shortcut for::

             await bot.delete_forum_topic(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.delete_forum_topic`.

        .. versionadded:: 20.0

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.
        re  N)ri   delete_forum_topicr6   rg  rG   rG   rH   ri    r   z_ChatBase.delete_forum_topicc             	      rt   )az  Shortcut for::

             await bot.unpin_all_forum_topic_messages(chat_id=update.effective_chat.id,
                *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.unpin_all_forum_topic_messages`.

        .. versionadded:: 20.0

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.
        re  N)ri   unpin_all_forum_topic_messagesr6   rg  rG   rG   rH   rj    r   z(_ChatBase.unpin_all_forum_topic_messagesc                   rf   )a  Shortcut for::

             await bot.unpin_all_general_forum_topic_messages(chat_id=update.effective_chat.id,
                *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.unpin_all_general_forum_topic_messages`.

        .. versionadded:: 20.5

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.
        rg   N)ri   &unpin_all_general_forum_topic_messagesr6   rk   rG   rG   rH   rk    rG  z0_ChatBase.unpin_all_general_forum_topic_messagesc             	      rt   )a}  Shortcut for::

             await bot.edit_general_forum_topic(
                chat_id=update.effective_chat.id, *args, **kwargs
             )

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.edit_general_forum_topic`.

        .. versionadded:: 20.0

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.
        )rh   rT   rb   rc   rd   re   r=   N)ri   edit_general_forum_topicr6   )rD   rT   rb   rc   rd   re   r=   rG   rG   rH   rl  .  s   z"_ChatBase.edit_general_forum_topicc                   rf   )a`  Shortcut for::

             await bot.close_general_forum_topic(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.close_general_forum_topic`.

        .. versionadded:: 20.0

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.
        rg   N)ri   close_general_forum_topicr6   rk   rG   rG   rH   rm  P     z#_ChatBase.close_general_forum_topicc                   rf   )a  Shortcut for::

             await bot.reopen_general_forum_topic(
                chat_id=update.effective_chat.id, *args, **kwargs
             )

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.reopen_general_forum_topic`.

        .. versionadded:: 20.0

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.
        rg   N)ri   reopen_general_forum_topicr6   rk   rG   rG   rH   ro  n  rp   z$_ChatBase.reopen_general_forum_topicc                   rf   )a^  Shortcut for::

             await bot.hide_general_forum_topic(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.hide_general_forum_topic`.

        .. versionadded:: 20.0

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.
        rg   N)ri   hide_general_forum_topicr6   rk   rG   rG   rH   rp    rn  z"_ChatBase.hide_general_forum_topicc                   rf   )a  Shortcut for::

             await bot.unhide_general_forum_topic (
                chat_id=update.effective_chat.id, *args, **kwargs
             )

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.unhide_general_forum_topic`.

        .. versionadded:: 20.0

        Returns:
            :obj:`bool`: On success, :obj:`True` is returned.
        rg   N)ri   unhide_general_forum_topicr6   rk   rG   rG   rH   rq    rp   z$_ChatBase.unhide_general_forum_topicc                   rf   )a  Shortcut for::

             await bot.get_chat_menu_button(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.get_chat_menu_button`.

        Caution:
            Can only work, if the chat is a private chat.

        .. seealso:: :meth:`set_menu_button`

        .. versionadded:: 20.0

        Returns:
            :class:`telegram.MenuButton`: On success, the current menu button is returned.
        rg   N)ri   get_chat_menu_buttonr6   rk   rG   rG   rH   get_menu_button  s   z_ChatBase.get_menu_buttonr/   c             	      s&   |   j| j||||||dI dH S )az  Shortcut for::

             await bot.get_user_chat_boosts(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.get_user_chat_boosts`.

        .. versionadded:: 20.8

        Returns:
            :class:`telegram.UserChatBoosts`: On success, returns the boosts applied in the chat.
        )rh   rs   r=   rb   rc   rd   re   N)ri   get_user_chat_boostsr6   rw   rG   rG   rH   rt    r   z_ChatBase.get_user_chat_boostsreactionis_bigc          	         rT  )aU  Shortcut for::

             await bot.set_message_reaction(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.set_message_reaction`.

        .. versionadded:: 20.8

        Returns:
            :obj:`bool` On success, :obj:`True` is returned.
        )	rh   r   ru  rv  rb   rc   rd   re   r=   N)ri   set_message_reactionr6   )	rD   r   ru  rv  rb   rc   rd   re   r=   rG   rG   rH   rw    rc  z_ChatBase.set_message_reaction)r   r   rb   rc   rd   re   r=   
star_countr$   c                   s   |   jdi d| jd|d|d|d|d|d|d|d	|d
|	d|
d|d|d|d|d|d|d|d|d|d|I dH S )ak  Shortcut for::

             await bot.send_paid_media(chat_id=update.effective_chat.id, *args, **kwargs)

        For the documentation of the arguments, please see
        :meth:`telegram.Bot.send_paid_media`.

        .. versionadded:: 21.4

        Returns:
            :class:`telegram.Message`: On success, instance representing the message posted.
        rh   rx  r   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   r   r   r   NrG   )ri   send_paid_mediar6   )rD   rx  r   r   r   r   r   r   r   r   r   r   r   r   r   r   rb   rc   rd   re   r=   rG   rG   rH   ry  3  sX   $	

z_ChatBase.send_paid_media)NNNNN)N)NN)NNNNNNNNNNNNNNN)NNNN)v__name__
__module____qualname____doc__	__slots__intstrr   boolr   r?   r	   rA   rI   r   __annotations__rJ   rK   rL   rM   propertyrQ   rO   rS   r   r`   r   r   r   floatrl   tuplero   rr   r@   r   r   r{   r   r   r   r   r   r   r
   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   send_actionr   r   r   r   r   r   objectr  r  r  r  r  r  r  r   r   r-  r2  r1  r8  r7  r=  r>  rC  rD  rF  rL  rO  rQ  rV  rX  rZ  r\  r   r_  r   rb  rd  rf  rh  ri  rj  rk  rl  rm  ro  rp  rq  rs  rt  r   rw  ry  __classcell__rG   rG   rE   rH   r4   G   s  
 

&!#

#
 	
!	

&	
%
	
'	
%
	
&	

#	

J	

-	

)	

'	
&
%	
%	
&	

%	

$
 
	

>	
$	
%	


<	

"

	

@	

=
	


E

	

@	

5	

:	

 !"#$%&
d	

A
	


I
	

6	

E
	


K
	

=

	

@	


 P

	
>

	
>	
	
1	
	
1
	
.
	
/
	
/
	
.!	
.	
0	%	
)	
)	%	#	(	
'	
(	$	$	$	$#	%!#!#'	#	
(

	
r4   c                   @   s   e Zd ZdZdZdS )ChataN
  This object represents a chat.

    Objects of this class are comparable in terms of equality. Two objects of this class are
    considered equal, if their :attr:`id` is equal.

    .. versionchanged:: 20.0

        * Removed the deprecated methods ``kick_member`` and ``get_members_count``.
        * The following are now keyword-only arguments in Bot methods:
          ``location``, ``filename``, ``contact``, ``{read, write, connect, pool}_timeout``,
          ``api_kwargs``. Use a named argument for those,
          and notice that some positional arguments changed position as a result.

    .. versionchanged:: 20.0
        Removed the attribute ``all_members_are_administrators``. As long as Telegram provides
        this field for backwards compatibility, it is available through
        :attr:`~telegram.TelegramObject.api_kwargs`.

    .. versionchanged:: 21.3
        As per Bot API 7.3, most of the arguments and attributes of this class have now moved to
        :class:`telegram.ChatFullInfo`.

    Args:
        id (:obj:`int`): Unique identifier for this chat.
        type (:obj:`str`): Type of chat, can be either :attr:`PRIVATE`, :attr:`GROUP`,
            :attr:`SUPERGROUP` or :attr:`CHANNEL`.
        title (:obj:`str`, optional): Title, for supergroups, channels and group chats.
        username (:obj:`str`, optional): Username, for private chats, supergroups and channels if
            available.
        first_name (:obj:`str`, optional): First name of the other party in a private chat.
        last_name (:obj:`str`, optional): Last name of the other party in a private chat.
        is_forum (:obj:`bool`, optional): :obj:`True`, if the supergroup chat is a forum
            (has topics_ enabled).

            .. versionadded:: 20.0

    Attributes:
        id (:obj:`int`): Unique identifier for this chat.
        type (:obj:`str`): Type of chat, can be either :attr:`PRIVATE`, :attr:`GROUP`,
            :attr:`SUPERGROUP` or :attr:`CHANNEL`.
        title (:obj:`str`): Optional. Title, for supergroups, channels and group chats.
        username (:obj:`str`): Optional. Username, for private chats, supergroups and channels if
            available.
        first_name (:obj:`str`): Optional. First name of the other party in a private chat.
        last_name (:obj:`str`): Optional. Last name of the other party in a private chat.
        is_forum (:obj:`bool`): Optional. :obj:`True`, if the supergroup chat is a forum
            (has topics_ enabled).

            .. versionadded:: 20.0

    .. _topics: https://telegram.org/blog/topics-in-groups-collectible-usernames#topics-in-groups
    rG   N)rz  r{  r|  r}  r~  rG   rG   rG   rH   r  p  s    5r  N)Dr}  collections.abcr   r   htmlr   typingr   r   r   r   telegramr	   telegram._chatpermissionsr
   telegram._forumtopicr   telegram._menubuttonr   telegram._reactionr   telegram._telegramobjectr   telegram._utilsr   telegram._utils.defaultvaluer   telegram._utils.typesr   r   r   r   r   telegram.helpersr   r   ra   r   r[   r   r   r   r   r   r   r   r    r!   r"   r#   r$   r%   r&   r'   r(   r)   r*   r+   r,   r-   r.   r/   r0   r1   r2   r3   r4   r  rG   rG   rG   rH   <module>   s^   t                          C