iH dZddlmZddlZddlmZmZmZmZm Z m Z m Z m Z m Z mZmZmZmZmZmZmZmZddlZddlmZddlmZmZmZmZdd lmZm Z dd l!m"Z"dd l#m$Z$m%Z%m&Z&dd l'm(Z(m)Z)m*Z*m+Z+m,Z,dd l-m.Z.m/Z/m0Z0m1Z1ddl2m3Z3ddl4m5Z5ddl6m7Z7ddl8m9Z9ddl:m;Z;mZ>m?Z?m@Z@mAZAerOddlBmCZCmDZDmEZEddlFmGZGddlHmIZIddlJmKZKddl!mLZLddlMmNZNddlOmPZPddlQmRZRddlSmTZTeeGe(geeedffZUdZVer eCdZWn edZWedZXeded ef!ZYed"d#!ZZeeeeXfZ[ed$e(ge[efZ\eeeZd$e(ge[efe\fZ]ed$gee^e[e^ffZ_ed%Z`ereeeDeZd$eWfe[eXfeeDd$eWfe[eXffZaeed$e7ge[efed$e5ge[efed$e3ge[efed$ee7e5fge[effZbeeeZd$ecge[e e"eLfed$ecge[e e"eLffZdn0ed e[eXfZaed e[eXfZbed e[eXfZded&d'd(ebfZed)Zfd*Zgejhd+efzegzd,zZid-Zjd.Zkd/Zlejhd0ejd1eld2ekejmZnejhd3ejd4ekejmZoejhd0ejd5eld6ekejmZpdd=Zqdd@ZrddAZsddDZte&dEddKZuddOZvddRZwddUZxddWZyddYZzdd\Z{dd]Z|Gd^d_Z}Gd`dae eZeWeXfZ~Gdbd'ZGdcddZe\w+)z3(?P(?:.|\n)+?(?:\Z|\r?\n(?=[\S\r\n])))z(?:.+)^z [ \t]*(?:\(z\))?[ \t]*:[ \t]*z^:param z:[ \t]+z(?:[ \t]*:)?(?:[ \t]+z)?[ \t]*\r?\n[ \t]+funcCallable[..., Any]paramsDict[str, CommandParameter]returnDict[str, str]cptj|}|iStjdd|D}t |t|t|f}fd|DS)N c3DK|]}|d|VdS)z N) startswith).0lines ^/usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages/discord/app_commands/commands.py z-_parse_args_from_docstring..s7.p.pZ^ZiZijnZoZo.pt.p.p.p.p.p.pci|]G}|D]B}|dv|d|dCHS)name description)group)rhmatchesmr`s rj z._parse_args_from_docstring..sf   4;Y`  TUdedkdklrdsdsw}d}d}//d}d}d}d}rl) inspectgetdoccleandocjoin splitlinesGOOGLE_DOCSTRING_ARG_REGEXfinditerSPHINX_DOCSTRING_ARG_REGEXNUMPY_DOCSTRING_ARG_REGEX)r^r` docstring section_linesdocstring_styless ` rj_parse_args_from_docstringrst$$I $TYY.p.p @T@T@V@V.p.p.p%p%pqqM"++M::"++I66!**955     ?O   rlrnstrct|}|t|d||krt|d|S)Nzg must be between 1-32 characters and contain only lower-case letters, numbers, hyphens, or underscores.z must be all lower-case)VALID_SLASH_COMMAND_NAMEmatch ValueErrorlower)rnrs rj validate_namersi $ * *4 0 0E } ~ ~ ~    zz||tD;;;<<< KrlcN|rt|dkrtd|S)N z2context menu names must be between 1-32 characters)lenrrns rjvalidate_context_menu_namers- O3t99r>>MNNN Krlcallback%AutocompleteCallback[GroupT, ChoiceT]ct|dd}|duot|}|||_d|z}tj|j}t ||krtd|jd|S)N__self__rzautocomplete callback z/ requires either 2 or 3 parameters to be passed) getattrr2pass_command_bindingrt signature parametersr TypeError __qualname__)rbindingrrequired_parametersr`s rjvalidate_auto_complete_callbackrsh D11G"d?Hx/H/H(<%22  x ( ( 3F 6{{)))y1Fyyyzzz Orl)_none annotationrrtypercD|tur tjStth|vr tjSt |dd}|turd|d}t|tfd|j Dstd|tjS)N __origin__zunsupported type annotation zt, must be either discord.Member, discord.User, discord.Message, or a typing.Union of discord.Member and discord.Userc3 K|]}|vV dSN)rhargsupported_typess rjrkz+_context_menu_annotation..s(EE#so%EEEEEErlzunsupported types given inside ) r+rmessager-r,userrrrall__args__)rroriginmsgrs @rj_context_menu_annotationrsW%%!'O_$$""Zt 4 4F U b: b b b nn EEEE1DEEE E EJH*HHIII  rl descriptionsDict[str, Any]Nonec|D]\}}||t}|turd|_1t |t t fstdt |t rt||_||_|r.tt|}td|dS)N…zdescription must be a stringunknown parameter given: ) itemspopr1ro isinstancerr*rr5nextiter)r`rrnparamrofirsts rj_populate_descriptionsrs||~~ , , e"&&tW55 ' ! ! %E  +Z'899 <:;; ; k3 ' ' , ( 5 5E   +E  =T,''((;E;;<<<==rlrenames!Dict[str, Union[str, locale_str]]ci}|D]}||t}|tur|||<,||vrt|dt |t rt |}nt |j|||<|||_|r.tt|}td|dS)Nz is already usedr) keysrr1rrrrr_renamerr)r`r rename_maprnnew_namers rj_populate_renamesr"s46J ((;;tW-- w  #Jt   :  :::;; ; h $ $ ,$X..HH (* + + +# 4't >T']]##>rl all_choicesDict[str, List[Choice]]cR|D]\}||t}|tur*t|tst dt d|Dst djtj tj tj fvrt dt fd|Dst d|_ |r.tt|}t d|dS)Nz choices must be a list of Choicec3@K|]}t|tVdSr)rr)rhchoices rjrkz$_populate_choices..Gs,DD&:ff--DDDDDDrlzFchoices are only supported for integer, string, or number option typesc38K|]}j|jkVdSr)r _option_type)rhrrs rjrkz$_populate_choices..Ms-KK5:!44KKKKKKrlzMchoices must all have the same inner option type as the parameter choice typer)rrr1rlistrrrrstringnumberintegerrKrr)r`rrnrKrrs @rj_populate_choicesr>s;||~~  e//$00 g   '4(( @>?? ?DDGDDDDD @>?? ? :29;O;VXlXtu u udee eKKKK7KKKKK mkll l =T+&&'';E;;<<<==rlrLc |D]\}}||t}|tur*tj|st d|jtjtj tj fvrt d| rt dt||_ |r.tt|}t d|dS)Nz2autocomplete callback must be a coroutine functionJautocomplete is only supported for integer, string, or number option typesfChoice annotation unsupported for autocomplete parameters, consider using a regular annotation insteadr)rrr1rtiscoroutinefunctionrrrrrris_choice_annotationrrLrr)r`rLrnrrrs rj_populate_autocompleterWs||~~GG e##D'22 w   *844 RPQQ Q :29;O;VXlXtu u uhii i  % % ' ' x =XFF=T,''((;E;;<<<==rlglobalnsctj|j}i}t|dz}t ||krt d|jd|dz dt|}td|D]}t|g}|D]k}|j |j urt d|j d|jt|j |||} t| |} || lt#|dd } d | D} t%|| } | |jn*#t*$r| D]} | jt.urd | _YnwxYw| rt1| |  |j}t5| |n#t*$rYnwxYw |j}t;| |n#t*$rYnwxYw |j}t?| |n#t*$rYnwxYw| S) Nrz callback z must have more than z parameter(s)rz parameter z* is missing a type annotation in callback c|jSr)required)as rjz3_extract_parameters_from_callback..sajrlT)keyreverseci|] }|j| Srr)rhvs rjrsz5_extract_parameters_from_callback..s ( ( (Aafa ( ( (rlr) rtrrr2rrrrvaluesrangerremptyrnr0rappendsortedrupdate*__discord_app_commands_param_description__AttributeErrorror1r%__discord_app_commands_param_rename__rr&__discord_app_commands_param_choices__r+__discord_app_commands_param_autocomplete__r)r^rr`cacherequired_paramsiterator_r parameterresolvedrrresultrrrKrLs rj!_extract_parameters_from_callbackros  t $ $ /F E%d++a/O 6{{_$$pD$5ppo`aNapppqqqFMMOO$$H 1o & & X)+J!!  9? 2 2zzzeievzz{{ {%i&:HhPUVV')<<%    J$8$8$ G G GF ( ( ( ( (F-dF;;L*DKLLLL *** * *E G++$)! * **5v|4442< &',,..1111      2= &',,..1111      <G  v|'8'8':':;;;;      MsHE$FFG GGG?? H  H H:: IIContextMenuCallbackTuple[str, Any, AppCommandType]c,tj|j}t|rt |dst dt |dkrd|jd}t |t| }t|t|}|j |j urd|jd}t |t|j |j|ji}t|}|j||fS)Nrz.context menus cannot be defined inside a classrzcontext menu callback z requires 2 parameters, the first one being the interaction and the other one explicitly annotated with either discord.Message, discord.User, discord.Member, or a typing.Union of discord.Member and discord.Userz*second parameter of context menu callback z must be explicitly annotated with either discord.Message, discord.User, discord.Member, or a typing.Union of discord.Member and discord.User)rtrrr2hasattrrrrrrrrrr0 __globals__rrn)r^r`rrrrrs rj_get_context_menu_parameterrs,  t $ $ /FtJWT:%>%>JHIII 6{{a CT%6 C C C nnFMMOO$$HNNNXIy.. @9J @ @ @ nn!)"68H$JZ\^__H #H - -D NHd ++rlcd|_|Sr)&__discord_app_commands_base_function__r^s rjmark_overrideablers26D/ KrlcjeZdZdZd dZed!d Zed"d Zed"d Zed#dZ ed"dZ ed$dZ ed$dZ ed#dZ ed%dZed&dZed'dZed(dZed)dZed)dZdS)*rEaA class that contains the parameter information of a :class:`Command` callback. .. versionadded:: 2.0 Attributes ----------- name: :class:`str` The name of the parameter. This is the Python identifier for the parameter. display_name: :class:`str` The displayed name of the parameter on Discord. description: :class:`str` The description of the parameter. autocomplete: :class:`bool` Whether the parameter has an autocomplete handler. locale_name: Optional[:class:`locale_str`] The display name's locale string, if available. locale_description: Optional[:class:`locale_str`] The description's locale string, if available. required: :class:`bool` Whether the parameter is required choices: List[:class:`~discord.app_commands.Choice`] A list of choices this parameter takes, if any. type: :class:`~discord.AppCommandOptionType` The underlying type of this parameter. channel_types: List[:class:`~discord.ChannelType`] The channel types that are allowed for this parameter. min_value: Optional[Union[:class:`int`, :class:`float`]] The minimum supported value for this parameter. max_value: Optional[Union[:class:`int`, :class:`float`]] The maximum supported value for this parameter. default: Any The default value of the parameter, if given. If not given then this is :data:`~discord.utils.MISSING`. command: :class:`Command` The command this parameter is attached to. parentr rGr\rbrc"||_||_dSr)_Parameter__parent_Parameter__command)selfrrGs rj__init__zParameter.__init__s*0 18rlc|jSr)rrs rjrGzParameter.commands ~rlrc|jjSr)rrnrs rjrnzParameter.name }!!rlc|jjSr)r display_namers rjrzParameter.display_names }))rlboolc|jjSr)rrrs rjrzParameter.requireds }%%rlc4t|jjSr)rrrors rjrozParameter.descriptions4=,---rlOptional[locale_str]c\t|jjtr |jjSdSr)rrrr*rs rj locale_namezParameter.locale_name s) dm+Z 8 8 )=( (trlc\t|jjtr |jjSdSr)rrror*rs rjlocale_descriptionzParameter.locale_descriptions) dm/ < < -=, ,trlc|jjduSr)rrLrs rjrLzParameter.autocompletes})55rlrc|jjSr)rdefaultrs rjrzParameter.defaults }$$rlrc|jjSr)rrrs rjrzParameter.typerrl$List[Choice[Union[int, float, str]]]cX|jj}|turgS|Sr)rrKr1r)rrKs rjrKzParameter.choices"s*-' g  I||~~rlList[ChannelType]cX|jj}|turgS|Sr)r channel_typesr1r)rrs rjrzParameter.channel_types)s. 3 G # #I!!###rlOptional[Union[int, float]]c|jjSr)r min_valuers rjrzParameter.min_value0 }&&rlc|jjSr)r max_valuers rjrzParameter.max_value4rrlN)rr rGr\rbr)rbr\rbrrbr)rbr )rbr)rbr)rbr)rbr)rbr)__name__ __module__r__doc__rpropertyrGrnrrror rrLrrrKrrrrrlrjrErEs##J9999X"""X"***X*&&&X&...X.X X 666X6%%%X%"""X"X $$$X$ '''X''''X'''rlrEc$eZdZdZddddddeddOdZdPdZdQdZedRd Z edd!dSd'Z dTd-Z dUd.Z dVd3Z dWd4ZdXd7ZdYd:ZdZd;Zd[d<Zd\d>Zed]d@Zd^dBZed_dCZed`dDZdadEZdbdHZdcdJZdddMZdddNZdS)erBaA class that implements an application command. These are usually not created manually, instead they are created using one of the following decorators: - :func:`~discord.app_commands.command` - :meth:`Group.command ` - :meth:`CommandTree.command ` .. versionadded:: 2.0 Parameters ----------- name: Union[:class:`str`, :class:`locale_str`] The name of the application command. description: Union[:class:`str`, :class:`locale_str`] The description of the application command. This shows up in the UI to describe the application command. callback: :ref:`coroutine ` The coroutine that is executed when the command is called. auto_locale_strings: :class:`bool` If this is set to ``True``, then all translatable strings will implicitly be wrapped into :class:`locale_str` rather than :class:`str`. This could avoid some repetition and be more ergonomic for certain defaults such as default command names, command descriptions, and parameter names. Defaults to ``True``. nsfw: :class:`bool` Whether the command is NSFW and should only work in NSFW channels. Defaults to ``False``. Due to a Discord limitation, this does not work on subcommands. parent: Optional[:class:`Group`] The parent application command. ``None`` if there isn't one. extras: :class:`dict` A dictionary that can be used to store extraneous data. The library will not touch any values or keys within this dictionary. Attributes ------------ name: :class:`str` The name of the application command. description: :class:`str` The description of the application command. This shows up in the UI to describe the application command. checks A list of predicates that take a :class:`~discord.Interaction` parameter to indicate whether the command callback should be executed. If an exception is necessary to be thrown to signal failure, then one inherited from :exc:`AppCommandError` should be used. If all the checks fail without propagating an exception, :exc:`CheckFailure` is raised. default_permissions: Optional[:class:`~discord.Permissions`] The default permissions that can execute this command on Discord. Note that server administrators can override this value in the client. Setting an empty permissions field will disallow anyone except server administrators from using the command in a guild. Due to a Discord limitation, this does not work on subcommands. guild_only: :class:`bool` Whether the command should only be usable in guild contexts. Due to a Discord limitation, this does not work on subcommands. allowed_contexts: Optional[:class:`~discord.app_commands.AppCommandContext`] The contexts that the command is allowed to be used in. Overrides ``guild_only`` if this is set. .. versionadded:: 2.4 allowed_installs: Optional[:class:`~discord.app_commands.AppInstallationType`] The installation contexts that the command is allowed to be installed on. .. versionadded:: 2.4 nsfw: :class:`bool` Whether the command is NSFW and should only work in NSFW channels. Due to a Discord limitation, this does not work on subcommands. parent: Optional[:class:`Group`] The parent application command. ``None`` if there isn't one. extras: :class:`dict` A dictionary that can be used to store extraneous data. The library will not touch any values or keys within this dictionary. FNT)nsfwr guild_idsrQrTauto_locale_stringsextrasrnUnion[str, locale_str]rorCommandCallback[GroupT, P, T]r%rrOptional[Group]r&Optional[List[int]]rQOptional[AppCommandContext]rTOptional[AppInstallationType]r'r(Dict[Any, Any]c t|tr |j|fn|df\}} t||_| |_t|tr |j|fn|df\}} ||_| |_d|_||_ ||_ d|_ d|_ |j |_ |j|_ |jx|_ }n#t"$rYnwxYwt%||j|_t+|dg|_||_|jt+|dd|_t+|dd|_t+|dd|_|pt+|dd|_|pt+|dd|_||_| pi|_|j|j t=d| r|dSdS) N__discord_app_commands_checks__'__discord_app_commands_default_guilds__,__discord_app_commands_default_permissions__#__discord_app_commands_guild_only__F!__discord_app_commands_contexts__+__discord_app_commands_installation_types__zZchild commands cannot have default guilds set, consider setting them in the parent instead) rr*rrrn _locale_namero_locale_description_attr _callbackrron_errorr!moduler__func__rrr_paramsrchecks _guild_idsrUrNrQrTr%r(r_convert_to_locale_strings) rrnrorr%rr&rQrTr'r(locales rjrzCommand.__init__s 0:$ /K/K] d++RVX\Q] f&t,, 282<[*2U2U n[ + . .\gim[n  V!,9? $( 8@'- )- 15 %-%8  #,DL(0(9 9DNXX    D 5VV^`h`t4u4u #*85VXZ#[#[ /8 ? "%h0Y[_``DO:A Dd; ;  !(2WY^ _ _=M> QX 94R R @P@ SZ CTT T  &,l ? &4;+Byzz z  .  + + - - - - - . .s$B?? C  C rbrc|jt|j|_|jt|j|_|jD]}|dSr)r7r*rnr8ror>rrA)rrs rjrAz"Command._convert_to_locale_stringssu   $ *49 5 5D   # +'1$2B'C'CD $\((** / /E  , , . . . . / /rlowner Type[Any]rc||_dSr)r9rrDrns rj __set_name__zCommand.__set_name__s  rlc|jS)zX:ref:`coroutine `: The coroutine that is executed when the command is called.r:rs rjrzCommand.callback ~rlbindingsset_on_bindingrrZrMMutableMapping[GroupT, GroupT]rNc |turin|}t|}|j|_||_|j||jn||_|jr|rt|j|j||Sr) r1 shallow_copyr>rrrgetr9setattr)rrrrMrNrs rj _copy_withzCommand._copy_withs"W,,22(D!!|((**  59\5Mx||DL111SZ : 4. 4 DL$*d 3 3 3 rltreeCommandTree[ClientT] translatorr)rcK|}i}i}ttj}ttj}t D]l}jr.j||d{V} | | ||j<j r.j ||d{V} | | ||j<m||d<||d<fdj Dd{V|d<|S)Nlocationdataname_localizationsdescription_localizationsc hKg|],}|t|d{V-Sr)get_translated_payloadrE)rhrrrWs rj z2Command.get_translated_payload..sV   W\%..z9UD;Q;QRR R R R R R R   rloptions) to_dictr(r' command_namecommand_descriptionrr7_checked_translatevaluer8r>r rrUrWbaser\r] name_contextdescription_contextrB translations ` ` rjr_zCommand.get_translated_payloads}||D!!-/46!*3M3Zaefff 0:T:hosttt J JF  C$.$A$A$BSU[]i$j$jjjjjjj *7B&v|4' J$.$A$A$BZ\bdw$x$xxxxxxx *>I-fl;%7 !",E ()     `d`l`s`s`u`u         Y rlc|jtjjntjj}|j|j|d|j Dd}|jq|j |d<|j |d<|j dn |j j|d<|j |j |d<|j|j|d<|S)Nc6g|]}|Srrbrhrs rjr`z#Command.to_dict..s KKKE KKKrlrnrorrar% dm_permissiondefault_member_permissionscontextsintegration_types)rr chat_inputrfr subcommandrnror>rr%rNrUrQ_merge_to_arrayrTrrU option_typerhs rjrbzCommand.to_dict s:>9Ln/55RfRqRw I+KKT\5H5H5J5JKKK    ; 9DL(,$7D !9=9Q9Y_c_w_}D- .#4DDTEZ[[D (,(=(M(MdNc(d(dD$ % rl interactionr:errorr"cK|jF|j#||j||d{Vn|||d{V|j}|D|||d{V|j!|j||d{Vt|jdd}||||d{VdSdS)N&__discord_app_commands_error_handler__)r;rrr)rrzr{rbinding_error_handlers rj_invoke_error_handlerszCommand._invoke_error_handlerss = $|'mmDL+uEEEEEEEEEEmmK777777777  //+u55 5 5 5 5 5 5 5}(m,,[%@@@@@@@@@ ' 6^`d e e ,'' U;; ; ; ; ; ; ; ; ; ; - ,rlc|jdS|j}|:t|jdsdS|jt|jjdsdSt|jdddSdS)NTrr}F)r;rrrrrrs rj_has_any_error_handlerszCommand._has_any_error_handlers0s| = $4  6?,TUU t}(v}57_`` 4 4rr transformrnKeyErrorrrr%)rrzrrtransformed_valuesrrfs rj_transform_argumentszCommand._transform_argumentsDs#\((** [ [E [u128={TY7Z7Z1Z1Z1Z1Z1Z1Z"5:..  C C C~C5:]&uz222488dB32 C"!s A1B Br`rWcK |j|j|j|fi|d{VS|j|fi|d{VS#t$r`}tjdj}|jd|urt|dt|||d}~wt$rt$r}t|||d}~wwxYw)Nr) rr:rrttraceframef_localsrRr%r$r" Exception)rrzr`ers rj_do_callzCommand._do_callUs 5|'+T^DL+PPPPPPPPPPP' >>v>>>>>>>> > 5 5 5MOOB'-E~!!&))T11.t44$>$T1--1 4     5 5 5$T1--1 4 5s& 99 C ABC 5CC cK||d{Vstd|jd|||d{V}|||d{VS)Nz The check functions for command  failed.)_check_can_runr#rnrr)rrzrrs rj_invoke_with_namespacezCommand._invoke_with_namespaceos((55555555 YW$)WWWXX X#'#<#<[)#T#TTTTTTT]];0BCCCCCCCCCrlcK|j|} |j|}n[#t$rNd|jD} ||}n#t$rt |dwxYwYnwxYw|jt |t |jdg}|rr tfd|Dd{V}n#t$rd}YnwxYw|s;j s j gd{VdSt |jddr6|j } | || |d{V} n+td||d{V} j rdSj | d{VdS)Nci|] }|j| Sr)rros rjrsz0Command._invoke_autocomplete..sSSSEe(%SSSrlr1c3.K|]}|VdSrrrhfrzs rjrkz/Command._invoke_autocomplete..s+(L(LA;(L(L(L(L(L(LrlFrzOautocomplete parameter expected a bound self parameter but one was not provided) rr>rrr%rLrr4rresponseis_donerr) rrzrnrrfrr` predicatespassedrrKs ` rj_invoke_autocompletezCommand._invoke_autocompletevs_"4( ?L&EE ? ? ?SST\=P=P=R=RSSSF ?t  ? ? ?.t44$> ?  ?   %*400 0U/1RTVWW   ((L(L(L(L(L(L(LLLLLLLLL     "+3355@%.;;B????????? 5%'=u E E ClG" % 2 27K O OOOOOOO qrrr!..{EBBBBBBBBG   ' ' ) )  F"//88888888888s9 -A8AA8A22A87A8*!C CCOptional[Union[Command, Group]]cdSrrrrns rj_get_internal_commandzCommand._get_internal_commandstrlList[Parameter]cNfdjDS)zReturns a list of parameters for this command. This does not include the ``self`` or ``interaction`` parameters. Returns -------- List[:class:`Parameter`] The parameters of this command. c0g|]}t|Sr)rE)rhprs rjr`z&Command.parameters..s#BBBq !T""BBBrl)r>rrs`rjrzCommand.parameterss.CBBBDL,?,?,A,ABBBBrlOptional[Parameter]c^|j|}|t||SdS)aRetrieves a parameter by its name. The name must be the Python identifier rather than the renamed one for display on Discord. Parameters ----------- name: :class:`str` The parameter name in the callback function. Returns -------- Optional[:class:`Parameter`] The parameter or ``None`` if not found. N)r>rRrE)rrnrs rj get_parameterzCommand.get_parameters4"!!$''  VT** *trlc4|jdS|j}|jp|S)z:Optional[:class:`Group`]: The root parent of this command.Nrrs rj root_parentzCommand.root_parents% ; 4}&&rlc|j|jS|j|jjg}|jj}|||jdt |S)z:class:`str`: Returns the fully qualified command name. The qualified name includes the parent name as well. For example, in a command like ``/foo bar`` the qualified name is ``foo bar``. N )rrnrrwreversed)rnames grandparents rjqualified_namezCommand.qualified_namesb ; 9 DK,-k(  " LL) * * *xx(((rlc@K|j0|j|jur"t|jjd{VsdS|j2t |jdd}|rt|d{V}|sdS|j}|sdSt fd|Dd{VS)NFinteraction_checkTc3.K|]}|VdSrrrs rjrkz)Command._check_can_run..+BB!qq~~BBBBBBrl)rrr3rrr?r4)rrzrIretrs ` rjrzCommand._check_can_runs ; "t{$,'F'F ))F TTTTTTTT u < #%,T\;NPT%U%UE !+E;????????! 5[  4BBBBzBBBBBBBBBBBBrlcoro Error[GroupT]cZtj|std||_|SawA decorator that registers a coroutine as a local error handler. The local error handler is called whenever an exception is raised in the body of the command or during handling of the command. The error handler must take 2 parameters, the interaction and the error. The error passed will be derived from :exc:`AppCommandError`. Parameters ----------- coro: :ref:`coroutine ` The coroutine to register as the local error handler. Raises ------- TypeError The coroutine passed is not actually a coroutine. &The error handler must be a coroutine.rtrrr;rrs rjr{z Command.error3(*400 FDEE E  rlXCallable[[AutocompleteCallback[GroupT, ChoiceT]], AutocompleteCallback[GroupT, ChoiceT]]cdfd }|S)a%A decorator that registers a coroutine as an autocomplete prompt for a parameter. The coroutine callback must have 2 parameters, the :class:`~discord.Interaction`, and the current value by the user (the string currently being typed by the user). To get the values from other parameters that may be filled in, accessing :attr:`.Interaction.namespace` will give a :class:`Namespace` object with those values. Parent :func:`checks ` are ignored within an autocomplete. However, checks can be added to the autocomplete callback and the ones added will be called. If the checks fail for any reason then an empty list is sent as the interaction response. The coroutine decorator **must** return a list of :class:`~discord.app_commands.Choice` objects. Only up to 25 objects are supported. .. warning:: The choices returned from this coroutine are suggestions. The user may ignore them and input their own value. Example: .. code-block:: python3 @app_commands.command() async def fruits(interaction: discord.Interaction, fruit: str): await interaction.response.send_message(f'Your favourite fruit seems to be {fruit}') @fruits.autocomplete('fruit') async def fruits_autocomplete( interaction: discord.Interaction, current: str, ) -> List[app_commands.Choice[str]]: fruits = ['Banana', 'Pineapple', 'Apple', 'Watermelon', 'Melon', 'Cherry'] return [ app_commands.Choice(name=fruit, value=fruit) for fruit in fruits if current.lower() in fruit.lower() ] Parameters ----------- name: :class:`str` The parameter name to register as autocomplete. Raises ------- TypeError The coroutine passed is not actually a coroutine or the parameter is not found or of an invalid type. rrrbctj|std j}n!#t$rtddwxYw|jt jt jt j fvrtd| rtdt||_ |S)Nz7The autocomplete callback must be a coroutine function.zunknown parameter: rr) rtrrr>rrrrrrrrrL)rrrnrs rj decoratorz'Command.autocomplete..decoratorLs.t44 [ YZZZ J T* J J J >d > >??TI Jz"6"=?S?Z\p\x!yyy lmmm))++ |"A!F!FE Ks 4A)rrrbrr)rrnrs`` rjrLzCommand.autocompletes0l       (rlr^Checkc:|j|dSzAdds a check to the command. This is the non-decorator interface to :func:`check`. Parameters ----------- func The function that will be used as a check. Nr?rrr^s rj add_checkzCommand.add_checkb  4     rlc^ |j|dS#t$rYdSwxYwaRemoves a check from the command. This function is idempotent and will not raise an exception if the function is not in the command's checks. Parameters ----------- func The function to remove from the checks. Nr?removerrs rj remove_checkzCommand.remove_checkoE  K  t $ $ $ $ $    DD   ,,)rnr)ror)rr*r%rrr+r&r,rQr-rTr.r'rr(r/rbrrDrErnrrbr)rbr*) rr+rrZrMrOrNrrbrBrUrVrWr)rbrrUrVrbr)rzr:r{r"rbrr)rzr:rr<rbr)rzr:r`rrbrW)rzr:rr<rbrW)rzr:rnrrr<)rnrrbr)rbr)rnrrbrrbr+rrzr:rbr)rrrbr)rnrrbrr^rrbr)r r!rr"r1rrArHr#rrTr_rbrrrrrrrrrrrrr{rLrrrrlrjrBrB9scPPp"&)-8<:>$(!(;.;.;.;.;.;.z////X4;# (6(<<<<&("""""55554DDDD*9*9*9*9X C C CX C,'''X')))X)(CCCC.4JJJJX ! ! ! !rlrBceZdZdZedddddedd2dZed3dZed4dZd5d!Z d6d"Z d7d%Z d8d&Z d9d)Z d:d,Zd;d0Zd;d1ZdS)` .. versionadded:: 2.0 Parameters ----------- name: Union[:class:`str`, :class:`locale_str`] The name of the context menu. callback: :ref:`coroutine ` The coroutine that is executed when the command is called. type: :class:`.AppCommandType` The type of context menu application command. By default, this is inferred by the parameter of the callback. auto_locale_strings: :class:`bool` If this is set to ``True``, then all translatable strings will implicitly be wrapped into :class:`locale_str` rather than :class:`str`. This could avoid some repetition and be more ergonomic for certain defaults such as default command names, command descriptions, and parameter names. Defaults to ``True``. nsfw: :class:`bool` Whether the command is NSFW and should only work in NSFW channels. Defaults to ``False``. extras: :class:`dict` A dictionary that can be used to store extraneous data. The library will not touch any values or keys within this dictionary. Attributes ------------ name: :class:`str` The name of the context menu. type: :class:`.AppCommandType` The type of context menu application command. By default, this is inferred by the parameter of the callback. default_permissions: Optional[:class:`~discord.Permissions`] The default permissions that can execute this command on Discord. Note that server administrators can override this value in the client. Setting an empty permissions field will disallow anyone except server administrators from using the command in a guild. guild_only: :class:`bool` Whether the command should only be usable in guild contexts. Defaults to ``False``. allowed_contexts: Optional[:class:`~discord.app_commands.AppCommandContext`] The contexts that this context menu is allowed to be used in. Overrides ``guild_only`` if set. .. versionadded:: 2.4 allowed_installs: Optional[:class:`~discord.app_commands.AppInstallationType`] The installation contexts that the command is allowed to be installed on. .. versionadded:: 2.4 nsfw: :class:`bool` Whether the command is NSFW and should only work in NSFW channels. Defaults to ``False``. checks A list of predicates that take a :class:`~discord.Interaction` parameter to indicate whether the command callback should be executed. If an exception is necessary to be thrown to signal failure, then one inherited from :exc:`AppCommandError` should be used. If all the checks fail without propagating an exception, :exc:`CheckFailure` is raised. extras: :class:`dict` A dictionary that can be used to store extraneous data. The library will not touch any values or keys within this dictionary. FNT)rr%r&rQrTr'r(rnr)rrrrr%rr&r,rQr-rTr.r'r(r/c t|tr |j|fn|df\}} t||_| |_||_t|\} } } |tur| }| |krtd| d|d||_ | |_ | |_ |j |_||_|jt!|dd|_d|_t!|dd|_||_t!|dd|_|pt!|dd|_|pt!|d d|_t!|d g|_| pi|_|r"|jt|j|_dSdSdS) Nz(context menu callback implies a type of z but z was passed.r2r3r4Fr5r6r1)rr*rrrnr7r:rr1rr _param_name _annotationr!r<r@rr;rUr%rNrQrTr?r()rrnrrr%r&rQrTr'r(rBrr actual_types rjrzContextMenu.__init__s0:$ /K/K] d++RVX\Q] f3D99 28.6+Fx+P+P( K 7??D $  l llZ^lllmm m$(  %%-%8 # ? "%h0Y[_``DO04 :A Dd; ;   '2WY^ _ _=M> QX 94R R @P@ SZ CTT T $+85VXZ#[#[ &,l  : ($.ty$9$9!!! : :((rlrbc|jS)z]:ref:`coroutine `: The coroutine that is executed when the context menu is called.rJrs rjrzContextMenu.callbackrKrlrc|jS)z7:class:`str`: Returns the fully qualified command name.rrs rjrzContextMenu.qualified_names yrlrUrVrWr)rcK||}ttj|}|jr?i}t D]0}||j||d{V}| |||j<1||d<|S)NrYr\)rbr(r'rcr7rrerf)rrUrWrhcontextr\rBrks rjr_z"ContextMenu.get_translated_payloads||D!!$.H.U\`aaa   <13   C C$.$A$A$BSU[]d$e$eeeeeee *7B&v|4);D% & rlc|j|jj|j |j|j|j|j|jdn |jj|jdS)N)rnrrqrsrtrrr%) rnrrfrNrQrwrTrUr%)rrUs rjrbzContextMenu.to_dictsnIIO!%0-==d>STT!%!6!F!FtG\!]!]262J2R$$X\XpXvI   rlrzr:c`K|j}|sdStfd|Dd{VS)NTc3.K|]}|VdSrrrs rjrkz-ContextMenu._check_can_run.."rrl)r?r4)rrzrs ` rjrzContextMenu._check_can_runsP[  4BBBBzBBBBBBBBBBBBrlc|jduSr)r;rs rjrz#ContextMenu._has_any_error_handlers$s}D((rlrrcK ||d{Vstd|jd|||d{VdS#t$rt $r}t |||d}~wwxYw)Nz%The check functions for context menu r)rr#rnr:r"rr$)rrzrrs rj_invokezContextMenu._invoke's 5,,[99999999 b"#`49#`#`#`aaa..c22 2 2 2 2 2 2 2 2 2     5 5 5$T1--1 4 5sAAA?)A::A?r UnboundErrorcZtj|std||_|Srrrs rjr{zContextMenu.error2rrlr^rrc:|j|dSrrrs rjrzContextMenu.add_checkLrrlc^ |j|dS#t$rYdSwxYwrrrs rjrzContextMenu.remove_checkYrr)rnr)rrrrr%rr&r,rQr-rTr.r'rr(r/)rbrrrrrr)rzr:rr)rrrbrr)r r!rr"r1rr#rrr_rbrrrr{rrrrlrjrCrCs;EEX ')-8<:>$(!(0:0:0:0:0:0:dXX         CCCC)))) 5 5 5 54 ! ! ! !rlc eZdZUdZgZded<dZded<eZded<eZ ded <d Z d ed <d Z d ed <dZ ded<eZ ded<eZded<eZded<eZded<dZded<d Zded<eeededd\d"Zeed d eeeed#eed$ d]d.Zd^d/Zd_d2Zed#d3d`d9Zdad?Zdbd@ZedcdAZedddBZdedDZedfdFZdgdHZe dhdMZ!didPZ"djdQZ#ddRdkdVZ$dedWZ%dedXZ&eedd#edYdld[Z'd S)mrDaA class that implements an application command group. These are usually inherited rather than created manually. Decorators such as :func:`guild_only`, :func:`guilds`, and :func:`default_permissions` will apply to the group if used on top of a subclass. For example: .. code-block:: python3 from discord import app_commands @app_commands.guild_only() class MyGroup(app_commands.Group): pass .. versionadded:: 2.0 Parameters ----------- name: Union[:class:`str`, :class:`locale_str`] The name of the group. If not given, it defaults to a lower-case kebab-case version of the class name. description: Union[:class:`str`, :class:`locale_str`] The description of the group. This shows up in the UI to describe the group. If not given, it defaults to the docstring of the class shortened to 100 characters. auto_locale_strings: :class:`bool` If this is set to ``True``, then all translatable strings will implicitly be wrapped into :class:`locale_str` rather than :class:`str`. This could avoid some repetition and be more ergonomic for certain defaults such as default command names, command descriptions, and parameter names. Defaults to ``True``. default_permissions: Optional[:class:`~discord.Permissions`] The default permissions that can execute this group on Discord. Note that server administrators can override this value in the client. Setting an empty permissions field will disallow anyone except server administrators from using the command in a guild. Due to a Discord limitation, this does not work on subcommands. guild_only: :class:`bool` Whether the group should only be usable in guild contexts. Defaults to ``False``. Due to a Discord limitation, this does not work on subcommands. nsfw: :class:`bool` Whether the command is NSFW and should only work in NSFW channels. Defaults to ``False``. Due to a Discord limitation, this does not work on subcommands. parent: Optional[:class:`Group`] The parent application command. ``None`` if there isn't one. extras: :class:`dict` A dictionary that can be used to store extraneous data. The library will not touch any values or keys within this dictionary. Attributes ------------ name: :class:`str` The name of the group. description: :class:`str` The description of the group. This shows up in the UI to describe the group. default_permissions: Optional[:class:`~discord.Permissions`] The default permissions that can execute this group on Discord. Note that server administrators can override this value in the client. Setting an empty permissions field will disallow anyone except server administrators from using the command in a guild. Due to a Discord limitation, this does not work on subcommands. guild_only: :class:`bool` Whether the group should only be usable in guild contexts. Due to a Discord limitation, this does not work on subcommands. allowed_contexts: Optional[:class:`~discord.app_commands.AppCommandContext`] The contexts that this group is allowed to be used in. Overrides guild_only if set. .. versionadded:: 2.4 allowed_installs: Optional[:class:`~discord.app_commands.AppInstallationType`] The installation contexts that the command is allowed to be installed on. .. versionadded:: 2.4 nsfw: :class:`bool` Whether the command is NSFW and should only work in NSFW channels. Due to a Discord limitation, this does not work on subcommands. parent: Optional[:class:`Group`] The parent group. ``None`` if there isn't one. extras: :class:`dict` A dictionary that can be used to store extraneous data. The library will not touch any values or keys within this dictionary. z4ClassVar[List[Union[Command[Any, ..., Any], Group]]]'__discord_app_commands_group_children__Fr*__discord_app_commands_skip_init_binding__r#__discord_app_commands_group_name__*__discord_app_commands_group_description__Nr *__discord_app_commands_group_locale_name__1__discord_app_commands_group_locale_description__#__discord_app_commands_group_nsfw__r4r-r5r.r6Optional[Permissions]r3#__discord_app_commands_has_module__zMOptional[Callable[[Interaction, AppCommandError], Coroutine[Any, Any, None]]]r})rnrorNr%rUrnr)rorNr%rUrbrc||jsd|jD}||_t}|D]=}|j|vrt d|jd||j>t|dkrt d|tur'tt|j |_ nJt|trt||_ n t|j|_ ||_|tur)|jd|_nJt'|j|_n0t|tr||_n|j|_||_|tur||_|tur||_|jtkrd|_||_dS)NcXg|]'}t|ttfr |j%|(Sr)rrDrBr)rhmembers rjr`z+Group.__init_subclass__..sDDDD!jRWY`Qa>b>bDgmgtg|g|g|g|rlzCommand z is a duplicatez(groups cannot have more than 25 commandsrT)rrrsetrnraddrr1rr6r rrrrrr"rr5rr4r3r!rr) clsrnrorNr%rUchildrenfoundchilds rj__init_subclass__zGroup.__init_subclass__s: LDD%(\%8%8%:%:DDDH;CC 7EEE! & &:&&#$Luz$L$L$LMMM %*%%%%8}}r!! JKKK 7??6CNSVS_D`D`6a6aC 3 3 c " " B6CD6I6IC 3 36CDL6Q6QC 3=AC : ' ! !{"AF>>AI#+AVAV>>  S ) ) P=HC : :=H=PC :DOC A W $ $6@C 3 g - -?RC < >X % %6:C 326///rlT) rnrorr&rNrQrTr%r'rUr(rr+r&r,rQrTr'r(r/c |j} |tur| j| j} }n=t |t rt |d} }nt |j|} }||_| |_ |tur| j | j } }n#t |t r|d} }n |j|} }||_ | |_ d|_d|_||_|jt#| dd|_| tur| jturd} n| j} | |_|tur| jturd}n| j}||_|tur| jturd}n| j}||_|tur| jturd}n| j}||_|tur| j}||_|j st9d|jst9d||_|| jr | j|_ nN tCj"j#j$d|_ n$#tJtLtNf$r d|_ YnwxYwi|_(| pi|_)i}|j*D]W}| j+s|,|||dn|}||j(|j<|jr| j+st[||j|X|+|jt]d|/|| r|0dSdS)Nr2Fzgroups must have a descriptionzgroups must have a namer )rrrMrNz+groups can only be nested at most one level)1 __class__r1rrrrrrrnr7rrror8r9 _owner_clsr@rr3rUr4rNr5rQr6rTrr%rrrr!r<rt currentframef_back f_globalsr IndexErrorr _childrenr(rrrTrSr add_commandrA)rrnrorr&rNrQrTr%r'rUr(rrBrMrrs rjrzGroup.__init__srn 7??BCDr&DD c " " =(..&DD(66&D 28 ' ! !>E KK S ) ) C"-tKK"-"5{K +9? $( /3/8 ? "%c+TVZ[[DO ' ) )?7JJ&*##&)&V#:M  6'AA"  D * w & &4??#'  #&#H =M w & &>'II#'  #&#R ?O 7??:D  ><== =y 7566 6'-  "  2 #.DKK #&244;EjQ "J9 # # #"  #<>&,l ')A 0 0EE  dX^c ddd  )-DN49 %z 0#"P 0dj$///  }( !NOOO   t $ $ $  .  + + - - - - - . .s'(HH10H1c|jt|j|_|jt|j|_dSdSr)r7r*rnr8rors rjrAz Group._convert_to_locale_stringssG   $ *49 5 5D   # +'1$2B'C'CD $ $ $ , +rlrDrEc:||_|j|_||_dSr)r9r!r<rrGs rjrHzGroup.__set_name__s & rlrLrr[rMMutableMapping[Group, Group]rNc|turin|}t|}||_i|_|||<|jD]}||||}||_||j|j<t|trR|j rK|rI|j |j urt||j |s|j |j urt||j ||j r|rt|p||j ||S)N)rrrM) r1rQrr rrTrnrrDr9rrrS)rrrrMrNrr child_copys rjrTzGroup._copy_withs/"W,,22(D!! ^**,, @ @E))wQY)ZZJ $J .8DN:? +*e,, @1A @n @$ (===GZ%5zBBBB*dn<<D*"2J??? : 9. 9 F%gtz4 8 8 8 rlrUrVrWr)rcK|}i}i}ttj|}ttj|}t D]l}|jr.|j||d{V} | | ||j<|j r.|j ||d{V} | | ||j<m||d<||d<fd|j Dd{V|d<|S)NrYr\r]cLKg|]}|d{VSr)r_)rhrrWrUs rjr`z0Group.get_translated_payload..s@uuuTY!=!=dJ!O!OOOOOOOuuurlra) rbr(r' group_namegroup_descriptionrr7rerfr8r rrgs `` rjr_zGroup.get_translated_payloads_||D!!-/46!*3M3X_cddd 0:T:fmqrrr J JF  C$.$A$A$BSU[]i$j$jjjjjjj *7B&v|4' J$.$A$A$BZ\bdw$x$xxxxxxx *>I-fl;%7 !",E ()uuuuu]a]k]r]r]t]tuuuuuuuuuY rlc|jdntjj}|j|j|fd|jDd}|jq|j|d<|j |d<|j dn |j j|d<j |j |d<j |j |d<|S) Nrc:g|]}|Srrn)rhrrUs rjr`z!Group.to_dict..s%QQQ d++QQQrlrpr%rqrrrsrt)rrsubcommand_grouprfrnror rr%rNrUrQrwrTrxs ` rjrbz Group.to_dicts ;.aa4H4Y4_ I+QQQQ9N9N9P9PQQQ    ; 9DL(,$7D !9=9Q9Y_c_w_}D- .#4DDTEZ[[D (,(=(M(MdNc(d(dD$ % rlc|jS)z3Optional[:class:`Group`]: The parent of this group.rrs rjrzGroup.root_parents {rlcJ|j|jS|jjd|jS)z:class:`str`: Returns the fully qualified group name. The qualified name includes the parent name as well. For example, in a group like ``/foo bar`` the qualified name is ``foo bar``. Nr)rrnrs rjrzGroup.qualified_names/ ; 9 +"00TY000rl.Optional[Union[Command[Any, ..., Any], Group]]c6|j|Srr rRrs rjrzGroup._get_internal_commands~!!$'''rl*List[Union[Command[Any, ..., Any], Group]]cNt|jS)zUList[Union[:class:`Command`, :class:`Group`]]: The commands that this group contains.)rr rrs rjr@zGroup.commandss DN))++,,,rl;Generator[Union[Command[Any, ..., Any], Group], None, None]c#K|jD]5}|Vt|tr|Ed{V6dS)zAn iterator that recursively walks through all commands that this group contains. Yields --------- Union[:class:`Command`, :class:`Group`] The commands in this group. N)r rrrD walk_commands)rrGs rjr zGroup.walk_commandsso~,,.. 3 3GMMM'5)) 3"00222222222 3 3rlrzInteraction[ClientT]r{r"c KdS)a|coro| A callback that is called when a child's command raises an :exc:`AppCommandError`. To get the command that failed, :attr:`discord.Interaction.command` should be used. The default implementation does nothing. Parameters ----------- interaction: :class:`~discord.Interaction` The interaction that is being handled. error: :exc:`AppCommandError` The exception that was raised. Nr)rrzr{s rjr;zGroup.on_error s $ rlr ErrorFuncctj|stdtj|j}t |dkrtd||_|S)aaA decorator that registers a coroutine as a local error handler. The local error handler is called whenever an exception is raised in a child command. The error handler must take 2 parameters, the interaction and the error. The error passed will be derived from :exc:`AppCommandError`. Parameters ----------- coro: :ref:`coroutine ` The coroutine to register as the local error handler. Raises ------- TypeError The coroutine passed is not actually a coroutine, or is an invalid coroutine. rrz)The error handler must have 2 parameters.)rtrrrrrr;)rrr`s rjr{z Group.error sf&*400 FDEE E"4((3 v;;!  GHH H  rlc KdS)ab|coro| A callback that is called when an interaction happens within the group that checks whether a command inside the group should be executed. This is useful to override if, for example, you want to ensure that the interaction author is a given user. The default implementation of this returns ``True``. .. note:: If an exception occurs within the body then the check is considered a failure and error handlers such as :meth:`on_error` is called. See :exc:`AppCommandError` for more information. Parameters ----------- interaction: :class:`~discord.Interaction` The interaction that occurred. Returns --------- :class:`bool` Whether the view children's callbacks should be called. Tr)rrzs rjrzGroup.interaction_check=s :trl)overriderG$Union[Command[Any, ..., Any], Group]r&ct|ttfstd|jjt|tr|jt|jd|s$|j|j vrt|jd||j |j<||_t|j dkrtddS)a*Adds a command or group to this group's internal list of commands. Parameters ----------- command: Union[:class:`Command`, :class:`Group`] The command or group to add. override: :class:`bool` Whether to override a pre-existing command or group with the same name. If ``False`` then an exception is raised. Raises ------- CommandAlreadyRegistered The command or group is already registered. Note that the :attr:`CommandAlreadyRegistered.guild_id` attribute will always be ``None`` in this case. ValueError There are too many commands already registered or the group is too deeply nested. TypeError The wrong command type was passed. zexpected Command or Group not Nz; is too nested, groups can only be nested at most one level)guild_idrz)maximum number of child commands exceeded) rrBrDrrr rrrnr r&r)rrGr&s rjr zGroup.add_command\s.'GU#344 [YW=N=WYYZZ Z gu % % m$+*A  kkkll l HGLDN::*7<$GGG G'.w|$ t~   # #HII I $ #rlc<|j|ddS)aRemoves a command or group from the internal list of commands. Parameters ----------- name: :class:`str` The name of the command or group to remove. Returns -------- Optional[Union[:class:`~discord.app_commands.Command`, :class:`~discord.app_commands.Group`]] The command that was removed. If nothing was removed then ``None`` is returned instead. N)r rrs rjremove_commandzGroup.remove_commands" 4&&&&&rlc6|j|S)aRetrieves a command or group from its name. Parameters ----------- name: :class:`str` The name of the command or group to retrieve. Returns -------- Optional[Union[:class:`~discord.app_commands.Command`, :class:`~discord.app_commands.Group`]] The command or group that was retrieved. If nothing was found then ``None`` is returned instead. rrs rj get_commandzGroup.get_commands~!!$'''rlrnror%r'r(@Callable[[CommandCallback[GroupT, P, T]], Command[GroupT, P, T]]c(dfd }|S)aMA decorator that creates an application command from a regular function under this group. Parameters ------------ name: Union[:class:`str`, :class:`locale_str`] The name of the application command. If not given, it defaults to a lower-case version of the callback name. description: Union[:class:`str`, :class:`locale_str`] The description of the application command. This shows up in the UI to describe the application command. If not given, it defaults to the first line of the docstring of the callback shortened to 100 characters. nsfw: :class:`bool` Whether the command is NSFW and should only work in NSFW channels. Defaults to ``False``. auto_locale_strings: :class:`bool` If this is set to ``True``, then all translatable strings will implicitly be wrapped into :class:`locale_str` rather than :class:`str`. This could avoid some repetition and be more ergonomic for certain defaults such as default command names, command descriptions, and parameter names. Defaults to ``True``. extras: :class:`dict` A dictionary that can be used to store extraneous data. The library will not touch any values or keys within this dictionary. r^r*rbCommand[GroupT, P, T]c tj|stdtur|jd}nt |j}n}t turn|j||}||S)N-command function must be a coroutine functionr)rnrorr%rr'r() rtrrr1r"r5rBr r ) r^descrGr'ror(rnr%rs rjrz Group.command..decorators.t44 Q OPPPg%%<' DD#DL11DD"!00TTdm $7G   W % % %Nrlr^r*rbr1r)rrnror%r'r(rs`````` rjrGz Group.commandsHB           0rl) rnr)ror)rNrr%rrUrrbr)rnr)ror)rr+r&r,rNrrQr-rTr.r%rr'rrUrr(r/rr) rr+rr[rMr rNrrbrDrrrr)rnrrbr)rbr)rbr)rzr!r{r"rbr)rr#rbr#)rzr!rbr)rGr'r&rrbr rnr)ror)r%rr'rr(r/rbr/)(r r!rr"r__annotations__rr1rrrrrr4r5r6r3rr}rrrArHrTr_rbr#rrrr@r rr;r{rr r+r-rGrrlrjrDrDksb\\|eg+ffff7<.<<<af(J(J(J(J(J(JT''''"((((&(/.5$(!(99999999rlrDFTr.r)ror%rr'r(r/r/c$dfd }|S)aCreates an application command from a regular function. Parameters ------------ name: :class:`str` The name of the application command. If not given, it defaults to a lower-case version of the callback name. description: :class:`str` The description of the application command. This shows up in the UI to describe the application command. If not given, it defaults to the first line of the docstring of the callback shortened to 100 characters. nsfw: :class:`bool` Whether the command is NSFW and should only work in NSFW channels. Defaults to ``False``. Due to a Discord limitation, this does not work on subcommands. auto_locale_strings: :class:`bool` If this is set to ``True``, then all translatable strings will implicitly be wrapped into :class:`locale_str` rather than :class:`str`. This could avoid some repetition and be more ergonomic for certain defaults such as default command names, command descriptions, and parameter names. Defaults to ``True``. extras: :class:`dict` A dictionary that can be used to store extraneous data. The library will not touch any values or keys within this dictionary. r^r*rbr1c tj|stdtur|jd}nt |j}n}t turn|j||dS)Nr3r)rnrorrr%r'r()rtrrr1r"r5rBr )r^r4r'ror(rnr%s rjrzcommand..decorators*400 MKLL L ' ! !|# --DW,,$- 3    rlr5r)rnror%r'r(rs````` rjrGrGsBD          , rl)rnr%r'r(,Callable[[ContextMenuCallback], ContextMenu]c dfd }|S)azCreates an application command context menu from a regular function. This function must have a signature of :class:`~discord.Interaction` as its first parameter and taking either a :class:`~discord.Member`, :class:`~discord.User`, or :class:`~discord.Message`, or a :obj:`typing.Union` of ``Member`` and ``User`` as its second parameter. Examples --------- .. code-block:: python3 @app_commands.context_menu() async def react(interaction: discord.Interaction, message: discord.Message): await interaction.response.send_message('Very cool message!', ephemeral=True) @app_commands.context_menu() async def ban(interaction: discord.Interaction, user: discord.Member): await interaction.response.send_message(f'Should I actually ban {user}...', ephemeral=True) Parameters ------------ name: Union[:class:`str`, :class:`locale_str`] The name of the context menu command. If not given, it defaults to a title-case version of the callback name. Note that unlike regular slash commands this can have spaces and upper case characters in the name. nsfw: :class:`bool` Whether the command is NSFW and should only work in NSFW channels. Defaults to ``False``. Due to a Discord limitation, this does not work on subcommands. auto_locale_strings: :class:`bool` If this is set to ``True``, then all translatable strings will implicitly be wrapped into :class:`locale_str` rather than :class:`str`. This could avoid some repetition and be more ergonomic for certain defaults such as default command names, command descriptions, and parameter names. Defaults to ``True``. extras: :class:`dict` A dictionary that can be used to store extraneous data. The library will not touch any values or keys within this dictionary. r^rrbrCctj|stdtur|jn}t ||S)Nz2context menu function must be a coroutine function)rnr%rr'r()rtrrr1r titlerC)r^ actual_namer'r(rnr%s rjrzcontext_menu..decoratorMsl*400 RPQQ Q/3wdm))+++D  3     rl)r^rrbrCr)rnr%r'r(rs```` rjrFrFs<^           rlrCallable[[T], T]c dfd }|S)acDescribes the given parameters by their name using the key of the keyword argument as the name. Example: .. code-block:: python3 @app_commands.command(description='Bans a member') @app_commands.describe(member='the member to ban') async def ban(interaction: discord.Interaction, member: discord.Member): await interaction.response.send_message(f'Banned {member}') Alternatively, you can describe parameters using Google, Sphinx, or Numpy style docstrings. Example: .. code-block:: python3 @app_commands.command() async def ban(interaction: discord.Interaction, member: discord.Member): """Bans a member Parameters ----------- member: discord.Member the member to ban """ await interaction.response.send_message(f'Banned {member}') Parameters ----------- \*\*parameters: Union[:class:`str`, :class:`locale_str`] The description of the parameters. Raises -------- TypeError The parameter name is not found. innerrWrbct|d|p|}t|trt|jn3 |jn#t$r |_YnwxYw|SN__discord_app_commands_unwrap__)rrrBrr>rrrrA unwrappedrs rjrzdescribe..decoratorsE#DeLLUPU i ) ) N "9#4j A A A A N@GG SSSS! N N NCM@@@ N AA0/A0rArWrbrWrrrs` rjrHrH]s*R       rlc dfd }|S)awRenames the given parameters by their name using the key of the keyword argument as the name. This renames the parameter within the Discord UI. When referring to the parameter in other decorators, the parameter name used in the function is used instead of the renamed one. Example: .. code-block:: python3 @app_commands.command() @app_commands.rename(the_member_to_ban='member') async def ban(interaction: discord.Interaction, the_member_to_ban: discord.Member): await interaction.response.send_message(f'Banned {the_member_to_ban}') Parameters ----------- \*\*parameters: Union[:class:`str`, :class:`locale_str`] The name of the parameters. Raises -------- ValueError The parameter name is already used by another parameter. TypeError The parameter name is not found. rArWrbct|d|p|}t|trt|jn3 |jn#t$r |_YnwxYw|SrC)rrrBrr>rrrrEs rjrzrename..decoratorsE#DeLLUPU i ) ) I i/ < < < < I;BB:NNNN! I I I>H;;; I rGrHrrIs` rjrJrJs):       rlList[Choice[ChoiceT]]c dfd }|S)aInstructs the given parameters by their name to use the given choices for their choices. Example: .. code-block:: python3 @app_commands.command() @app_commands.describe(fruits='fruits to choose from') @app_commands.choices(fruits=[ Choice(name='apple', value=1), Choice(name='banana', value=2), Choice(name='cherry', value=3), ]) async def fruit(interaction: discord.Interaction, fruits: Choice[int]): await interaction.response.send_message(f'Your favourite fruit is {fruits.name}.') .. note:: This is not the only way to provide choices to a command. There are two more ergonomic ways of doing this. The first one is to use a :obj:`typing.Literal` annotation: .. code-block:: python3 @app_commands.command() @app_commands.describe(fruits='fruits to choose from') async def fruit(interaction: discord.Interaction, fruits: Literal['apple', 'banana', 'cherry']): await interaction.response.send_message(f'Your favourite fruit is {fruits}.') The second way is to use an :class:`enum.Enum`: .. code-block:: python3 class Fruits(enum.Enum): apple = 1 banana = 2 cherry = 3 @app_commands.command() @app_commands.describe(fruits='fruits to choose from') async def fruit(interaction: discord.Interaction, fruits: Fruits): await interaction.response.send_message(f'Your favourite fruit is {fruits}.') Parameters ----------- \*\*parameters The choices of the parameters. Raises -------- TypeError The parameter name is not found or the parameter type was incorrect. rArWrbct|d|p|}t|trt|jn3 |jn#t$r |_YnwxYw|SrC)rrrBrr>rrrrEs rjrzchoices..decoratorsE#DeLLUPU i ) ) J i/ < < < < J<CCJOOOO! J J J?I<<< J rGrHrrIs` rjrKrKs*n       rlc dfd }|S)a>Associates the given parameters with the given autocomplete callback. Autocomplete is only supported on types that have :class:`str`, :class:`int`, or :class:`float` values. :func:`Checks ` are supported, however they must be attached to the autocomplete callback in order to work. Checks attached to the command are ignored when invoking the autocomplete callback. For more information, see the :meth:`Command.autocomplete` documentation. .. warning:: The choices returned from this coroutine are suggestions. The user may ignore them and input their own value. Example: .. code-block:: python3 async def fruit_autocomplete( interaction: discord.Interaction, current: str, ) -> List[app_commands.Choice[str]]: fruits = ['Banana', 'Pineapple', 'Apple', 'Watermelon', 'Melon', 'Cherry'] return [ app_commands.Choice(name=fruit, value=fruit) for fruit in fruits if current.lower() in fruit.lower() ] @app_commands.command() @app_commands.autocomplete(fruit=fruit_autocomplete) async def fruits(interaction: discord.Interaction, fruit: str): await interaction.response.send_message(f'Your favourite fruit seems to be {fruit}') Parameters ----------- \*\*parameters The parameters to mark as autocomplete. Raises -------- TypeError The parameter name is not found or the parameter type was incorrect. rArWrbct|d|p|}t|trt|jn3 |jn#t$r |_YnwxYw|SrC)rrrBrr>rrrrEs rjrzautocomplete..decorator4 sE#DeLLUPU i ) ) O "9#4j A A A A OAHHTTTT! O O ODNAAA O rGrHrrIs` rjrLrL s*Z       rlr&Union[Snowflake, int]c,d|Ddfd }|S)aAssociates the given guilds with the command. When the command instance is added to a :class:`CommandTree`, the guilds that are specified by this decorator become the default guilds that it's added to rather than being a global command. If no arguments are given, then the command will not be synced anywhere. This may be modified later using the :meth:`CommandTree.add_command` method. .. note:: Due to an implementation quirk and Python limitation, if this is used in conjunction with the :meth:`CommandTree.command` or :meth:`CommandTree.context_menu` decorator then this must go below that decorator. .. note :: Due to a Discord limitation, this decorator cannot be used in conjunction with contexts (e.g. :func:`.app_commands.allowed_contexts`) or installation types (e.g. :func:`.app_commands.allowed_installs`). Example: .. code-block:: python3 MY_GUILD_ID = discord.Object(...) # Guild ID here @app_commands.command() @app_commands.guilds(MY_GUILD_ID) async def bonk(interaction: discord.Interaction): await interaction.response.send_message('Bonk', ephemeral=True) Parameters ----------- \*guild_ids: Union[:class:`int`, :class:`~discord.abc.Snowflake`] The guilds to associate this command with. The command tree will use this as the default when added rather than adding it as a global command. cJg|] }t|tr|n|j!Sr)rintid)rhgs rjr`zguilds..l s-PPP 1c 2 2<11PPPrlrArWrbct|d|p|}t|ttfr|_n:t|t r|jtd|_n|_|S)NrDz8child commands of a group cannot have default guilds set) rrrDrCr@rBrrr2)rArFdefaultss rjrzguilds..decoratorn sE#DeLLUPU i%!5 6 6 E#+I  7 + + E+ ![\\\#+I =EE 9 rlrHr)r&rrXs @rjrMrMC s@RQPiPPPH       rl predicatercdfd }|S)aA decorator that adds a check to an application command. These checks should be predicates that take in a single parameter taking a :class:`~discord.Interaction`. If the check returns a ``False``\-like value then during invocation a :exc:`CheckFailure` exception is raised and sent to the appropriate error handlers. These checks can be either a coroutine or not. Examples --------- Creating a basic check to see if the command invoker is you. .. code-block:: python3 def check_if_it_is_me(interaction: discord.Interaction) -> bool: return interaction.user.id == 85309593344815104 @tree.command() @app_commands.check(check_if_it_is_me) async def only_for_me(interaction: discord.Interaction): await interaction.response.send_message('I know you!', ephemeral=True) Transforming common checks into its own decorator: .. code-block:: python3 def is_me(): def predicate(interaction: discord.Interaction) -> bool: return interaction.user.id == 85309593344815104 return app_commands.check(predicate) @tree.command() @is_me() async def only_me(interaction: discord.Interaction): await interaction.response.send_message('Only you!') Parameters ----------- predicate: Callable[[:class:`~discord.Interaction`], :class:`bool`] The predicate to check if the command should be invoked. r^CheckInputParameterrbct|d|p|}t|ttfr|jn1t |dsg|_|j|S)NrDr1)rrrBrCr?rrr1)r^rFrYs rjrzcheck..decorator sD"CTJJRd i';!7 8 8 C   # #I . . . .4!BCC :794  0 7 7 B B B rl)r^r[rbr[r)rYrs` rjrIrI s*Z       rlcdSrrrs rjrNrN s69crlcdSrrrs rjrNrN s!crl Optional[T]Union[T, Callable[[T], T]]c(dd}||S||S)aA decorator that indicates this command can only be used in a guild context. This is **not** implemented as a :func:`check`, and is instead verified by Discord server side. Therefore, there is no error handler called when a command is used within a private message. This decorator can be called with or without parentheses. Due to a Discord limitation, this decorator does nothing in subcommands and is ignored. Examples --------- .. code-block:: python3 @app_commands.command() @app_commands.guild_only() async def my_guild_only_command(interaction: discord.Interaction) -> None: await interaction.response.send_message('I am only available in guilds!') rrWrbc t|d|p|}t|tttfr$d|_|jp t}||_n-d|_t|ddp t}||_ d|_ |S)NrDTr5) rrrBrDrCrNrQrr4r5guildrrFrQs rjrAzguild_only..inner sA@!DDI i'5+!> ? ? C#'I (9P=N=P=P )9I & &48A 1&q*MtTTkXiXkXk 2BA /!%rlNrrWrbrWrr^rAs rjrNrN s0*" | uT{{rlcdSrrrs rjrPrP s@CrlcdSrrrs rjrPrP s(+rlc(dd}||S||S)aA decorator that indicates this command can only be used in the context of DMs and group DMs. This is **not** implemented as a :func:`check`, and is instead verified by Discord server side. Therefore, there is no error handler called when a command is used within a guild. This decorator can be called with or without parentheses. Due to a Discord limitation, this decorator does nothing in subcommands and is ignored. .. versionadded:: 2.4 Examples --------- .. code-block:: python3 @app_commands.command() @app_commands.private_channel_only() async def my_private_channel_only_command(interaction: discord.Interaction) -> None: await interaction.response.send_message('I am only available in DMs and GDMs!') rrWrbct|d|p|}t|tttfr$d|_|jp t}||_n&t|ddp t}||_d|_ |SNrDFr5T) rrrBrDrCrNrQrr5private_channelrds rjrAz#private_channel_only..inner sA@!DDI i'5+!> ? ? C#(I (9P=N=P=P )9I & &&q*MtTTkXiXkXk 2BA /+/(rlNrerrfs rjrPrP s0.     | uT{{rlcdSrrrs rjrOrO& s363rlcdSrrrs rjrOrO* s3rlc(dd}||S||S)aA decorator that indicates this command can only be used in the context of bot DMs. This is **not** implemented as a :func:`check`, and is instead verified by Discord server side. Therefore, there is no error handler called when a command is used within a guild or group DM. This decorator can be called with or without parentheses. Due to a Discord limitation, this decorator does nothing in subcommands and is ignored. Examples --------- .. code-block:: python3 @app_commands.command() @app_commands.dm_only() async def my_dm_only_command(interaction: discord.Interaction) -> None: await interaction.response.send_message('I am only available in DMs!') rrWrbct|d|p|}t|tttfr$d|_|jp t}||_n&t|ddp t}||_d|_ |Srk) rrrBrDrCrNrQrr5 dm_channelrds rjrAzdm_only..innerC sA@!DDI i'5+!> ? ? C#(I (9P=N=P=P )9I & &&q*MtTTkXiXkXk 2BA /&*#rlNrerrfs rjrOrO. s0*     | uT{{rlrMdmsprivate_channelscdfd }|S)aA decorator that indicates this command can only be used in certain contexts. Valid contexts are guilds, DMs and private channels. This is **not** implemented as a :func:`check`, and is instead verified by Discord server side. Due to a Discord limitation, this decorator does nothing in subcommands and is ignored. .. versionadded:: 2.4 Examples --------- .. code-block:: python3 @app_commands.command() @app_commands.allowed_contexts(guilds=True, dms=False, private_channels=True) async def my_command(interaction: discord.Interaction) -> None: await interaction.response.send_message('I am only available in guilds and private channels!') rrWrbcft|d|p|}t|tttfr$d|_|jp t}||_n&t|ddp t}||_tur|_ tur|_ tur|_ |S)NrDFr5) rrrBrDrCrNrQrr5r1rcrqrl)rrFrQrrrMrss rjrAzallowed_contexts..innerm sA@!DDI i'5+!> ? ? C#(I (9P=N=P=P )9I & &&q*MtTTkXiXkXk 2BA /  %+  " g  *-  ' 7 * */?  ,rlrer)rMrrrsrAs``` rjrQrQX s4** LrlcdSrrrs rjrRrR s9<rlcdSrrrs rjrRrR s!$rlc(dd}||S||S)aZA decorator that indicates this command should be installed in guilds. This is **not** implemented as a :func:`check`, and is instead verified by Discord server side. Due to a Discord limitation, this decorator does nothing in subcommands and is ignored. .. versionadded:: 2.4 Examples --------- .. code-block:: python3 @app_commands.command() @app_commands.guild_install() async def my_guild_install_command(interaction: discord.Interaction) -> None: await interaction.response.send_message('I am installed in guilds by default!') rrWrbct|d|p|}t|tttfr|jp t }||_n&t|ddp t }||_d|_|SNrDr6T) rrrBrDrCrTrr6rcrrFrTs rjrAzguild_install..inner sA@!DDI i'5+!> ? ? M(9R=P=R=R )9I & &&q*WY]^^wbubwbw  None: await interaction.response.send_message('I am installed in users by default!') rrWrbct|d|p|}t|tttfr|jp t }||_n&t|ddp t }||_d|_|Srz) rrrBrDrCrTrr6rr{s rjrAzuser_install..inner sA@!DDI i'5+!> ? ? M(9R=P=R=R )9I & &&q*WY]^^wbubwbw  None: await interaction.response.send_message('I am installed in users by default!') rrWrbc8t|d|p|}t|tttfr|jp t }||_n&t|ddp t }||_tur|_ tur|_ |S)NrDr6) rrrBrDrCrTrr6r1rcr)rrFrTrMrs rjrAzallowed_installs..inner sA@!DDI i'5+!> ? ? M(9R=P=R=R )9I & &&q*WY]^^wbubwbw .decoratorI sLD"CTJJRd i'5+!> ? ? L,7I ) )@KD = rlrr^rWrbrWr.)rrrrs @rjrUrU s_b+"6"6"6"66 !**E**  rl)r^r_r`rarbrc)rnrrbr)rrrbr)rrrrrbr)r`rarrrbr)r`rarrrbr)r`rarrrbr)r`rarLrrbr)r^r_rrrbra)r^rrbr)r^rXrbrXr6) rnr)r%rr'rr(r/rbr:)rr)rbr?)rrLrbr?)rrrbr?)r&rQrbr?)rYrrbr?).)r^rrbr?rr)r^r_rbr`)rMrrrrrsrrbr?)rMrrrrbr?)rrrrrbr?)r" __future__rrttypingrrrrrr r r r r rrrrrrrrerrQenumsrrrrinstallsrrmodelsr transformersrr r!errorsr"r#r$r%r&rWr'r(r)r*rr+rr,rr-rr/utilsr0r1r2r3r4r5r6typing_extensionsr7r8r9 interactionsr:abcr;rr<r=rUr>_typesr? discord.extr@discord.permissionsrAr#__all__rVrWrXrZCororErrorrrr[CommandCallbackrrAutocompleteCallbackr[THAI_COMBININGDEVANAGARI_COMBININGcompilerARG_NAME_SUBREGEXARG_DESCRIPTION_SUBREGEXARG_TYPE_SUBREGEX MULTILINEryr{r|rrrrrrrrrrrrrErBrCrDrGrFrHrJrKrLrMrIrNrPrOrQrRrSrTrUrrlrjrs 0#"""""( %%%%%%MMMMMMMMMMMM<<<<<<<<MMMMMMMMMMyyyyyyyyyyyyyy^^^^^^^^^^^^%%%%%%vvvvvvvvvvvvvvvvvvT@@@@@@@@@@******$$$$$$!!!!!!      %$$$$$666666+73T>9RRSI . #AA A GCLL GCxS)***  + + +c1+_=tCyHI   f(/ :DI EF  $%uT4:-='>>? ' (2V%7:;T!WDE/23T!W<= ?O  $f-tCy89$d+T#Y67$g.S 9:$eFDL&9:DIEF H !&,c2DfWo9N4OOP$c*DfWo1F,GGH J sDG|,O"3Q<0#CaL14mEegzz{/p%2:i.&@CW&WZe&eff2Q'RZe ee'8eeKceeL (RZD!DD*BDDL 'BJq qq1BqqWoqqL *      0@H2====(>>>>8====2====07777t,,,,< j'j'j'j'j'j'j'j'ZE E E E E gfal#E E E PggggggggTu u u u u u u u t$+*1 $$ 888888z$+ $$ <<<<<<~5555p))))XCCCCL9999x::::z9999x 9999 9 !!! !*****Z CCCC C +++ +*****Z 6666 6  '''''T%,[b*****Z <<<< < $$$ $&&&&&R ;;;; ; ### #&&&&&T)))))X???????rl