ei dZddlmZmZddlmZmZmZmZddl m Z ddl m Z ddl mZddlmZmZerddlmZed Zed ZGd d eeeeefZd S)zLThis module contains the base class for handlers as used by the Application.)ABCabstractmethod) TYPE_CHECKINGAnyGenericTypeVar) DEFAULT_TRUE)build_repr_with_selected_attrs)DVType)CCTHandlerCallback) ApplicationRTUTc eZdZdZdZefdddeeee fde e fdZ de fd Zed ede ezd zfd Zd ed ddedede f dZded ed ddedd f dZd S) BaseHandlera The base class for all update handlers. Create custom handlers by inheriting from it. 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. This class is a :class:`~typing.Generic` class and accepts three type variables: 1. The type of the updates that this handler will handle. Must coincide with the type of the first argument of :paramref:`callback`. :meth:`check_update` must only accept updates of this type. 2. The type of the second argument of :paramref:`callback`. Must coincide with the type of the parameters :paramref:`handle_update.context` and :paramref:`collect_additional_context.context` as well as the second argument of :paramref:`callback`. Must be either :class:`~telegram.ext.CallbackContext` or a subclass of that class. .. tip:: For this type variable, one should usually provide a :class:`~typing.TypeVar` that is also used for the mentioned method arguments. That way, a type checker can check whether this handler fits the definition of the :class:`~Application`. 3. The return type of the :paramref:`callback` function accepted by this handler. .. seealso:: :wiki:`Types of Handlers ` .. versionchanged:: 20.0 * The attribute ``run_async`` is now :paramref:`block`. * This class was previously named ``Handler``. 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`. 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. block (:obj:`bool`): Determines whether the callback will run in a blocking way. )blockcallbackselfzBaseHandler[UT, CCT, RT]rrc"||_||_dS)N)rr)rrrs f/home/div/.hermes/hermes-agent/venv/lib/python3.11/site-packages/telegram/ext/_handlers/basehandler.py__init__zBaseHandler.__init__]s 7? #( returnc |jj}n$#t$rt|j}YnwxYwt ||S)a!Give a string representation of the handler in the form ``ClassName[callback=...]``. As this class doesn't implement :meth:`object.__str__`, the default implementation will be used, which is equivalent to :meth:`__repr__`. Returns: :obj:`str` )r)r __qualname__AttributeErrorreprr )r callback_names r__repr__zBaseHandler.__repr__esT 0 M6MM 0 0 0 //MMM 0-d]KKKKs 00updateNcdS)a This method is called to determine if an update should be handled by this handler instance. It should always be overridden. Note: Custom updates types can be handled by the application. Therefore, an implementation of this method should always check the type of :paramref:`update`. Args: update (:obj:`object` | :class:`telegram.Update`): The update to be tested. Returns: Either :obj:`None` or :obj:`False` if the update should not be handled. Otherwise an object that will be passed to :meth:`handle_update` and :meth:`collect_additional_context` when the update gets handled. N)rr!s r check_updatezBaseHandler.check_updatetr applicationz)Application[Any, CCT, Any, Any, Any, Any] check_resultcontextcnK||||||||d{VS)a This method is called if it was determined that an update should indeed be handled by this instance. Calls :attr:`callback` along with its respectful arguments. To work with the :class:`telegram.ext.ConversationHandler`, this method returns the value returned from :attr:`callback`. Note that it can be overridden if needed by the subclassing handler. Args: update (:obj:`str` | :class:`telegram.Update`): The update to be handled. application (:class:`telegram.ext.Application`): The calling application. check_result (:class:`object`): The result from :meth:`check_update`. context (:class:`telegram.ext.CallbackContext`): The context as provided by the application. N)collect_additional_contextr)rr!r&r'r(s r handle_updatezBaseHandler.handle_updatesH, ''lSSS]]67333333333rcdS)aPrepares additional arguments for the context. Override if needed. Args: context (:class:`telegram.ext.CallbackContext`): The context object. update (:class:`telegram.Update`): The update to gather chat/user id from. application (:class:`telegram.ext.Application`): The calling application. check_result: The result (return value) from :meth:`check_update`. Nr#)rr(r!r&r's rr*z&BaseHandler.collect_additional_contextr%r)__name__ __module__r__doc__ __slots__r r rr rr boolrstrr robjectr$r+rr*r#rrrr$sN11fI+))()!"c2+.)d|)))) L# L L L L 6 dVmd.B   ^ &44A4 4  4 44442   A           rrN)r/abcrrtypingrrrrtelegram._utils.defaultvaluer telegram._utils.reprr telegram._utils.typesr telegram.ext._utils.typesr r telegram.extrrrrr#rrr;s&SR########777777777777555555??????((((((::::::::)(((((( WT]] WT]]L L L L L #wr3{+L L L L L r