
    ՟f                     v    d Z ddlmZmZ ddlmZ ddlmZ ddlm	Z	m
Z
 ddlmZmZmZ  G d deeeef         Zy	)
z0This module contains the ChatBoostHandler class.    )FinalOptional)Update)BaseHandler)parse_chat_idparse_username)CCTRTHandlerCallbackc                        e Zd ZU dZdZdZee   ed<   	 dZ	ee   ed<   	 dZ
ee   ed<   	 ed	d	d
fdddeeeef   dedee   dee   def fdZdedefdZ xZS )ChatBoostHandlera~  
    Handler class to handle Telegram updates that contain a chat boost.

    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:: 20.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_boost_types (:obj:`int`, optional): Pass one of
            :attr:`CHAT_BOOST`, :attr:`REMOVED_CHAT_BOOST` or
            :attr:`ANY_CHAT_BOOST` to specify if this handler should handle only updates with
            :attr:`telegram.Update.chat_boost`,
            :attr:`telegram.Update.removed_chat_boost` or both. Defaults to
            :attr:`CHAT_BOOST`.
        chat_id (:obj:`int` | Collection[:obj:`int`], optional): Filters reactions to allow
            only those which happen in the specified chat ID(s).
        chat_username (:obj:`str` | Collection[:obj:`str`], optional): Filters reactions to allow
            only those which happen in the specified username(s).
        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.
        chat_boost_types (:obj:`int`): Optional. Specifies if this handler should handle only
            updates with :attr:`telegram.Update.chat_boost`,
            :attr:`telegram.Update.removed_chat_boost` or both.
        block (:obj:`bool`): Determines whether the callback will run in a blocking way.
    )	_chat_ids_chat_usernameschat_boost_types
CHAT_BOOSTr   REMOVED_CHAT_BOOST   ANY_CHAT_BOOSTNTselfzChatBoostHandler[CCT, RT]callbackr   chat_idchat_usernameblockc                 v    t         |   ||       || _        t        |      | _        t        |      | _        y )N)r   )super__init__r   r   r   r   r   )r   r   r   r   r   r   	__class__s         b/var/www/cvtools/html/venv/lib/python3.12/site-packages/telegram/ext/_handlers/chatboosthandler.pyr   zChatBoostHandler.__init__V   s8     	/%5&w/-m<    updatereturnc                 "   t        |t              sy|j                  s|j                  sy| j                  | j
                  k(  r|j                  sy| j                  | j                  k(  r|j                  syt        | j                  | j                  f      sy|j                  x}r|j                  nd}|r|j                  nd}t        | j                  xr || j                  v       xs% t        | j                  xr || j                  v       S )zDetermines whether an update should be passed to this handler's :attr:`callback`.

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

        Returns:
            :obj:`bool`

        FTN)
isinstancer   
chat_boostremoved_chat_boostr   r   r   anyr   r   effective_chatidusernamebool)r   r!   chatr   r   s        r   check_updatezChatBoostHandler.check_updatec   s     &&)!!V%>%>  DOO3F<M<M  D$;$;;FD]D]DNND$8$89: '-&;&;;d;$''$)-4DNNB4>>(AC 
t  Lmt7K7K&KH
 	
r    )__name__
__module____qualname____doc__	__slots__r   r   int__annotations__r   r   r   r   r	   r
   r   strr+   r   objectr-   __classcell__)r   s   @r   r   r      s    (TI  Jc
\%&c
&c!"NE#J"7 !+!%'+=)=!&#r/2= = #	=
  }= =
6 
d 
r    r   N)r1   typingr   r   telegramr   "telegram.ext._handlers.basehandlerr   #telegram.ext._utils._update_parsingr   r   telegram.ext._utils.typesr	   r
   r   r    r    r   <module>r>      s5   & 7 "  : M > >e
{63?3 e
r    