YiSrSSKrSSKJrJrJrJrJr SSKJ r SSK J r SSK J r Jr SSKJr SSKJr SS KJrJr \(aSS KJr \"S 5r"S S \\ \\45rg)z-This module contains the PrefixHandler class.N) TYPE_CHECKINGAnyOptionalTypeVarUnion)Update) DEFAULT_TRUE)SCTDVType)filters) BaseHandler)CCTHandlerCallback) ApplicationRTc^\rSrSrSrSrS\4SSS\\S\\S \ \ \ \ 4S \ \RS \\4 U4S jjjrS \S\ \\\\\\ \\\\\44444SjrS\ S \ SSS\ \\\\\\ \44SS4 SjrSrU=r$) PrefixHandler$aHandler 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 blockc>[T U]X5S9 [U[5(aUR 51OUVs1sHofR 5iM snn[U[5(aUR 51OUVs1sHofR 5iM snn[ S[ R"Xx555UlUbUUl g[RRUl gs snfs snf)N)rrc3.# UH upX-v M g7f)N).0pcs O/app/.venv/lib/python3.13/site-packages/telegram/ext/_handlers/prefixhandler.py )PrefixHandler.__init__..s2 CdaAECs) super__init__ isinstancestrlower frozenset itertoolsproductrfilters_module UpdateTypeMESSAGESr ) rrrrr rxprefixesr __class__s r!r%PrefixHandler.__init__}s (8'1&#'>'>FLLN#X^D_X^STWWYX^D_(27C(@(@GMMO$ZaFbZaUVwwyZaFb(12 '//C2 )  *G 0>0I0I0R0R E`Fbs C1?C6updatereturncV[U[5(aUR(aURnUR(afURR 5nUSR 5UR ;agURRU5nU(aUSSU4$gg)zDetermines 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_messagetextsplitr(rr check_update)rr3message text_list filter_results r!r:PrefixHandler.check_updates ff % %&*B*B..G||#LL..0 Q<%%'t}}< $ 9 9& A  $QR=-77context applicationz)Application[Any, CCT, Any, Any, Any, Any] check_resultc[U[5(a8USUl[US[5(aUR US5 ggg)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. rr6N)r&tupleargsdictr3)rr@r3rArBs r!collect_additional_context(PrefixHandler.collect_additional_contextsG lE * *'?GL,q/400|A/1 +r?)__name__ __module__ __qualname____firstlineno____doc__ __slots__r r r'rrrrrr, BaseFilterr boolr%objectrrDlistrFrr:rG__static_attributes__ __classcell__)r1s@r!rr$s"Sl(I8<*  & C S "&#r/2  .334  d|   * %eDIxdDcN>R8S/T$TUUV W2 0 0 0A 0 uT5cHTN1J+K%KLM 0  0 0r?r)rMr*typingrrrrrtelegramrtelegram._utils.defaultvaluer telegram._utils.typesr r telegram.extr r,"telegram.ext._handlers.basehandlerr telegram.ext._utils.typesrrrrrrr?r!r\sM&4??5-2::( T]T0KR0T0r?