
    'i                         d Z ddlZddlmZmZ ddlmZmZmZ ddlm	Z	 ddl
mZ ddlmZ ddlmZmZ erdd	lmZ  ed
      Z G d deeeef         Zy)z2This module contains the StringRegexHandler class.    N)MatchPattern)TYPE_CHECKINGAnyTypeVar)DEFAULT_TRUE)DVType)BaseHandler)CCTHandlerCallback)ApplicationRTc            
            e Zd ZdZdZefdddeee   z  deee	e
f   dee   f fdZd	ed
ee   dz  fdZde	d	edddee   dz  d
df
dZ xZS )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 <re.compile>`): 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 <re.compile>`): 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`.

    )patternselfzStringRegexHandler[CCT, RT]r   callbackblockc                     t         |   ||       t        |t              rt	        j
                  |      }|| _        y )N)r   )super__init__
isinstancestrrecompiler   )r   r   r   r   	__class__s       s/home/obispo/Crisostomo_bridge/mision_env/lib/python3.12/site-packages/telegram/ext/_handlers/stringregexhandler.pyr   zStringRegexHandler.__init__M   s6     	/gs#jj)G+2    updatereturnNc                 l    t        |t              r$t        j                  | j                  |      x}r|S y)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)r   r   r   matchr   )r   r   r"   s      r   check_updatezStringRegexHandler.check_updateZ   s/     fc"$,,1O(O(OLr   contextapplicationz)Application[Any, CCT, Any, Any, Any, Any]check_resultc                 4    | j                   r|r	|g|_        yyy)z}Add the result of ``re.match(pattern, update)`` to :attr:`CallbackContext.matches` as
        list with one element.
        N)r   matches)r   r$   r   r%   r&   s        r   collect_additional_contextz-StringRegexHandler.collect_additional_contexth   s     <<L+nGO )<r   )__name__
__module____qualname____doc__	__slots__r   r   r   r   r   r   r	   boolr   objectr   r#   r)   __classcell__)r   s   @r   r   r   $   s    $L I +	3+3ws|#3 "#sB,/3 d|	36 eCj4.? -- - A	-
 Cj4'- 
-r   r   )r-   r   r   r   typingr   r   r   telegram._utils.defaultvaluer   telegram._utils.typesr	   "telegram.ext._handlers.basehandlerr
   telegram.ext._utils.typesr   r   telegram.extr   r   r   r    r   r   <module>r9      sJ   & 9 	  . . 5 ( : :(T]O-S#r\2 O-r   