idZddlZddlmZmZddlmZmZmZddlm Z ddl m Z ddl m Z ddlmZmZerdd lmZed ZGd d e eeefZdS) z2This module contains the StringRegexHandler class.N)MatchPattern) TYPE_CHECKINGAnyTypeVar) DEFAULT_TRUE)DVType) BaseHandler)CCTHandlerCallback) ApplicationRTc eZdZdZdZefdddeeezdeee e fde e ffd Z d ed eed zfd Zd e d edddeed zd d f dZxZS)StringRegexHandlera|Handler class to handle string updates based on a regex which checks the update content. Read the documentation of the :mod:`re` module for more information. The :func:`re.match` function is used to determine if an update should be handled by this handler. Note: This handler is not used to handle Telegram :class:`telegram.Update`, but strings manually put in the queue. For example to send messages with the bot using command line or API. 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: pattern (:obj:`str` | :func:`re.Pattern `): The regex pattern. 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: str, 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: pattern (:obj:`str` | :func:`re.Pattern `): The regex pattern. 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`. )patternselfzStringRegexHandler[CCT, RT]rcallbackblockct||t|trt j|}||_dS)N)r)super__init__ isinstancestrrecompiler)rrrr __class__s i/Users/shanyulin/my-agent/.venv/lib/python3.11/site-packages/telegram/ext/_handlers/stringregexhandler.pyrzStringRegexHandler.__init__MsN /// gs # # *j))G+2 updatereturnNclt|trtj|j|x}r|SdS)zDetermines whether an update should be passed to this handler's :attr:`callback`. Args: update (:obj:`object`): The incoming update. Returns: :obj:`None` | :obj:`re.match` N)rrrmatchr)rrr"s r check_updatezStringRegexHandler.check_updateZs: fc " " $,1O1O(O Ltrcontext applicationz)Application[Any, CCT, Any, Any, Any, Any] check_resultc0|jr |r |g|_dSdSdS)z}Add the result of ``re.match(pattern, update)`` to :attr:`CallbackContext.matches` as list with one element. N)rmatches)rr$rr%r&s rcollect_additional_contextz-StringRegexHandler.collect_additional_contexths6 < -L -+nGOOO - - - -r)__name__ __module__ __qualname____doc__ __slots__rrrr r rr boolrobjectrr#r) __classcell__)rs@rrr$s$$LI + 3 3+ 3ws|# 3"#sB,/ 3d| 3 3 3 3 3 3 6 eCj4.?     - - -A - Cj4' -  - - - - - - - -rr)r-rrrtypingrrrtelegram._utils.defaultvaluertelegram._utils.typesr "telegram.ext._handlers.basehandlerr telegram.ext._utils.typesr r telegram.extr rrrrrr9s &98 ..........555555((((((::::::::::::::)(((((( WT]]O-O-O-O-O-S#r\2O-O-O-O-O-r