o
    Zzj1"  ã                   @   s¤   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rHddlmZ G d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                       s  e Zd ZdZdZ		dddœdededejde	d	e
dB d
edB dedB f‡ fdd„Zeddedddd f‡ fdd„ƒZeeeeddœdee dee dee dee dedB 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dB defdd„Z‡  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                   sP   t ƒ j|d� || _|| _|| _|| _|| _|| _| 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__© úT/var/www/kodo/tsheker/venv/lib/python3.10/site-packages/telegram/_chatjoinrequest.pyr   k   s   zChatJoinRequest.__init__ÚdataÚbotz
Bot | NoneÚreturnc                    s~   |   |¡}t|ƒ}t| d¡t|ƒ|d< t| dd¡t|ƒ|d< t| dd¡|d�|d< t| d¡t|ƒ|d< t	ƒ j
||d�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   r   r   r(   …   s   
zChatJoinRequest.de_json)Úread_timeoutÚwrite_timeoutÚconnect_timeoutÚpool_timeoutr   r+   r,   r-   r.   c             	   Ã   ó,   �|   ¡ j| jj| jj|||||d�I dH 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,   r-   r.   r   N)Úget_botÚapprove_chat_join_requestr   Úidr   ©r   r+   r,   r-   r.   r   r   r   r   Úapprove”   ó   €ùzChatJoinRequest.approvec             	   Ã   r/   )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.

        r0   N)r3   Údecline_chat_join_requestr   r5   r   r6   r   r   r   Údecline´   r8   zChatJoinRequest.decline)NN)N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__Ú	__slots__r   r   ÚdtmÚdatetimeÚintÚstrr   r   r   Úclassmethodr(   r
   r   ÚfloatÚboolr7   r:   Ú__classcell__r   r   r   r   r   %   sx    Cù	÷þýüûúù	÷ùýüûúù
ø#ùýüûúùør   )r>   rA   r@   Ú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   r   r   Ú<module>   s   