U g@sdZddlmZmZmZmZmZmZmZddl m Z ddl m Z ddl mZddlmZddlmZddlmZmZerdd lmZed ZGd d d ee eefZd S)z.This module contains the MessageHandler class.) TYPE_CHECKINGAnyDictListOptionalTypeVarUnion)Update) DEFAULT_TRUE)DVTypefilters) BaseHandler)CCTHandlerCallback) ApplicationRTc seZdZdZdZefdeeje e e e fe edfdd Zeeeeeeeeffddd Ze e d eeeeeeffd d d dZZS)MessageHandleraHandler class to handle Telegram messages. They might contain text, media or status updates. 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. Args: filters (:class:`telegram.ext.filters.BaseFilter`): A filter inheriting from :class:`telegram.ext.filters.BaseFilter`. Standard filters can be found in :mod:`telegram.ext.filters`. Filters can be combined using bitwise operators (& for and, | for or, ~ for not). Passing :obj:`None` is a shortcut to passing :class:`telegram.ext.filters.ALL`. .. seealso:: :wiki:`Advanced Filters ` 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`. 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: filters (:class:`telegram.ext.filters.BaseFilter`): Only allow updates with these Filters. See :mod:`telegram.ext.filters` for a full list of all available filters. callback (:term:`coroutine function`): The callback function for this handler. block (:obj:`bool`): Determines whether the return value of the callback should be awaited before processing the next handler in :meth:`telegram.ext.Application.process_update`. r zMessageHandler[CCT, RT]selfr callbackblockcs(tj||d|dk r|ntj|_dS)N)r)super__init__filters_moduleALLr r __class__I/tmp/pip-unpacked-wheel-swnnwir2/telegram/ext/_handlers/messagehandler.pyrMszMessageHandler.__init__)updatereturncCst|tr|j|pdSdS)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` FN) isinstancer r check_update)rr rrrr#Xs zMessageHandler.check_updatez)Application[Any, CCT, Any, Any, Any, Any]N)contextr application check_resultr!cCst|tr||dS)zEAdds possible output of data filters to the :class:`CallbackContext`.N)r"dictr )rr$r r%r&rrrcollect_additional_contextfs z)MessageHandler.collect_additional_context)__name__ __module__ __qualname____doc__ __slots__r rrZ BaseFilterrr rrr boolrobjectrrstrrrr#r( __classcell__rrrrr#s '  (rN)r,typingrrrrrrrZtelegramr Ztelegram._utils.defaultvaluer Ztelegram._utils.typesr Z telegram.extr rZ"telegram.ext._handlers.basehandlerrZtelegram.ext._utils.typesrrrrrrrrrs$