U g@sdZddlmZmZddlmZddlmZddlm Z m Z m Z ddl m Z ddlmZmZddlmZmZGd d d e eee fZd S) z6This module contains the MessageReactionHandler class.)FinalOptional)Update) DEFAULT_TRUE)RTSCTDVType) BaseHandler) parse_chat_idparse_username)CCTHandlerCallbackc seZdZUdZdZdZeeed<dZ eeed<dZ eeed<d d d d e e fd e e eefeeeeeeeeeeeeeeed fd d ZeedddZZS)MessageReactionHandlera Handler class to handle Telegram updates that contain a message reaction. Note: The following rules apply to both ``username`` and the ``chat_id`` param groups, respectively: * If none of them are passed, the handler does not filter the update for that specific attribute. * If a chat ID **or** a username is passed, the updates will be filtered with that specific attribute. * If a chat ID **and** a username are passed, an update containing **any** of them will be filtered. * :attr:`telegram.MessageReactionUpdated.actor_chat` is *not* considered for :paramref:`user_id` and :paramref:`user_username` filtering. 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`. message_reaction_types (:obj:`int`, optional): Pass one of :attr:`MESSAGE_REACTION_UPDATED`, :attr:`MESSAGE_REACTION_COUNT_UPDATED` or :attr:`MESSAGE_REACTION` to specify if this handler should handle only updates with :attr:`telegram.Update.message_reaction`, :attr:`telegram.Update.message_reaction_count` or both. Defaults to :attr:`MESSAGE_REACTION`. 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). user_id (:obj:`int` | Collection[:obj:`int`], optional): Filters reactions to allow only those which are set by the specified chat ID(s) (this can be the chat itself in the case of anonymous users, see the :paramref:`telegram.MessageReactionUpdated.actor_chat`). user_username (:obj:`str` | Collection[:obj:`str`], optional): Filters reactions to allow only those which are set by the specified username(s) (this can be the chat itself in the case of anonymous users, see the :paramref:`telegram.MessageReactionUpdated.actor_chat`). 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. message_reaction_types (:obj:`int`): Optional. Specifies if this handler should handle only updates with :attr:`telegram.Update.message_reaction`, :attr:`telegram.Update.message_reaction_count` or both. block (:obj:`bool`): Determines whether the callback will run in a blocking way. ) _chat_ids_chat_usernames _user_ids_user_usernamesmessage_reaction_typesMESSAGE_REACTION_UPDATEDrMESSAGE_REACTION_COUNT_UPDATEDMESSAGE_REACTIONNzMessageReactionHandler[CCT, RT]selfcallbackchat_id chat_usernameuser_id user_usernamerblockcsbtj||d||_t||_t||_|s2|rJ||j|jfkrJt dt||_ t||_ dS)N)r zwYou can not filter for users and include anonymous reactions. Set `message_reaction_types` to MESSAGE_REACTION_UPDATED.) super__init__rr rr rrr ValueErrorrrr __class__Q/tmp/pip-unpacked-wheel-swnnwir2/telegram/ext/_handlers/messagereactionhandler.pyr"ps     zMessageReactionHandler.__init__)updatereturncCst|tsdS|js|jsdS|j|jkr4|jr4dS|j|jkrJ|jrJdSt|j|j |j |j fsfdS|j }rv|j nd}|r|jnd}|j}r|j nd}|r|jnd}t|jo||jkpt|j o||j kpt|j o||j kpt|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) isinstancerZmessage_reactionZmessage_reaction_countrrranyrrrrZeffective_chatidusernameZeffective_userbool)rr(Zchatrruserrrr&r&r' check_updates6    z#MessageReactionHandler.check_update)__name__ __module__ __qualname____doc__ __slots__rrint__annotations__rrrr rr rrrstrrr.r"objectr0 __classcell__r&r&r$r'rs, ?     rN)r4typingrrZtelegramrZtelegram._utils.defaultvaluerZtelegram._utils.typesrrrZ"telegram.ext._handlers.basehandlerr Z#telegram.ext._utils._update_parsingr r Ztelegram.ext._utils.typesr r rr&r&r&r's