o "h@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)CCTHandlerCallbackcseZdZUdZdZdZeeed< dZ eeed< dZ eeed< d d d d e e fd d d e e eefd eeedeeedeeedeeededeeffdd ZdedefddZZS)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_REACTIONNselfzMessageReactionHandler[CCT, RT]callbackchat_id chat_usernameuser_id user_usernamerblockcsbtj||d||_t||_t||_|s|r%||j|jfvr%t dt||_ t||_ dS)N)rzwYou can not filter for users and include anonymous reactions. Set `message_reaction_types` to MESSAGE_REACTION_UPDATED.) super__init__rr rr rrr ValueErrorrr)rrrrrrrr __class__`/var/www/html/venv/lib/python3.10/site-packages/telegram/ext/_handlers/messagereactionhandler.pyr!ps     zMessageReactionHandler.__init__updatereturncCst|tsdS|js|jsdS|j|jkr|jrdS|j|jkr%|jr%dSt|j|j |j |j fs3dS|j }r;|j nd}|rB|jnd}|j}rL|j nd}|rS|jnd}t|jo]||jvp|t|j og||j vp|t|j oq||j vp|t|j o{||j vS)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) isinstancermessage_reactionmessage_reaction_countrrranyrrrreffective_chatidusernameeffective_userbool)rr'chatrruserrrr%r%r& check_updates2    z#MessageReactionHandler.check_update)__name__ __module__ __qualname____doc__ __slots__rrint__annotations__rrrr rr rrrstrrr1r!objectr4 __classcell__r%r%r#r&rsB ?     rN)r8typingrrtelegramrtelegram._utils.defaultvaluertelegram._utils.typesrrr"telegram.ext._handlers.basehandlerr #telegram.ext._utils._update_parsingr r telegram.ext._utils.typesr r rr%r%r%r&s