o
    Zzjc  ã                   @   sz   d Z ddlmZ ddlmZ ddlmZmZmZ ddl	m
Z
 ddlmZmZ ddlmZmZ G dd	„ d	e
eeef ƒZd
S )z6This module contains the ChatJoinRequestHandler class.é    )ÚUpdate)ÚDEFAULT_TRUE)ÚRTÚSCTÚDVType)ÚBaseHandler)Úparse_chat_idÚparse_username)ÚCCTÚHandlerCallbackc                       sr   e Zd ZdZdZddefdddeeee	f de
e dB de
e dB d	ee f
‡ fd
d„Zdedefdd„Z‡  ZS )ÚChatJoinRequestHandlera  Handler class to handle Telegram updates that contain
    :attr:`telegram.Update.chat_join_request`.

    Note:
        If neither of :paramref:`username` and the :paramref:`chat_id` are passed, this handler
        accepts *any* join request. Otherwise, this handler accepts all requests to join chats
        for which the chat ID is listed in :paramref:`chat_id` or the username is listed in
        :paramref:`username`, or both.

        .. versionadded:: 20.0

    Warning:
        When setting :paramref:`block` to :obj:`False`, you cannot rely on adding custom
        attributes to :class:`telegram.ext.CallbackContext`. See its docs for more info.

    .. versionadded:: 13.8

    Args:
        callback (:term:`coroutine function`): The callback function for this handler. Will be
            called when :meth:`check_update` has determined that an update should be processed by
            this handler. Callback signature::

                async def callback(update: Update, context: CallbackContext)

            The return value of the callback is usually ignored except for the special case of
            :class:`telegram.ext.ConversationHandler`.
        chat_id (:obj:`int` | Collection[:obj:`int`], optional): Filters requests to allow only
            those which are asking to join the specified chat ID(s).

            .. versionadded:: 20.0
        username (:obj:`str` | Collection[:obj:`str`], optional): Filters requests to allow only
            those which are asking to join the specified username(s).

            .. versionadded:: 20.0
        block (:obj:`bool`, optional): Determines whether the return value of the callback should
            be awaited before processing the next handler in
            :meth:`telegram.ext.Application.process_update`. Defaults to :obj:`True`.

            .. seealso:: :wiki:`Concurrency`

    Attributes:
        callback (:term:`coroutine function`): The callback function for this handler.
        block (:obj:`bool`): Determines whether the callback will run in a blocking way..

    )Ú	_chat_idsÚ
_usernamesNÚselfzChatJoinRequestHandler[CCT, RT]ÚcallbackÚchat_idÚusernameÚblockc                    s(   t ƒ j||d� t|ƒ| _t|ƒ| _d S )N)r   )ÚsuperÚ__init__r   r   r	   r   )r   r   r   r   r   ©Ú	__class__© úh/var/www/kodo/tsheker/venv/lib/python3.10/site-packages/telegram/ext/_handlers/chatjoinrequesthandler.pyr   Q   s   
zChatJoinRequestHandler.__init__ÚupdateÚreturnc                 C   sH   t |tƒr"|jr"| js| jsdS |jjj| jv rdS |jjj| jv S dS )zäDetermines whether an update should be passed to this handler's :attr:`callback`.

        Args:
            update (:class:`telegram.Update` | :obj:`object`): Incoming update.

        Returns:
            :obj:`bool`

        TF)	Ú
isinstancer   Úchat_join_requestr   r   ÚchatÚidÚ	from_userr   )r   r   r   r   r   Úcheck_update]   s   
z#ChatJoinRequestHandler.check_update)Ú__name__Ú
__module__Ú__qualname__Ú__doc__Ú	__slots__r   r   r   r
   r   r   ÚintÚstrr   Úboolr   Úobjectr!   Ú__classcell__r   r   r   r   r      s$    .ûÿþ
ý
üûr   N)r%   Útelegramr   Útelegram._utils.defaultvaluer   Útelegram._utils.typesr   r   r   Ú"telegram.ext._handlers.basehandlerr   Ú#telegram.ext._utils._update_parsingr   r	   Útelegram.ext._utils.typesr
   r   r   r   r   r   r   Ú<module>   s   