cjh7 tdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddl m Z ddlmZmZmZmZmZmZmZmZddlmZmZddlm Zdd lmZmZmZmZm Z dd l!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'dd l(m)Z)dd l*m+Z+m,Z,dd l-m.Z.ddl/m0Z0ddl1m2Z2ddl3m4Z4ddl5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;ddlZ>ddl?m@Z@mAZAejdk\r ddlmCZCmDZDmEZEn ddlFmCZCmDZDmEZEdZGerddlFmHZHmIZIddlJmKZKddlLmMZMddlNmOZOmPZPedZQeddZRed ed!eeeeffZSer eId"ZTned"ZTd#ZUd$ZVd?d%ZWd&ZXd'ZYGd(d)ZZGd*d+eZeeReTeQfZ[Gd,d-e[Z\Gd.d/e[Z]Gd0d1e[Z^Gd2d3e^Z_Gd4d5e^Z`d6Zad7Zbd8Zce\fd9Zdd:Zed;Zfgd<Zgd@dAd=Zhd@dBd>Ziy)Cae 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) OrderedDict)Enum) TYPE_CHECKINGAnyCallable Coroutine GeneratorGenericTypeVarUnion)PartialMessageable_threaded_guild_channel_factory)IntegrationTypeInteractionContextType MessageTypeSlashCommandOptionTypetry_enum)ApplicationCommandErrorApplicationCommandInvokeError CheckFailureClientExceptionInvalidArgumentValidationError)Member) AttachmentMessage)Object)Role)Thread)User)MISSING async_allfindmaybe_coroutineutcnowwarn_deprecated)ApplicationContextAutocompleteContext)Option OptionChoice) ) Annotatedget_args get_origin) _BaseCommandApplicationCommand SlashCommand slash_commandapplication_command user_commandmessage_commandcommandSlashCommandGroupContextMenuCommand UserCommandMessageCommand) Concatenate ParamSpec) Permissions)Cog)CooldownMappingMaxConcurrencyTCogTrB)boundCoro.PcRddlmtjfd}|S)Nr CommandErrorcK |i|d{}|S7#t$r$rtj$rYyt$r}t ||d}~wwxYwwN)rasyncioCancelledError Exceptionr)argskwargsretexcrLcoros H/var/www/html/venv/lib/python3.12/site-packages/discord/commands/core.pywrappedzwrap_callback..wrappedssm >d-f--C .&    %%   >/4# = >s;A A!AAA AAAext.commands.errorsrL functoolswraps)rVrXrLs` @rW wrap_callbackr]ps(2__T   NcZddlmtjfd}|S)NrrKcK |d{} tdr/j#jj d{j d{|S7[#t$r$rtj$rYYtdr0j$jj d{7j d{7yt$r}t||d}~wwxYw77#tdr0j$jj d{7j d{7wxYww)N_max_concurrency) rrOrPhasattrrareleasecall_after_hooksrQr)argrTrUrLr:rVctxs rWrXz(hooked_wrapped_callback..wrappedsF 0S /C!34,,8..66s;;;**3/ / / !"&    %%   !34,,8..66s;;;**3/ / / >/4# = >< / !34,,8..66s;;;**3/ / /sE" A.A,A.6E" D E"%D&E",A..!DD6E"C E" C#!E"'D/ C;;DDE"E"7E>E?EEEE"rY)r:rfrVrXrLs``` @rWhooked_wrapped_callbackrgs(2__T( Nr^ctj} t|dr |j}nt ||r |j }n|S5)N __wrapped__)r[partialrbri isinstancefunc)functionrjs rWunwrap_functionrnsBG  8] +++H ' *}}HO r^ct|j|jr0|jjD]\}}t||yyN)locale)validate_chat_input_namenamename_localizationsitemsobjrqstrings rW_validate_namesrysHSXX& !44::< >  !j4E!h  .445HOU .ZZ"-F .s1HH:9H:cPd|jjd|jdS)Nz) __class__rrsrs rW__repr__zApplicationCommand.__repr__ s&#DNN$;$;#z-ApplicationCommand.can_run..sJ)y~Js) botrrrsrrr_get_overridden_method cog_checkr&r$)rrf predicatesr local_checkrTs ` rWrzApplicationCommand.can_runsWW__S)))9$))HM [[ ;; "++j8Jhh ?44S]]CK&+K== JzJJJJ-*>Ks4CCBC+C,!C CCCCcKd|_|j} |j}t|}|||||d{n|||d{ |C|j j |j}|t|}|||d{|jjd||y7{7k#t$rYswxYw75#|jjd||wxYww)NTapplication_command_error) command_failedron_errorr]rrrcog_command_errorrdispatch)rrferrorrrVrlocalrXs rWdispatch_errorz!ApplicationCommand.dispatch_errors!hh +==D%T*HsC///sE*** F <` The coroutine to register as the local error handler. Raises ------ TypeError The coroutine passed is not actually a coroutine. z&The error handler must be a coroutine.)rOiscoroutinefunctionrrrrVs rWrzApplicationCommand.errors*$**40DE E  r^ct|dS)z;Checks whether the command has an error handler registered.r)rbrs rWhas_error_handlerz$ApplicationCommand.has_error_handlerstZ((r^cTtj|s td||_|S)aA decorator that registers a coroutine as a pre-invoke hook. A pre-invoke hook is called directly before the command is called. This makes it a useful function to set up database connections or any type of set up required. This pre-invoke hook takes a sole parameter, an :class:`.ApplicationContext`. See :meth:`.Bot.before_invoke` for more info. Parameters ---------- coro: :ref:`coroutine ` The coroutine to register as the pre-invoke hook. Raises ------ TypeError The coroutine passed is not actually a coroutine. z(The pre-invoke hook must be a coroutine.)rOrr_before_invokers rW before_invokez ApplicationCommand.before_invokes+&**40FG G" r^cTtj|s td||_|S)aA decorator that registers a coroutine as a post-invoke hook. A post-invoke hook is called directly after the command is called. This makes it a useful function to clean-up database connections or any type of clean up required. This post-invoke hook takes a sole parameter, an :class:`.ApplicationContext`. See :meth:`.Bot.after_invoke` for more info. Parameters ---------- coro: :ref:`coroutine ` The coroutine to register as the post-invoke hook. Raises ------ TypeError The coroutine passed is not actually a coroutine. z)The post-invoke hook must be a coroutine.)rOrr _after_invokers rW after_invokezApplicationCommand.after_invokes+&**40GH H! r^cK|j}|jMt|jd|}|r|j||d{n|j|d{|7|jj |j }|||d{|j j}|||d{yy77i727 wN__self__)rr rrrcog_before_invokerrrfrinstancehooks rWrz$ApplicationCommand.call_before_hooks6shh    *t22JDH))(C888))#... ?==778M8MND3iww%%  s)OO 9.  HAC C  C#C $8CC'CCC CCCcK|j}|jMt|jd|}|r|j||d{n|j|d{|7|jj |j }|||d{|j j}|||d{yy77i727 wr)rrrrrcog_after_invokerrs rWrdz#ApplicationCommand.call_after_hooksOshh    )t11:sCH((3777((--- ?==778L8LMD3iww$$  s)OO 8-   rc.|jjSrN)r _cooldownrs rWrzApplicationCommand.cooldownbs}}&&&r^cg}|}|j`t|jdrJ|j}|j|j|jt|jdrJdj t |S)zRetrieves the fully qualified parent command name. This the base command name required to execute it. For example, in ``/one two three`` the parent name would be ``one two``. rs )rrbappendrsjoinreversed)rentriesr:s rWfull_parent_namez#ApplicationCommand.full_parent_namefsmnn(WW^^V-LnnG NN7<< (nn(WW^^V-Lxx)**r^cX|j}|r|d|jS|jS)zRetrieves the fully qualified command name. This is the full parent name with the command name as well. For example, in ``/one two three`` the qualified name would be ``one two three``. r)r"rs)rrs rWrz!ApplicationCommand.qualified_nameus1&& XQtyyk* *99 r^c^|j|jjS|jS)zRetrieves the fully qualified command ID. This is the root parent ID. For example, in ``/one two three`` the qualified ID would return ``one.id``. )rr qualified_idrs rWr%zApplicationCommand.qualified_ids& 77?;;++ +wwr^ctrN)NotImplementedErrorrs rWto_dictzApplicationCommand.to_dicts!!r^c|jSrN)rrs rW__str__zApplicationCommand.__str__s"""r^c||_yrN)r)rrs rW_set_cogzApplicationCommand._set_cogs r^rlrreturnNoner.strr.bool)r.sCallable[Concatenate[CogT, ApplicationContext, P], Coro[T]] | Callable[Concatenate[ApplicationContext, P], Coro[T]])rmr4r.r/rr3r.r/rfr*rfr*r.r/)rfr*r.r3)rfr*r.float)rfr*rrQr.r/)r.int)r.r)#rrr__annotations__rrrrrpropertyrsetterrrrrrrrrrrrr r rrrdrr"rr%r(r*r,rr^rWr4r4sO'' CHPTP  9 @__ ( D (  ( (YY U*/0 2 K2F.H0)222&'' + +  "#r^r4ceZdZdZdZdfd Zdfd ZdZdZdddd Z d Z d Z d Z d Z edZej dZeddZeddZddZddZddZdZdZd dZxZS)!r5a A class that implements the protocol for a slash command. These are not created manually, instead they are created via the decorator or functional interface. .. versionadded:: 2.0 Attributes ----------- name: :class:`str` The name of the command. callback: :ref:`coroutine ` The coroutine that is executed when the command is called. description: Optional[:class:`str`] The description for the command. guild_ids: Optional[List[:class:`int`]] The ids of the guilds where this command will be registered. options: List[:class:`Option`] The parameters for this command. parent: Optional[:class:`SlashCommandGroup`] The parent group that this command belongs to. ``None`` if there isn't one. mention: :class:`str` Returns a string that allows you to mention the slash command. guild_only: :class:`bool` Whether the command should only be usable inside a guild. .. deprecated:: 2.6 Use the :attr:`contexts` parameter instead. nsfw: :class:`bool` Whether the command should be restricted to 18+ channels and users. Apps intending to be listed in the App Directory cannot have NSFW commands. default_member_permissions: :class:`~discord.Permissions` The default permissions a member needs to be able to run the command. cog: Optional[:class:`Cog`] The cog that this command belongs to. ``None`` if there isn't one. checks: List[Callable[[:class:`.ApplicationContext`], :class:`bool`]] A list of predicates that verifies if the command could be executed with the given :class:`.ApplicationContext` as the sole parameter. If an exception is necessary to be thrown to signal failure, then one inherited from :exc:`.ApplicationCommandError` should be used. Note that if the checks fail then :exc:`.CheckFailure` exception is raised to the :func:`.on_application_command_error` event. cooldown: Optional[:class:`~discord.ext.commands.Cooldown`] The cooldown applied when the command is invoked. ``None`` if the command doesn't have a cooldown. name_localizations: Dict[:class:`str`, :class:`str`] The name localizations for this command. The values of this should be ``"locale": "name"``. See `here `_ for a list of valid locales. description_localizations: Dict[:class:`str`, :class:`str`] The description localizations for this command. The values of this should be ``"locale": "description"``. See `here `_ for a list of valid locales. integration_types: Set[:class:`IntegrationType`] The type of installation this command should be available to. For instance, if set to :attr:`IntegrationType.user_install`, the command will only be available to users with the application installed on their account. Unapplicable for guild commands. contexts: Set[:class:`InteractionContextType`] The location where this command can be used. Cannot be set if this is a guild command. r)cPt||}|j|_|SrNsuper__new__copyrclsrRrSrrs rWrAzSlashCommand.__new__$ws##);;=  r^ct||fi|tj|s t d||_|j dt|_t||j dxs>|j0tj|jjdnd}||_|j dt|_t!|d|_|j dg|_g|_|j) |j*}|j-||_d|_d|_y#t.$r|j d g}Y3wxYw) NCallback must be a coroutine.rtr|rNo description providedr}Foptionsr)r@rrOrrrrr#rtry__doc__rcleandoc splitlinesr|r}r~attached_to_group_options_kwargsrI_validate_parametersrrrrr r)rrlrRrSr|rrs rWrzSlashCommand.__init__sG ((**40;< < 28** '3  jj/ ||'   T\\ * 5 5 7 :*  !,9? ': & t$',%zz)R8%'  !!# .--F NN  "!  .ZZ"-F .sEE#"E#c|j}|jx}r|j|||_y|j ||_yrN)rrN_match_option_param_namesrI_parse_options)rparamskwops rWrOz!SlashCommand._validate_parameterssG//1'' '4 '99&$GDL..v6DLr^c t|j}|js |jrddgndg}|D]} t ||S#t $rt d|jd|dwxYw)Nrcontext Callback for  command is missing " " parameter.)iterrurMrnext StopIterationrrs)rrSrequired_paramsps rW_check_required_paramsz#SlashCommand._check_required_paramssflln%#'#9#9TXXVY I; ! A V   ! %#DII;.CA3lS s A&A4T check_paramsc|r|j|}nt|j}g}|D]\}}|j}|tj j k(rt}|j|rt|d}|j}d|D} t| t}|j|r.tjt|d|_d|_ntj||_|j%|rA|j|rt|j&dd}nt|j&}t)|tslt)|j"trG|j"j $tj||j"_|j"}n t|}|j"|j"tj j k(st)|j"trnht)|j"t*r6t-|j"t.t0frt|j"}n|j"|_d|_|j4||_|j4|k7s |j6||_t9|t;||j=||S)Nrc3BK|]}t|ts|ywrN)rkr,)relems rWrz.SlashCommand._parse_options..-sTt:dF;SdTs)rF)r_rZru annotationr Parameteremptyr1_is_typing_annotatedr1 __metadata__r[r,_is_typing_optionalr from_datatype input_typer_is_typing_union__args__rkr issubclass DiscordEnumrrequiredrs_parameter_nameryr~r) rrSra final_optionsp_namep_objoption type_hintmetadata option_gens rWrRzSlashCommand._parse_optionssO 008F&,,.)F #6 )MFE%%F**000((0$V,Q/ !..TxT j&(3++I6(>(L(L +A.)F%&*FN(>(L(LY(WF%$$V,++F3#FOOA$6EF#FOO4Fff-emmV4}}//73I3W3W"4 0#]]F#F^F~~%emmw?P?P?V?V.VemmV4 t4MMK#6:$EMM2F%*]]FN&+FO{{"$ {{f$(>(>(F)/& F # "6 *   (m6 )pr^c t|}j|}dddfddg}|D]ktt t |\} j t fd|Dstd|d jd |_ mt}|D] \}}|||< |jj|d |S#t $r t dwxYw) Nc\|jtjk(xr|jduSrN)rlrrx converteroas rWz8SlashCommand._match_option_param_names..cs*)?)F)FF( 4'r^c6t|jtSrN)rkrlrr}s rWrz8SlashCommand._match_option_param_names..es 4r^cft|jtxr|t|jk(SrN)rk _raw_typetupler r}s rWrz8SlashCommand._match_option_param_names..hs$AKK7SAq{{AS.is811!4*JJ* qzz)r^cRt|txrt||jSrN)rkrrorr}s rWrz8SlashCommand._match_option_param_names..ls#At,+1akk*r^z/Too many arguments passed to the options kwarg.c30K|] }|ywrNr)rcheckr~rus rWrz9SlashCommand._match_option_param_names..xsF5uQFsz Parameter z does not match input type of .Fr`)listr_ryr~r[r\rreanyrrsrrrextendrR) rrSrIcheck_annotationsrtleft_out_paramskvr~rus ` @@rWrQz&SlashCommand._match_option_param_names^s#w-,,V4 (  T * + C  'A A  "1 % Y $V $$EF4EFF (FqvvhaP!'A  '&- #DAq!"OA  #t**?*OP! Y%&WXX Ys CC0clt|ddtuxs t|ttdtuS)N __origin__ UnionType)rr rtypesrres rWrmzSlashCommand._is_typing_unions=z<6%? 4 D  ; D  r^cV|j|xrtd|jvSrN)rmrrnrs rWrjz SlashCommand._is_typing_optionals'$$Z0VT$Z:CVCV5VVr^c$t|tuSrN)r2r0rs rWrhz!SlashCommand._is_typing_annotateds*%22r^ct|ddS)N_cog)rrs rWrzSlashCommand.cogstVT**r^c^|j}||_|||||jyyyrN)rrrO)rrold_cogs rWrzSlashCommand.cogs@((  O!}#  % % '$r^c|jduSrN)rrs rW is_subcommandzSlashCommand.is_subcommands{{$&&r^c<d|jd|jdS)Nz>r^c|j|j|jDcgc]}|jc}d}|jt ur|j|d<|j t ur|j |d<|jrtjj|d<|j|j|d<|j|jj|d<|jsZ|jsN|jDcgc]}|jc}|d<|jDcgc]}|jc}|d<|Scc}wcc}wcc}w N)rsr|rIrtr}rrrrr)rsr|rIr(rtr#r}rr sub_commandrrrrrr)rr~as_dictitrfs rWr(zSlashCommand.to_dicts-II++-1\\: :   " "' 1,0,C,CG( )  ) ) 8373Q3QG/ 0   4@@FFGFO 99 "iiGFO  * * 6//55 0 1~~d&8&8?C?U?U+VBHH+VG' (8< "F399"FGJ +;$,W"FsEE9Ec Ki}|jjjdgD]tfd|j}| d|j t jt jt jt jt jfvr|jjjdi}|j t jt jfvr|jdijx}z|jdijx}||d<|jjjj}|jj|t!|n!|j t jur|jdijx}#t#|jj|n|jd ijx}.t%|jj||j nnt't! nW|j|j j(d ijx} |j t jurt!|jj*vs!t!|jj,vrh|jj/t!d |d<t1t2rj5|nj5|j|nUd}i} |j t jurt"}n|j t jurt$}|j| d<n_|j t jur!t7|dd}|j| d<n"|j t jurt8}|d|jj|d| n|t't! ne|j t j:k(rl|j<x} ^ddlm } t1| | r't1| tBr | jE|d{n| jE|d{n|jFt jHt jJt j:t jLfvrntO|jFtPrwt1tRr,jUr |jGt!n;tfd|jXx} r t[|jF| j(||j\<|jD]*} | j\|vs| j^|| j\<,|j`'|jb|j`|fi|d{y|jd5|jfd ur'|jb|jd|fi|d{y|jb|fi|d{y77#tV$r|jGYwxYw77I7/w)NrIc(|jdk(SNrsrs)xres rWrz&SlashCommand._invoke..s#f+ 5r^rresolvedmembersusersuserstatedataroles)rrr)rsT _invoke_flagrrr) Converterc"|jk(SrN)r)cres rWrz&SlashCommand._invoke..,saggnr^r)4 interactionrrr%rIrlrrrolechannel attachment mentionable_statemember_cache_flagsr_get_and_update_memberr9r"r rrs _channels_threadsget_channel_or_threadrkr!_updaterrrxr|discord.ext.commandsrrconvertrintegernumberbooleanrorr1isdigit ValueErrorchoicesrrrrrrrrM)rrfrSopr_data _user_data cache_flagobj_typekwr|rchoicer~res @rWrzSlashCommand._invokes??''++Ir:f -C5t||DBzg,C}}&++&++&..&11&22 !??//33JCMM.335K5W5WXY"*,,y""="A"A#"FFS'/ll7B&?&C&CC&HH U(2f !$!7!7!J!J!V!VJ))::5#c(JWC]]&<&H&HH!)gr!:!>!>s!CCP")?)?eL#+<<#<#@#@#EE%R""%//"8"8uCII%C1%\\R]]-?-?,@*BBGKKCPPE}}(>(F(FFCCII$7$77s8syy'9'99!ii==c#hG04n- *#v6 KK.!$SYY!>$(==,B,G,GG'+H]].D.I.II'+H*-))BwK]].D.L.LL(GuV}'UVW'XH*-))BwK]].D.O.OO'1H&VS__-C-C%VSUV!CH-C !7!>!>>"$,,.Y;:i3!)T2$-K$7$7S$AA$-$5$5c3$??&..&--&--&.. " BLL$/c3'CKKM0 ll3s84 $$Z?[ZB [%Z?A+[+A[3Z<4A[4Z>5[[[[Z96[8Z99[>[[c  K|jDcic]}|j|j}}|jjj dgD] j ddst fd|j}|j|jjdDcic] }|d|d c}||_||_ j d|_ ||_ttj|jjdk(r4t!|jd|j"}|j||}n|j|}t%j&|jr |d{}|Dcgc]}t)|t*r|n t+|!c}dd }|jj,j/| d{cSycc}wcc}w7ncc}w7w) NrIfocusedFc(|jdk(Srr)r~rs rWrz;SlashCommand.invoke_autocomplete_callback..As"V*(<r^rsrrr)r)rIrsrrrrr%updater:rrrrr autocompleterrrrOrrkr-responsesend_autocomplete_result) rrfivaluesrvrresultr~rrs @rWinvoke_autocomplete_callbackz)SlashCommand.invoke_autocomplete_callback<s-1\\:!&&!))#:://&&**9b9 Bvvi'H/?H.G8 >CHG=H$G?;/H*H+H?Hcr|j|jfi|j}|j|S)zCreates a copy of this command. Returns ------- :class:`SlashCommand` A new instance of this command. rrr_ensure_assignment_on_copyrrTs rWrBzSlashCommand.copy[4dnnT]]Gd.F.FG..s33r^c|j|_|j|_|j|jk7r|jj|_ |j|_|S#t $rY|SwxYwrNr rrrBrrrs rWrz'SlashCommand._ensure_assignment_on_copyfr#22"00 ;;%,, &;;++-EL !]]EN     A// A<;A<c|rY|j}|j|j|j|jfi|}|j |S|jSrNrBrrrrrrrSrrBs rW _update_copyzSlashCommand._update_copywX B IId.. /!4>>$--626D2248 899; r^)r.r5r-)rar3r.z list[Option]r2r0r.dictr7)rfr+rSr)rrrrJrrArrOr_rRrQrmrjrhr;rr<rrr(rrrBrr __classcell__rs@rWr5r5s:x D &"P7 >B?B%N W3++ ZZ ( (''??6t/l> 4"r^r5cNeZdZUdZded<dZdfd Z d ddZeddZ eddZ e jdd Z dd Z dd Z ef d d Z d! d"d Z d# d$dZd%dZd&dZd%dZd%dZd'dZdZdZd(dZfdZxZS))r;aF A class that implements the protocol for a slash command group. These can be created manually, but they should be created via the decorator or functional interface. Attributes ----------- name: :class:`str` The name of the command. description: Optional[:class:`str`] The description for the command. guild_ids: Optional[List[:class:`int`]] The ids of the guilds where this command will be registered. parent: Optional[:class:`SlashCommandGroup`] The parent group that this group belongs to. ``None`` if there isn't one. guild_only: :class:`bool` Whether the command should only be usable inside a guild. .. deprecated:: 2.6 Use the :attr:`contexts` parameter instead. nsfw: :class:`bool` Whether the command should be restricted to 18+ channels and users. Apps intending to be listed in the App Directory cannot have NSFW commands. default_member_permissions: :class:`~discord.Permissions` The default permissions a member needs to be able to run the command. checks: List[Callable[[:class:`.ApplicationContext`], :class:`bool`]] A list of predicates that verifies if the command could be executed with the given :class:`.ApplicationContext` as the sole parameter. If an exception is necessary to be thrown to signal failure, then one inherited from :exc:`.ApplicationCommandError` should be used. Note that if the checks fail then :exc:`.CheckFailure` exception is raised to the :func:`.on_application_command_error` event. name_localizations: Dict[:class:`str`, :class:`str`] The name localizations for this command. The values of this should be ``"locale": "name"``. See `here `_ for a list of valid locales. description_localizations: Dict[:class:`str`, :class:`str`] The description localizations for this command. The values of this should be ``"locale": "description"``. See `here `_ for a list of valid locales. integration_types: Set[:class:`IntegrationType`] The type of installation this command should be available to. For instance, if set to :attr:`IntegrationType.user_install`, the command will only be available to users with the application installed on their account. Unapplicable for guild commands. contexts: Set[:class:`InteractionContextType`] The location where this command can be used. Unapplicable for guild commands. z&list[SlashCommand | SlashCommandGroup]__initial_commands__r)ct||}|j|_g|_|j j D]\}}t|trat|jvrO||j|j0tj|jjdnd}t|t tfs||_d|_|jj'||S)NrrHT)r@rArBrr__dict__rurkrr; __bases__rrJrrKrLr5rrMr)rDrRrSrrrrs rWrAzSlashCommandGroup.__new__sws##);;= $&!LL&&( 4DAq!T"'8AKK'GJJ;;2 ((5@@B1E6 !l,=>?&*#))003 4 r^c t||_|xsd|_t|jt |jt j |_|j|_ ||_ ||_ d|_ |jdg|_d|_d|_d|_d|_|jdd|_|jdd|_|jdd}|jdd} |jdt*} | t*ur t-ddd | r | r t/d |jr| | s|r t/d | |_| r| |_||_|jd t*|_|jd t*|_ddlm} m} m } || || jB}ntE|| r|}n tGd||_$|tE|| s tGd||_%y)NrHFrrrrrrrrrrtr}rrrz=max_concurrency must be an instance of MaxConcurrency or None)&r1rsr|rrr{rsub_command_grouprlr subcommandsrrrMrrr rrrrrr#r(rrrrrtr}rrrCrDrrkrrra)rrsr|rrrrrSrrrrrCrDrs rWrzSlashCommandGroup.__init__sI &C*C +'(8(890BB  % % # ',jj2. "!?Ejj ($? '"(FD!9 "JJ':DA::j$/ZZ g6 W $ L*e <  !T  >>  !j4E!h  =E +5DO>O28** '3 :@ ': & YX  %h 0B0BCG / 2GL *1   &z ^0 O 8Gr^c|jSrN)rrs rWrzSlashCommandGroup.module$s r^ctdddtj|jvxrt |jdk(S)Nrrrr)rrs rWrzSlashCommandGroup.guild_only(s7 j%8%++t}}<XT]]ASWXAXXr^ctddd|rtjh|_ytjtjtj h|_y)Nrrrrrs rWrzSlashCommandGroup.guild_only-sG j%8 399:DM',,&--&66DMr^c|j|j|jDcgc]}|jc}d}|jt ur|j|d<|j t ur|j |d<|j|jj|d<|j|j|d<|j|jj|d<|jsZ|jN|jDcgc]}|jc}|d<|jDcgc]}|jc}|d<|Scc}wcc}wcc}wr)rsr|rr(rtr#r}rrlrrrrrr)rrrrrfs rWr(zSlashCommandGroup.to_dict9s/II++-1-=-=> >   " "' 1,0,C,CG( )  ) ) 8373Q3QG/ 0 ;; ""oo33GFO 99 "iiGFO  * * 6//55 0 1~~$++"5?C?U?U+VBHH+VG' (8< "F399"FGJ -?&,W"FsEE5Ec|j|j|j|_|jj|yrN)rrrrr:s rW add_commandzSlashCommandGroup.add_commandUs4 ;; 488#7((GK (r^c dfd }|S)Nc@|fdi}j||S)Nr)r)rlr:rDrSrs rWwrapz'SlashCommandGroup.command..wrap^s*$6t6v6G   W %Nr^)r.rEr)rrDrSrs``` rWr:zSlashCommandGroup.command[s   r^c |j tdt|||fd|i|}|jj ||S)au Creates a new subgroup for this SlashCommandGroup. Parameters ---------- name: :class:`str` The name of the group to create. description: Optional[:class:`str`] The description of the group to create. guild_ids: Optional[List[:class:`int`]] A list of the IDs of each guild this group should be added to, making it a guild command. This will be a global command if ``None`` is passed. guild_only: :class:`bool` Whether the command should only be usable inside a guild. nsfw: :class:`bool` Whether the command should be restricted to 18+ channels and users. Apps intending to be listed in the App Directory cannot have NSFW commands. default_member_permissions: :class:`~discord.Permissions` The default permissions a member needs to be able to run the command. checks: List[Callable[[:class:`.ApplicationContext`], :class:`bool`]] A list of predicates that verifies if the command could be executed with the given :class:`.ApplicationContext` as the sole parameter. If an exception is necessary to be thrown to signal failure, then one inherited from :exc:`.ApplicationCommandError` should be used. Note that if the checks fail then :exc:`.CheckFailure` exception is raised to the :func:`.on_application_command_error` event. name_localizations: Dict[:class:`str`, :class:`str`] The name localizations for this command. The values of this should be ``"locale": "name"``. See `here `_ for a list of valid locales. description_localizations: Dict[:class:`str`, :class:`str`] The description localizations for this command. The values of this should be ``"locale": "description"``. See `here `_ for a list of valid locales. Returns ------- SlashCommandGroup The slash command group that was created. z8A subcommand group cannot be added to a subcommand groupr)rrQr;rr)rrsr|rrSrs rWcreate_subgroupz!SlashCommandGroup.create_subgroupesZ\ ;; "VW W- +y 15 9?   12  r^c dfd }|S)a+A shortcut decorator that initializes the provided subclass of :class:`.SlashCommandGroup` as a subgroup. .. versionadded:: 2.0 Parameters ---------- name: Optional[:class:`str`] The name of the group to create. This will resolve to the name of the decorated class if ``None`` is passed. description: Optional[:class:`str`] The description of the group to create. guild_ids: Optional[List[:class:`int`]] A list of the IDs of each guild this group should be added to, making it a guild command. This will be a global command if ``None`` is passed. Returns ------- Callable[[Type[SlashCommandGroup]], SlashCommandGroup] The slash command group that was created. c|xs |jxs>|j0tj|jj dnd}j ||S)NrrH)rr)rrJrrKrLr)rDgroupr|rrsrs rWinnerz)SlashCommandGroup.subgroup..innersm$ {{.$$S[[1<<>qA2# E   U #Lr^)rDztype[SlashCommandGroup]r.r;r)rrsr|rr s```` rWsubgroupzSlashCommandGroup.subgroups6   r^c&K|jjdd|jjjdd}tfd|j}|d<|j_|j |d{y7w)NrIrrc(|jdk(Srrrrvs rWrz+SlashCommandGroup._invoke..6&>!9r^)rrrr%rr)rrfrr:rvs @rWrzSlashCommandGroup._invokesw%%i03??''++J=94;K;KL%z%nnS!!!sBB B BcK|jjddtfd|j}|j_|j |d{y7w)NrIrc(|jdk(Srrr s rWrz@SlashCommandGroup.invoke_autocomplete_callback..rr^)rrr%rr)rrfr:rvs @rWrz.SlashCommandGroup.invoke_autocomplete_callbacksS%%i0394;K;KL%223777sAA&A$A&cK|j}|jNt|jd|}|r|j||d{y|j|d{yy7 7wr)rr rrrfrrs rWrz#SlashCommandGroup.call_before_hooksslhh    *t22JDH))(C888))#... + 9.$AA. A* A.#A,$A.,A.cK|j}|jNt|jd|}|r|j||d{y|j|d{yy7 7wr)rrrrs rWrdz"SlashCommandGroup.call_after_hookssjhh    )t11:sCH((3777((--- *8-rc#K|jD].}t|tr|jEd{|0y7 w)aAn iterator that recursively walks through all slash commands and groups in this group. Yields ------ :class:`.SlashCommand` | :class:`.SlashCommandGroup` A nested slash command or slash command group from the group. N)rrkr; walk_commandsrs rWrzSlashCommandGroup.walk_commandssB'' G'#45"00222M 2s3AA Ac |jd|j|jd|jj Dcic] \}}|dvr||c}}}|j |Scc}}w)zCreates a copy of this command group. Returns ------- :class:`SlashCommandGroup` A new instance of this command group. )rsr|r)rrsr|rrur)rparamrrTs rWrBzSlashCommandGroup.copys~dnn (( %)$<$<$B$B$D E5 77u  ..s33 sA+cL|j|_|j|_|j|_|j|jk7r|jj |_|j |j k7r|j j |_|SrN)rr rrrBrrs rWrz,SlashCommandGroup._ensure_assignment_on_copy s}{{ #22"00   u00 0 $ 0 0 5 5 7E  ;;%,, &;;++-EL r^c|rN|j}|j|j|jdi|}|j |S|jS)Nr)rBrrrrrs rWrzSlashCommandGroup._update_copysR B IId.. /!4>>'B'D2248 899; r^cht|||jD]}|j|yrN)r@r,r)rr subcommandrs rWr,zSlashCommandGroup._set_cog#s3 ** %J    $ %r^)r.r;)NNNNN)rsr1r| str | Nonerlist[int] | NonerzSlashCommandGroup | NonerzCooldownMapping | NonerzMaxConcurrency | Noner.r/)r.rr2r5r)r:z SlashCommand | SlashCommandGroupr.r/)rDztype[T]r.z"Callable[[Callable], SlashCommand])NN)rsr1r|rrrr.r;)NNN)rsrr|rrrr.z6Callable[[type[SlashCommandGroup]], SlashCommandGroup]r7)rfr+r.r/)r.z7Generator[SlashCommand | SlashCommandGroup, None, None]r)rrrrJr:rrArr;rrr<r(rr5r:rr rrrrdrrBrrr,rrs@rWr;r;s-^A@ D2#'&*+/+/15XGXG XG$ XG ) XG ) XG/XG XGtYY  8)* +#'&* 5!5! 5!$ 5!  5!r "&&* ** *$ * @ *X"8 /. 4& %%r^r;cNeZdZdZdfd Zdfd ZdZedZd dZ xZ S) r<aP A class that implements the protocol for context menu commands. These are not created manually, instead they are created via the decorator or functional interface. .. versionadded:: 2.0 Attributes ----------- name: :class:`str` The name of the command. callback: :ref:`coroutine ` The coroutine that is executed when the command is called. guild_ids: Optional[List[:class:`int`]] The ids of the guilds where this command will be registered. guild_only: :class:`bool` Whether the command should only be usable inside a guild. .. deprecated:: 2.6 Use the ``contexts`` parameter instead. nsfw: :class:`bool` Whether the command should be restricted to 18+ channels and users. Apps intending to be listed in the App Directory cannot have NSFW commands. default_member_permissions: :class:`~discord.Permissions` The default permissions a member needs to be able to run the command. cog: Optional[:class:`Cog`] The cog that this command belongs to. ``None`` if there isn't one. checks: List[Callable[[:class:`.ApplicationContext`], :class:`bool`]] A list of predicates that verifies if the command could be executed with the given :class:`.ApplicationContext` as the sole parameter. If an exception is necessary to be thrown to signal failure, then one inherited from :exc:`.ApplicationCommandError` should be used. Note that if the checks fail then :exc:`.CheckFailure` exception is raised to the :func:`.on_application_command_error` event. cooldown: Optional[:class:`~discord.ext.commands.Cooldown`] The cooldown applied when the command is invoked. ``None`` if the command doesn't have a cooldown. name_localizations: Dict[:class:`str`, :class:`str`] The name localizations for this command. The values of this should be ``"locale": "name"``. See `here `_ for a list of valid locales. integration_types: Set[:class:`IntegrationType`] The installation contexts where this command is available. Unapplicable for guild commands. contexts: Set[:class:`InteractionContextType`] The interaction contexts where this command is available. Unapplicable for guild commands. cPt||}|j|_|SrNr?rCs rWrAzContextMenuCommand.__new__XrEr^cht||fi|tj|s t d||_|j dt|_d|_ t|jts t dd|_ d|_d|_d|_|j#d|_y)NrGrtz#Name of a command must be a string.)r@rrOrrrrr#rtr|rkrsr1rrr rvalidate_parametersr)rrlrRrSrs rWrzContextMenuCommand.__init__^s ((**40;< < 28** '3  $))S)AB B"!   " r^cH|j}t|jdddk(r5t|j}|jdt |}t |} t | t | t |td|jd #t$rtd|jdwxYw#t$r3t|tk(rdnd}td|jd|dwxYw#t$rYywxYw) NrrrWz$ command is missing "ctx" parameter.rmessagerXrYz! command has too many parameters.) rrrupoprrZr[r\rrsrr=)rrStempcmds rWr#z&ContextMenuCommand.validate_parametersxs$//1    "1 % / 'D HHQK$ZFf  L  L  L! {*KL # ! {*NO    J+5&9C! {*?uLQ     s*4 B0 C $D0#C` The coroutine that is executed when the command is called. guild_ids: Optional[List[:class:`int`]] The ids of the guilds where this command will be registered. guild_only: :class:`bool` Whether the command should only be usable inside a guild. .. deprecated:: 2.6 Use the ``contexts`` parameter instead. nsfw: :class:`bool` Whether the command should be restricted to 18+ channels and users. Apps intending to be listed in the App Directory cannot have NSFW commands. default_member_permissions: :class:`~discord.Permissions` The default permissions a member needs to be able to run the command. cog: Optional[:class:`Cog`] The cog that this command belongs to. ``None`` if there isn't one. checks: List[Callable[[:class:`.ApplicationContext`], :class:`bool`]] A list of predicates that verifies if the command could be executed with the given :class:`.ApplicationContext` as the sole parameter. If an exception is necessary to be thrown to signal failure, then one inherited from :exc:`.ApplicationCommandError` should be used. Note that if the checks fail then :exc:`.CheckFailure` exception is raised to the :func:`.on_application_command_error` event. cooldown: Optional[:class:`~discord.ext.commands.Cooldown`] The cooldown applied when the command is invoked. ``None`` if the command doesn't have a cooldown. name_localizations: Dict[:class:`str`, :class:`str`] The name localizations for this command. The values of this should be ``"locale": "name"``. See `here `_ for a list of valid locales. integration_types: Set[:class:`IntegrationType`] The installation contexts where this command is available. Unapplicable for guild commands. contexts: Set[:class:`InteractionContextType`] The interaction contexts where this command is available. Unapplicable for guild commands. rcPt||}|j|_|SrNr?rCs rWrAzUserCommand.__new__rEr^c\Kd|jjdvrf|jjdd}|jD]\}}t||d<|}t |jj }n|jjdd}|jD]\}}t||d<|}|jjdd}|jD]\}}t||d<|}d<|jj j j}|jj||d|}|j&|j|j||d{y|j||d{y7 7w)Nrrrrrr) rrrur9r"rrrrrr) rrfrrrrtargetmemberrs rWrzUserCommand._invokes COO00< <OO((4W=E  1a&$  6 6TBFOO((4Y?E  1a&$ OO((4W=E  1a&$ "F6N//BBNNJYY55fd4j*UF 88 --#v6 6 6--V, , , 7 ,s$FF,F(F,"F*#F,*F,cr|j|jfi|j}|j|S)zCreates a copy of this command. Returns ------- :class:`UserCommand` A new instance of this command. rrs rWrBzUserCommand.copyrr^c|j|_|j|_|j|jk7r|jj|_ |j|_|S#t $rY|SwxYwrNrrs rWrz&UserCommand._ensure_assignment_on_copyrrc|rY|j}|j|j|j|jfi|}|j |S|jSrNrrs rWrzUserCommand._update_copy rr^)r.r=r7r rrrrJrrArrBrrrrs@rWr=r=s)*X D -0 4"r^r=cDeZdZdZdZdfd Zd dZdZdZd dZ xZ S) r>a= A class that implements the protocol for message context menu commands. These are not created manually, instead they are created via the decorator or functional interface. Attributes ----------- name: :class:`str` The name of the command. callback: :ref:`coroutine ` The coroutine that is executed when the command is called. guild_ids: Optional[List[:class:`int`]] The ids of the guilds where this command will be registered. guild_only: :class:`bool` Whether the command should only be usable inside a guild. .. deprecated:: 2.6 Use the ``contexts`` parameter instead. nsfw: :class:`bool` Whether the command should be restricted to 18+ channels and users. Apps intending to be listed in the App Directory cannot have NSFW commands. default_member_permissions: :class:`~discord.Permissions` The default permissions a member needs to be able to run the command. cog: Optional[:class:`Cog`] The cog that this command belongs to. ``None`` if there isn't one. checks: List[Callable[[:class:`.ApplicationContext`], :class:`bool`]] A list of predicates that verifies if the command could be executed with the given :class:`.ApplicationContext` as the sole parameter. If an exception is necessary to be thrown to signal failure, then one inherited from :exc:`.ApplicationCommandError` should be used. Note that if the checks fail then :exc:`.CheckFailure` exception is raised to the :func:`.on_application_command_error` event. cooldown: Optional[:class:`~discord.ext.commands.Cooldown`] The cooldown applied when the command is invoked. ``None`` if the command doesn't have a cooldown. name_localizations: Dict[:class:`str`, :class:`str`] The name localizations for this command. The values of this should be ``"locale": "name"``. See `here `_ for a list of valid locales. integration_types: Set[:class:`IntegrationType`] The installation contexts where this command is available. Unapplicable for guild commands. contexts: Set[:class:`InteractionContextType`] The interaction contexts where this command is available. Unapplicable for guild commands. r.cPt||}|j|_|SrNr?rCs rWrAzMessageCommand.__new__YrEr^c4K|jjdd}|jD]\}}t||d<|}|jj}|j tdk7r-t |jjt|d}t|jj||}|j&|j|j||d{y|j||d{y7 7w)Nrmessagesr channel_id)rr)rrr) rrrur9rrrrrrr)rrfrrrr%rr.s rWrzMessageCommand._invoke_s$$Z0<KKM DAq!fAdGG //)) ::W\23 3(oo,,W\5J1KGs55wWU 88 --#v6 6 6--V, , , 7 ,s$C1D3D4DDDDcr|j|jfi|j}|j|S)zCreates a copy of this command. Returns ------- :class:`MessageCommand` A new instance of this command. rrs rWrBzMessageCommand.copyrrr^c|j|_|j|_|j|jk7r|jj|_ |j|_|S#t $rY|SwxYwrNrrs rWrz)MessageCommand._ensure_assignment_on_copy}rrc|rY|j}|j|j|j|jfi|}|j |S|jSrNrrs rWrzMessageCommand._update_copyrr^)r.r>r6rr3rs@rWr>r>*s)*X D -& 4"r^r>c $tddti|S)zDecorator for slash commands that invokes :func:`application_command`. .. versionadded:: 2.0 Returns ------- Callable[..., :class:`.SlashCommand`] A decorator that converts the provided method into a :class:`.SlashCommand`. rDr)r7r5rSs rWr6r6s  :< :6 ::r^c $tddti|S)zDecorator for user commands that invokes :func:`application_command`. .. versionadded:: 2.0 Returns ------- Callable[..., :class:`.UserCommand`] A decorator that converts the provided method into a :class:`.UserCommand`. rDr)r7r=r=s rWr8r8s  9; 9& 99r^c $tddti|S)aDecorator for message commands that invokes :func:`application_command`. .. versionadded:: 2.0 Returns ------- Callable[..., :class:`.MessageCommand`] A decorator that converts the provided method into a :class:`.MessageCommand`. rDr)r7r>r=s rWr9r9s  <> .decorators@ d. /==D$R 4!5!!r^)rlrr.rDr)rDrCrDs`` rWr7r7s@" r^c tdi|S)aCAn alias for :meth:`application_command`. .. note:: This decorator is overridden by :func:`ext.commands.command`. .. versionadded:: 2.0 Returns ------- Callable[..., :class:`.ApplicationCommand`] A decorator that converts the provided method into an :class:`.ApplicationCommand`. r)r7r=s rWr:r:s  ( ((r^z#https://discord.com/developers/docs)dadezen-GBzen-USzes-ESfrhrrlthunlnoplzpt-BRrofizsv-SEvitrcselbgruukhithzzh-CNjazzh-TWkocf||tvrtd|dtdd}t|tst d|d}nOt jd|stdtd|d}n"|j|k7rtd |d}|r|r|jd d |f|_ |y) NLocale '' is not a valid locale, see 1/reference#locales for list of supported locales.z9Command names and options must be of type str. Received ""z*^[-_\w\d\u0901-\u097D\u0E00-\u0E7F]{1,32}$zzCommand names and options must follow the regex \"^[-_\w\d\u0901-\u097D\u0E00-\u0E7F]{1,32}$\". For more information, see zd/interactions/application-commands#application-command-object-application-command-naming. Received "z7Command names and options must be lowercase. Received "r in locale ) valid_localesrdocsrkr1rrematchlowerrR)rsrqrs rWrrrrs fM9vh;D6B* *   E dC GvQ O XXCT J v559F!  =  EdV1 M  "ZZ]O;vh?AEJ  r^c||tvrtd|dtdd}t|tst d|d}n%dt |cxkrdksntd|d}|r|r|jd d |f|_|y) Nr]r^r_z>Command and option description must be of type str. Received "r`r)dzHCommand and option description must be 1-100 characters long. Received "rra)rbrrcrkr1rrrR)r|rqrs rWr{r{@s fM9vh;D6B* *   E k3 '  Q  #k" )c )  Q    "ZZ]O;vh?AEJ  r^)rmCallable[..., Any]r.rirN)rsrrqr)r|rrqr)jrJ __future__rrOrr[rrdsysr collectionsrenumrtypingrrrr r r r r rrrenumsrprrrrrerrorsrrrrrrr/rr%rrobjectrrr threadsr!rr"utilsr#r$r%r&r'r(rVr*r+rIr,r- version_infor0r1r2typing_extensions__all__r?r@r"rArrBrrCrDrErFrHrIr]rgrnryr~r3r4r5r;r<r=r>r6r8r9r7r:rcrbrrr{rr^rWrws2# #   J')VV<)w66AA 8H CLvU#vXc9S#s]+C&CDE#A A(6<C[wtQz':[|d%dNe%*e%P K+K\p$pfk'k\ ; : =))X ) - FBr^