cjh8UdZddlmZddlZddlZddlmZmZmZm Z m Z ddl Z ddl Z ddlmZerFddlmZddl mZddlmZdd lmZdd lmZdd lmZmZdd lmZd dlmZm Z d dl!m"Z"d dl#m$Z$d dl%m&Z&dZ'e jPjRZ)de*d<e dZ+e ddZ,e ddZ-er edZ.ne dZ.Gdde j^j`ee,Z1y)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_CHECKINGAnyGenericTypeVarUnion)Message) ParamSpec)MessageableChannel)Guild)Member)ConnectionState) ClientUserUser) VoiceProtocol)AutoShardedBotBot)Cog)Command) StringView)ContextrMISSINGTBotTzUnion[Bot, AutoShardedBot])boundCogTrPc $eZdZdZeedddeddddd ddZ ddZddddd Zedd Z dd Z edd Z edd Z e jjddZe jjddZe jjddZe jjddZed dZd!dZe jj-ej0d"d#dZy)$ra Represents the context in which a command is being invoked under. This class contains a lot of metadata to help you understand more about the invocation context. This class is not created manually and is instead passed around to commands as the first parameter. This class implements the :class:`~discord.abc.Messageable` ABC. Attributes ----------- message: :class:`.Message` The message that triggered the command being executed. bot: :class:`.Bot` The bot that contains the command being executed. args: :class:`list` The list of transformed arguments that were passed into the command. If this is accessed during the :func:`.on_command_error` event then this list could be incomplete. kwargs: :class:`dict` A dictionary of transformed arguments that were passed into the command. Similar to :attr:`args`\, if this is accessed in the :func:`.on_command_error` event then this dict could be incomplete. current_parameter: Optional[:class:`inspect.Parameter`] The parameter that is currently being inspected and converted. This is only of use for within converters. .. versionadded:: 2.0 prefix: Optional[:class:`str`] The prefix that was used to invoke the command. command: Optional[:class:`Command`] The command that is being invoked currently. invoked_with: Optional[:class:`str`] The command name that triggered this invocation. Useful for finding out which alias called the command. invoked_parents: List[:class:`str`] The command names of the parents that triggered this invocation. Useful for finding out which aliases called the command. For example in commands ``?a b c test``, the invoked parents are ``['a', 'b', 'c']``. .. versionadded:: 1.7 invoked_subcommand: Optional[:class:`Command`] The subcommand that was invoked. If no valid subcommand was invoked then this is equal to ``None``. subcommand_passed: Optional[:class:`str`] The string that was attempted to call a subcommand. This does not have to point to a valid registered subcommand and could just point to a nonsense string. If nothing was passed to attempt a call to a subcommand then this is set to ``None``. command_failed: :class:`bool` A boolean that indicates if the command failed to be parsed, checked, or invoked. NF) argskwargsprefixcommand invoked_withinvoked_parentsinvoked_subcommandsubcommand_passedcommand_failedcurrent_parameterc ||_||_|xsg|_|xsi|_||_||_||_||_| xsg|_| |_ | |_ | |_ | |_ |jj|_ yN)messagebotr r!r"r#viewr$r%r&r'r(r)_state)selfr,r-r.r r!r"r#r$r%r&r'r(r)s O/var/www/html/venv/lib/python3.12/site-packages/discord/ext/commands/context.py__init__zContext.__init__zs"!( #zr &,l "( '. $ (4*9*?R2D->$2;L'+||':': c6K||g|i|d{S7w)aU|coro| Calls a command with the arguments given. This is useful if you want to just call the callback that a :class:`.Command` holds internally. .. note:: This does not handle converters, checks, cooldowns, pre-invoke, or after-invoke hooks in any matter. It calls the internal callback directly as-if it was a regular function. You must take care in passing the proper arguments when using this function. Parameters ----------- command: :class:`.Command` The command that is going to be called. \*args The arguments to use. \*\*kwargs The keyword arguments to use. Raises ------- TypeError The command argument to invoke is missing. N)r0r#r r!s r1invokezContext.invokes$BT3D3F3333s T) call_hooksrestartcK|j}|j}| td|j|j}}|j }|j }|j} |j} |rR|jxs|} t|jxsd|_d|_g|_|j|_n|} | j||d{||_||_||_||_||_| |_| |_y76#||_||_||_||_||_| |_| |_wxYww)a|coro| Calls the command again. This is similar to :meth:`~.Context.invoke` except that it bypasses checks, cooldowns, and error handlers. .. note:: If you want to bypass :exc:`.UserInputError` derived exceptions, it is recommended to use the regular :meth:`~.Context.invoke` as it will work more naturally. After all, this will end up using the old arguments the user has used and will thus just fail again. Parameters ---------- call_hooks: :class:`bool` Whether to call the before and after invoke hooks. restart: :class:`bool` Whether to start the call chain from the very beginning or where we left off (i.e. the command that caused the error). The default is to start where we left off. Raises ------ ValueError The context to reinvoke is not valid. NzThis context is not valid.r)r7)r#r. ValueErrorindexpreviousr$r&r%r' root_parentlenr"get_wordreinvoke) r0r7r8cmdr.r<r=r$r&r%r'to_calls r1rAzContext.reinvokesC<llyy ;9: :**dmmx(( !44.. 22 oo,GT[[.B/DJDM#%D $ D G 7""4J"? ? ?DLDJ$DM ,D &8D ##2D %6D " @DLDJ$DM ,D &8D ##2D %6D "s0CE DDD"2E D3E  E c>|jduxr|jduS)z=Checks if the invocation context is valid to be invoked with.N)r"r#r0s r1validz Context.valids!{{$&C4<``. .. versionadded:: 2.0 r:z<@!?%s>z@%s\z\\)r"merecompileidsub display_namereplace)r0userpatterns r1 clean_prefixzContext.clean_prefixs` ;; ww **Z$''12{{54#4#4#<#) |coro| Shows the help command for the specified entity if given. The entity can be a command or a cog. If no entity is given, then it'll show help for the entire bot. If the entity is a string, then it looks up whether it's a :class:`Cog` or a :class:`Command`. .. note:: Due to the way this function works, instead of returning something similar to :meth:`~.commands.HelpCommand.command_not_found` this returns :class:`None` on bad input or no help command. Parameters ---------- entity: Optional[Union[:class:`Command`, :class:`Cog`, :class:`str`]] The entity to show help for. Returns ------- Any The result of the help command, if any. r)rGroup wrap_callback) CommandErrorNr__cog_commands__)corerrbrcerrorsrdr- help_commandcopycontextr?prepare_help_commandget_bot_mapping send_bot_helpon_help_command_error isinstancestrget_cog get_commandqualified_nameAttributeErrorhasattr send_cog_helpsend_group_helpsend_command_help) r0r rrbrcrdr-rBmappinginjectedeentitys r1 send_helpzContext.send_helpBs< 87(hh ;hhj t9>**46 6 6))+G$S%6%67H %g... a fc "[[(CCOOF,CF >   ! ! &&tV-B-BCCC 5v12():):;%f---FE*()<)<=%f---FG,()>)>?%f---G 7/ //a888    D ... 5++D!4 4 4 5sA&H(F)&H FFF=H G )HG H)G#7G8G#;H<)G#%G&G#)H*)G#G!G#HFG $G9F<:G?HG  H GHGHG#G#!G##H (H=H>HHH  HcXK|jj|fi|d{S7wr+)r,reply)r0contentr!s r1rz Context.replys('T\\'':6::::s !*(*)r,r r-rr.rr z list[Any]r!zdict[str, Any]r" str | Noner#Command | Noner$rr%z list[str]r&rr'rr(boolr)zinspect.Parameter | None)r#zCommand[CogT, P, T]r zP.argsr!zP.kwargsreturnr)r7rr8rrNone)rr)rzdiscord.abc.Messageable)rrp)rz Cog | None)rz Guild | None)rr )rz User | Member)rzMember | ClientUser)rzVoiceProtocol | None)r rrrr+)rrr!rrr )__name__ __module__ __qualname____doc__rr2r6rApropertyrFrIrUrWdiscordutilscached_propertyrYrHr\rLr_r}copy_docr rr5r3r1rrBs5z"!(!"&#'%,-1(,$6:;; ;  ;  ;;; ;!;#;+;&;;4;@!4*!46<!4HP!4 !4F49$<7|DDXX    ]]"""#"  ]]""$#$  ]]""###  ]]""h#h-- O5b ]]GMM*;+;r3r)2r __future__rinspectrMtypingrrrrr discord.abcr discord.utilsdiscord.messager typing_extensionsr r discord.guildr discord.memberr discord.stater discord.userrrdiscord.voice_clientrr-rrrWrrfrr.r__all__rr__annotations__rrrrabc Messageablerr5r3r1rs2# >>#+.#%--2( }}$$$ CLv9:vU##A AS;gkk%%wt}S;r3