U g@sndZddlmZmZddlmZddlmZddlm Z m Z ddl m Z m Z mZGdddeee e fZd S) z0This module contains the ChatBoostHandler class.)FinalOptional)Update) BaseHandler) parse_chat_idparse_username)CCTRTHandlerCallbackcseZdZUdZdZdZeeed<dZ eeed<dZ eeed<ed d d fd e e e efeeeeeed fd d ZeedddZZS)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_usernameschat_boost_types CHAT_BOOSTrREMOVED_CHAT_BOOSTANY_CHAT_BOOSTNTzChatBoostHandler[CCT, RT]selfcallbackrchat_id chat_usernameblockcs.tj||d||_t||_t||_dS)N)r)super__init__rrr rr r __class__K/tmp/pip-unpacked-wheel-swnnwir2/telegram/ext/_handlers/chatboosthandler.pyrVs zChatBoostHandler.__init__)updatereturncCst|tsdS|js|jsdS|j|jkr4|js4dS|j|jkrJ|jsJdSt|j|j fs^dS|j }rn|j nd}|r||j nd}t |jo||jkpt |j o||j kS)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) isinstancerZ chat_boostZremoved_chat_boostrrranyr r Zeffective_chatidusernamebool)rr Zchatrrrrr check_updatecs  zChatBoostHandler.check_update)__name__ __module__ __qualname____doc__ __slots__rrint__annotations__rrr rrr rstrr&robjectr' __classcell__rrrrr s$ *  r N)r+typingrrZtelegramrZ"telegram.ext._handlers.basehandlerrZ#telegram.ext._utils._update_parsingrrZtelegram.ext._utils.typesrr r r rrrrs