cjhK?UdZddlmZddlZddlZddlZddlZddlmZm Z m Z m Z m Z m Z ddlZddlmZddlmZddlmZdd lmZmZdd lmZer dd lmZdd lmZd Zej>j@Z de!d<e dZ"e ddZ#e ddZ$ddZ% d dZ&d!dZ'GddeejPjRZ*Gdde*ejVZ+Gdde*ejXZ,y)"ae The MIT License (MIT) Copyright (c) 2015-2021 Rapptz Copyright (c) 2021-present Pycord Development Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ) annotationsN) TYPE_CHECKINGAnyCallable CoroutineIterableTypeVar)errors)Context) GroupMixin)DefaultHelpCommand HelpCommand) StringView)Message)CoroFunc)when_mentionedwhen_mentioned_orBotAutoShardedBotrMISSINGTCFTr)boundCXTr cjd|jjdd|jjdgS)zA callable that implements a command prefix equivalent to being mentioned. These are meant to be passed into the :attr:`.Bot.command_prefix` attribute. z<@z> z<@!)userid)botmsgs K/var/www/html/venv/lib/python3.12/site-packages/discord/ext/commands/bot.pyrr=s1  R C }B"7 88cfd}|S)aA callable that implements when mentioned or other prefixes provided. These are meant to be passed into the :attr:`.Bot.command_prefix` attribute. See Also -------- :func:`.when_mentioned` Example ------- .. code-block:: python3 bot = commands.Bot(command_prefix=commands.when_mentioned_or('!')) .. note:: This callable returns another callable, so if this is done inside a custom callable, you must call the returned callable, for example: .. code-block:: python3 async def get_prefix(bot, message): extras = await prefixes_for(message.guild) # returns a list return commands.when_mentioned_or(*extras)(bot, message) c<t}t|||z}|SN)listr)rr rprefixess r!innerz when_mentioned_or..innerds" N 3 $q (r")r(r)s` r!rrFs< Lr"c8||k(xs|j|dS)N.) startswith)parentchilds r! _is_submoduler0ls" U? A??B B B BBcK|jjddry|j}|r|jry|j}|r|jryt d|jdt jtjt|||jt jyw)a!|coro| The default command error handler provided by the bot. By default, this prints to :data:`sys.stderr` however it could be overridden to have a different implementation. This only fires if you do not specify any listeners for command error. on_command_errorNzIgnoring exception in command :)file) _event_handlersr9commandhas_error_handlerrFprintsysstderr tracebackprint_exceptiontype __traceback__)r:context exceptionrLrFs r!rHzBotBase.on_command_errors    # #$6 = // w002 kk 3((*  .w.?qA S!! OY (?(?cjj sCCF call_oncecK|r |jn |j}t|dk(rytjj fd|Dd{S7w)NrTc3.K|] }|ywr%r*).0fctxs r! z"BotBase.can_run..s,BQsV,Bs) _check_once_checkslendiscordutils async_all)r:r]rXdatas ` r!can_runzBotBase.can_runsK#,t$,, t9>]],,,BT,BBBBBsAAAAc|jSr%) _help_command)r:s r!r8zBotBase.help_commands!!!r"c*|[t|ts td|j|jj |||_|j |y|j#|jj |d|_yd|_y)Nz.help_command must be a subclass of HelpCommand) isinstancer TypeErrorrh_remove_from_bot _add_to_bot)r:values r!r8zBotBase.help_commands  e[1 PQQ!!-""33D9!&D    d #    +    / / 5!%D !%D r"cK|jx}}t|r)tjj |||d{}t |t s t|}|s td|S7/#t$rHt |tjjrtd|jjwxYww)a|coro| Retrieves the prefix the bot is listening to with the message as a context. Parameters ---------- message: :class:`discord.Message` The message context to get the prefix of. Returns ------- Union[List[:class:`str`], :class:`str`] A list of prefixes or a single prefix that the bot is listening for. Nzecommand_prefix must be plain string, iterable of strings, or callable returning either of these, not z8Iterable command_prefix must contain at least one prefix)r7callablerbrcmaybe_coroutinerjstrr&rk collectionsabcrr<__name__ ValueError)r:messageprefixrets r! get_prefixzBotBase.get_prefixs"*** F  55fdGLLC#s# 3i N +M  c;??#;#;<@@C @V@V?WY s*>CA0C A2!C2ACC)clsczKt|j}|d|||}|jj|jjk(r|S|j |d{}|}t |tr|j|sU|S |jjt|r+tjj|j|}n|S |j$r|j'|j)}||_||_|j.j1||_|S7#t$rmt |ts"td|j j"|D]4}t |trtd|j j"wxYww)a|coro| Returns the invocation context from the message. This is a more low-level counter-part for :meth:`.process_commands` to allow users more fine-grained control over the processing. The returned context is not guaranteed to be a valid invocation context, :attr:`.Context.valid` must be checked to make sure it is. If the context is not valid then it is not a valid candidate to be invoked under :meth:`~.Bot.invoke`. Parameters ----------- message: :class:`discord.Message` The message to get the invocation context from. cls The factory class that will be used to create the context. By default, this is :class:`.Context`. Should a custom class be provided, it must be similar enough to :class:`.Context`\'s interface. Returns -------- :class:`.Context` The invocation context. The type of this can change via the ``cls`` parameter. N)rxviewrrwz@get_prefix must return either a string or a list of string, not zXIterable command_prefix or list returned from get_prefix must contain only strings, not )rcontentauthorrrrzrjrr skip_stringr-r>rbrcfindrkr&r<rur4skip_wsget_word invoked_withrxprefixed_commandsr9rL) r:rwr{r}r]rxinvoked_prefixrninvokers r! get_contextzBotBase.get_contexts<'//*DdGD >>   ,Jw// fc "##F+  ??--eFm<%,]]%7%78H8H&%QNJ#.  " " LLN--/"# ,,009  U0 !&$/#%//889; $E%eS1' % 8 89;# s3A%F;'E()F;AE"AF;AF8%F88F;c2K|j{|jd| |j|dd{r$|jj|d{nt j d |jd|y|jr7t jd|jd}|jd ||yy77t#tj $r/}|jj||d{7Yd}~yd}~wwxYww) a|coro| Invokes the command given under the invocation context and handles all the internal event dispatch mechanisms. Parameters ---------- ctx: :class:`.Context` The invocation context to invoke. NrLTrWz'The global check once functions failed.command_completionz Command "z" is not found command_error) rLdispatchrfinvoker CheckFailure CommandErrordispatch_errorrCommandNotFound)r:r]excs r!rzBotBase.invokeNs ;; " MM)S ) 9cT:::++,,S111 --.WXX2  2C8   ((9S5E5E4Fn)UVC MM/3 4;1&& ;kk00c::: ;s]DCC"CCC7ADCCD%DDD DDDcK|jjry|j|d{}|j|d{y77w)a@|coro| This function processes the commands that have been registered to the bot and other groups. Without this coroutine, none of the commands will be triggered. By default, this coroutine is called inside the :func:`.on_message` event. If you choose to override the :func:`.on_message` event, then you should invoke this coroutine as well. This is built using other low level tools, and is equivalent to a call to :meth:`~.Bot.get_context` followed by a call to :meth:`~.Bot.invoke`. This also checks if the message's author is a bot and doesn't call :meth:`~.Bot.get_context` or :meth:`~.Bot.invoke` if so. Parameters ---------- message: :class:`discord.Message` The message to process commands for. N)rrrr)r:rwr]s r!process_commandszBotBase.process_commandshsF, >>   $$W--kk#.s!,AA AAAAcBK|j|d{y7wr%)r)r:rws r! on_messagezBotBase.on_messages##G,,,s )r7zstr | Iterable[str] | Callable[[Bot | AutoShardedBot, Message], str | Iterable[str] | Coroutine[Any, Any, str | Iterable[str]]]r8HelpCommand | None)returnNone)rUr rVzerrors.CommandErrorrr)r]r rXboolrr)rr)rnrrr)rwrrzlist[str] | str)rwrr{z type[CXT]rr)r]r rr)rwrrr)ru __module__ __qualname__rh_supports_prefixed_commandsrrr6rbrccopy_docClientrDrHrfpropertyr8setterrzr rrrr __classcell__)r<s@r!r2r2psM"& +2K K)K( ]]GNN001 2   +>  8@EC"" & & (TGNN`548-r"r2ceZdZdZy)raP Represents a discord bot. This class is a subclass of :class:`discord.Bot` and as a result anything that you can do with a :class:`discord.Bot` you can do with this bot. This class also subclasses :class:`.GroupMixin` to provide the functionality to manage commands. .. note:: Using prefixed commands requires :attr:`discord.Intents.message_content` to be enabled. Attributes ---------- command_prefix The command prefix is what the message content must contain initially to have a command invoked. This prefix could either be a string to indicate what the prefix should be, or a callable that takes in the bot as its first parameter and :class:`discord.Message` as its second parameter and returns the prefix. This is to facilitate "dynamic" command prefixes. This callable can be either a regular function or a coroutine. An empty string as the prefix always matches, enabling prefix-less command invocation. While this may be useful in DMs it should be avoided in servers, as it's likely to cause performance issues and unintended command invocations. The command prefix could also be an iterable of strings indicating that multiple checks for the prefix should be used and the first one to match will be the invocation prefix. You can get this prefix via :attr:`.Context.prefix`. To avoid confusion empty iterables are not allowed. .. note:: When passing multiple prefixes be careful to not pass a prefix that matches a longer prefix occurring later in the sequence. For example, if the command prefix is ``('!', '!?')`` the ``'!?'`` prefix will never be matched to any message as the previous one matches messages starting with ``!?``. This is especially important when passing an empty string, it should always be last as no prefix after it will be matched. case_insensitive: :class:`bool` Whether the commands should be case-insensitive. Defaults to ``False``. This attribute does not carry over to groups. You must set it to every group if you require group commands to be case-insensitive as well. help_command: Optional[:class:`.HelpCommand`] The help command implementation to use. This can be dynamically set at runtime. To remove the help command pass ``None``. For more information on implementing a help command, see :ref:`ext_commands_help_command`. strip_after_prefix: :class:`bool` Whether to strip whitespace characters after encountering the command prefix. This allows for ``! hello`` and ``!hello`` to both work if the ``command_prefix`` is set to ``!``. Defaults to ``False``. .. versionadded:: 1.7 Nrurr__doc__r*r"r!rrs:r"rceZdZdZy)rzsThis is similar to :class:`.Bot` except that it is inherited from :class:`discord.AutoShardedBot` instead. Nrr*r"r!rrsr"r)rzBot | AutoShardedBotr rrz list[str])r(rrrz4Callable[[Bot | AutoShardedBot, Message], list[str]])r.rrr/rrrr)-r __future__rrscollections.abcrOrQtypingrrrrrr rbr rUr corer helprrr}rdiscord.messager_typesr__all__rcr__annotations__rrrrrr0rFCogMixinr2rrr*r"r!rs2# MM1'  }}$$$ CL e:& e9%9##9#L=U-j'++..U-p;'7;;;|Wg44r"