o "h@sdZddlZddlmZmZmZmZmZddlm Z ddl m Z ddl m Z mZddlmZddlmZdd lmZmZerDdd lmZed ZGd d d ee eefZdS)z-This module contains the PrefixHandler class.N) TYPE_CHECKINGAnyOptionalTypeVarUnion)Update) DEFAULT_TRUE)SCTDVType)filters) BaseHandler)CCTHandlerCallback) ApplicationRTcseZdZdZdZdefdddeedeedee e e fd e e jd eef fd d Zd ede eeeeee eeeeefffffddZde d e ddde eeeeee effddf ddZZS) PrefixHandleraHandler class to handle custom prefix commands. This is an intermediate handler between :class:`MessageHandler` and :class:`CommandHandler`. It supports configurable commands with the same options as :class:`CommandHandler`. It will respond to every combination of :paramref:`prefix` and :paramref:`command`. It will add a :obj:`list` to the :class:`CallbackContext` named :attr:`CallbackContext.args`, containing a list of strings, which is the text following the command split on single or consecutive whitespace characters. Examples: Single prefix and command: .. code:: python PrefixHandler("!", "test", callback) # will respond to '!test'. Multiple prefixes, single command: .. code:: python PrefixHandler(["!", "#"], "test", callback) # will respond to '!test' and '#test'. Multiple prefixes and commands: .. code:: python PrefixHandler( ["!", "#"], ["test", "help"], callback ) # will respond to '!test', '#test', '!help' and '#help'. By default, the handler listens to messages as well as edited messages. To change this behavior use :attr:`~filters.UpdateType.EDITED_MESSAGE ` Note: * :class:`PrefixHandler` does *not* handle (edited) channel posts. 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. .. versionchanged:: 20.0 * :class:`PrefixHandler` is no longer a subclass of :class:`CommandHandler`. * Removed the attributes ``command`` and ``prefix``. Instead, the new :attr:`commands` contains all commands that this handler listens to as a :class:`frozenset`, which includes the prefixes. * Updating the prefixes and commands this handler listens to is no longer possible. Args: prefix (:obj:`str` | Collection[:obj:`str`]): The prefix(es) that will precede :paramref:`command`. command (:obj:`str` | Collection[:obj:`str`]): The command or list of commands this handler should listen for. Case-insensitive. 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`. filters (:class:`telegram.ext.filters.BaseFilter`, optional): 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 :keyword:`and`, ``|`` for :keyword:`or`, ``~`` for :keyword:`not`) 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: commands (frozenset[:obj:`str`]): The commands that this handler will listen for, i.e. the combinations of :paramref:`prefix` and :paramref:`command`. callback (:term:`coroutine function`): The callback function for this handler. filters (:class:`telegram.ext.filters.BaseFilter`): Optional. Only allow updates with these Filters. 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`. )commandsr NselfzPrefixHandler[CCT, RT]prefixcommandcallbackr blockcstj||dt|tr|hndd|D}t|tr#|hndd|D}tddt||D|_|durA||_ dSt j j |_ dS)N)rrcSh|]}|qSlower.0xrrW/var/www/html/venv/lib/python3.10/site-packages/telegram/ext/_handlers/prefixhandler.py z)PrefixHandler.__init__..cSrrrrrrrr r!css|] \}}||VqdS)Nr)rpcrrr s  z)PrefixHandler.__init__..) super__init__ isinstancestrr frozenset itertoolsproductrfilters_module UpdateTypeMESSAGESr )rrrrr rprefixesr __class__rrr&}s""  zPrefixHandler.__init__updatereturncCsdt|tr0|jr0|j}|jr0|j}|d|jvrdS|j|}|r.|dd|fSdSdS)aDetermines whether an update should be passed to this handler's :attr:`callback`. Args: update (:class:`telegram.Update` | :obj:`object`): Incoming update. Returns: :obj:`list`: The list of args for the handler. rNF) r'reffective_messagetextsplitrrr check_update)rr2message text_list filter_resultrrrr8s   zPrefixHandler.check_updatecontext applicationz)Application[Any, CCT, Any, Any, Any, Any] check_resultcCs<t|tr|d|_t|dtr||ddSdSdS)zAdd text after the command to :attr:`CallbackContext.args` as list, split on single whitespaces and add output of data filters to :attr:`CallbackContext` as well. rr4N)r'tupleargsdictr2)rr<r2r=r>rrrcollect_additional_contexts z(PrefixHandler.collect_additional_context)__name__ __module__ __qualname____doc__ __slots__rr r(rrr rrr, BaseFilterr boolr&objectrr?listrArr8rB __classcell__rrr0rr$sDV . r)rFr*typingrrrrrtelegramrtelegram._utils.defaultvaluertelegram._utils.typesr r telegram.extr r,"telegram.ext._handlers.basehandlerr telegram.ext._utils.typesr rrrrrrrrs