
    i1"                         d Z ddl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 dd
lmZ ddlmZmZ erddlmZ  G d de
          ZdS )zJThis module contains an object that represents a Telegram ChatJoinRequest.    N)TYPE_CHECKING)Chat)ChatInviteLink)TelegramObject)User)de_json_optional)extract_tzinfo_from_defaultsfrom_timestamp)DEFAULT_NONE)JSONDictODVInput)Botc                   ^    e Zd ZdZdZ	 	 ddddededej        de	d	e
dz  d
edz  dedz  f fdZeddedddd f fd            Zeeeedddee         dee         dee         dee         dedz  defdZeeeedddee         dee         dee         dee         dedz  defdZ xZS )ChatJoinRequestaE  This object represents a join request sent to a chat.

    Objects of this class are comparable in terms of equality. Two objects of this class are
    considered equal, if their :attr:`chat`, :attr:`from_user` and :attr:`date` are equal.

    Note:
        * Since Bot API 5.5, bots are allowed to contact users who sent a join request to a chat
          where the bot is an administrator with the
          :attr:`~telegram.ChatMemberAdministrator.can_invite_users` administrator right - even
          if the user never interacted with the bot before.
        * Telegram does not guarantee that :attr:`from_user.id <from_user>` coincides with the
          ``chat_id`` of the user. Please use :attr:`user_chat_id` to contact the user in
          response to their join request.

    .. versionadded:: 13.8
    .. versionchanged:: 20.1
       In Bot API 6.5 the argument :paramref:`user_chat_id` was added, which changes the position
       of the optional arguments :paramref:`bio` and :paramref:`invite_link`.

    Args:
        chat (:class:`telegram.Chat`): Chat to which the request was sent.
        from_user (:class:`telegram.User`): User that sent the join request.
        date (:class:`datetime.datetime`): Date the request was sent.

            .. versionchanged:: 20.3
                |datetime_localization|
        user_chat_id (:obj:`int`): Identifier of a private chat with the user who sent the join
            request. This number may have more than 32 significant bits and some programming
            languages may have difficulty/silent defects in interpreting it. But it has at most 52
            significant bits, so a 64-bit integer or double-precision float type are safe for
            storing this identifier. The bot can use this identifier for 5 minutes to send messages
            until the join request is processed, assuming no other administrator contacted the
            user.

            .. versionadded:: 20.1
        bio (:obj:`str`, optional): Bio of the user.
        invite_link (:class:`telegram.ChatInviteLink`, optional): Chat invite link that was used
            by the user to send the join request.

    Attributes:
        chat (:class:`telegram.Chat`): Chat to which the request was sent.
        from_user (:class:`telegram.User`): User that sent the join request.
        date (:class:`datetime.datetime`): Date the request was sent.

            .. versionchanged:: 20.3
                |datetime_localization|
        user_chat_id (:obj:`int`): Identifier of a private chat with the user who sent the join
            request. This number may have more than 32 significant bits and some programming
            languages may have difficulty/silent defects in interpreting it. But it has at most 52
            significant bits, so a 64-bit integer or double-precision float type are safe for
            storing this identifier. The bot can use this identifier for 5 minutes to send messages
            until the join request is processed, assuming no other administrator contacted the
            user.

            .. versionadded:: 20.1
        bio (:obj:`str`): Optional. Bio of the user.
        invite_link (:class:`telegram.ChatInviteLink`): Optional. Chat invite link that was used
            by the user to send the join request.

            Note:
                When a user joins a *public* group via an invite link, this attribute may not
                be present. However, this behavior is undocument and may be subject to change.
                See `this GitHub thread <https://github.com/tdlib/telegram-bot-api/issues/428>`_
                for some discussion.

    )biochatdate	from_userinvite_linkuser_chat_idN
api_kwargsr   r   r   r   r   r   r   c                    t                                          |           || _        || _        || _        || _        || _        || _        | j        | j        | j        f| _        | 	                                 d S )Nr   )
super__init__r   r   r   r   r   r   	_id_attrs_freeze)	selfr   r   r   r   r   r   r   	__class__s	           Y/Users/shanyulin/my-agent/.venv/lib/python3.11/site-packages/telegram/_chatjoinrequest.pyr   zChatJoinRequest.__init__k   ss     	J///	("&	!-  #2=)T^TY?    databotz
Bot | Nonereturnc                    |                      |          }t          |          }t          |                    d          t          |          |d<   t          |                    dd          t          |          |d<   t          |                    dd          |          |d<   t          |                    d          t          |          |d<   t                      
                    ||          S )	z,See :meth:`telegram.TelegramObject.de_json`.r   fromNr   r   )tzinfor   )r"   r#   )_parse_datar	   r   getr   popr   r
   r   r   de_json)clsr"   r#   
loc_tzinfor   s       r    r+   zChatJoinRequest.de_json   s     t$$ 2#66
'(8(8$DDV,TXXfd-C-CT3OO[%dhhvt&<&<ZPPPV.txx/F/FX[\\]wwDc222r!   )read_timeoutwrite_timeoutconnect_timeoutpool_timeoutr   r.   r/   r0   r1   c          	         K   |                                                      | j        j        | j        j        |||||           d{V S )a  Shortcut for::

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

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

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

        chat_iduser_idr.   r/   r0   r1   r   N)get_botapprove_chat_join_requestr   idr   r   r.   r/   r0   r1   r   s         r    approvezChatJoinRequest.approve   i      , \\^^==ILN%%'+%! > 
 
 
 
 
 
 
 
 	
r!   c          	         K   |                                                      | j        j        | j        j        |||||           d{V S )a  Shortcut for::

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

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

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

        r3   N)r6   decline_chat_join_requestr   r8   r   r9   s         r    declinezChatJoinRequest.decline   r;   r!   )NN)N)__name__
__module____qualname____doc__	__slots__r   r   dtmdatetimeintstrr   r   r   classmethodr+   r   r   floatboolr:   r>   __classcell__)r   s   @r    r   r   %   s       A AF TI -1 '+    l	
  4Z $d* tO     4 3 38 3, 3BS 3 3 3 3 3 [3" )5)5+7(4&*
 
 
 uo
  	

 "%
 uo
 tO
 

 
 
 
F )5)5+7(4&*
 
 
 uo
  	

 "%
 uo
 tO
 

 
 
 
 
 
 
 
r!   r   )rB   rE   rD   typingr   telegram._chatr   telegram._chatinvitelinkr   telegram._telegramobjectr   telegram._userr   telegram._utils.argumentparsingr   telegram._utils.datetimer	   r
   telegram._utils.defaultvaluer   telegram._utils.typesr   r   telegramr   r    r!   r    <module>rW      s   & Q P                       3 3 3 3 3 3 3 3 3 3 3 3       < < < < < < Q Q Q Q Q Q Q Q 5 5 5 5 5 5 4 4 4 4 4 4 4 4 m
 m
 m
 m
 m
n m
 m
 m
 m
 m
r!   