i`dZddlmZddlZddlZddlmZmZmZm Z m Z m Z m Z m Z mZmZmZmZmZmZmZddlmZddlmZmZddlmZdd lmZmZmZdd l m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'dd l(m)Z)m*Z*dd l+m,Z,m-Z-d dl m.Z.m/Z/d dl0m1Z1m2Z2d dl3m4Z4m5Z5m6Z6m7Z7d dl8m9Z9er;d dl:m;Z;mZ>d dl?m@Z@ddlmAZAmBZBmCZCmDZDee>e9e!ge eeeffZEdZFejGeHZIe4e4fd"dZJGd d!e e9ZKdS)#a: The MIT License (MIT) Copyright (c) 2015-present Rapptz 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)Any TYPE_CHECKINGCallable CoroutineDict GeneratorGenericListLiteralOptionalSequenceSetTupleUnionoverload)Counter) Namespace ResolveKey) AppCommand)Command ContextMenuGroup)AppCommandErrorCommandAlreadyRegisteredCommandNotFoundCommandSignatureMismatchCommandLimitReachedCommandSyncFailureMissingApplicationID)AppCommandContextAppInstallationType) Translator locale_str)ClientException HTTPException)AppCommandTypeInteractionType)MISSING_get_as_snowflake _is_submodule_shorten)ClientT)!ApplicationCommandInteractionData'ApplicationCommandInteractionDataOption) Interaction) Snowflake)ContextMenuCallbackCommandCallbackPT) CommandTreecommandrguildOptional[Snowflake]guildsSequence[Snowflake]returnOptional[Set[int]]c|tur|turtd|tur;|turt|ddSt|dkrdSd|DS|dS|jhS)Nz-cannot mix guild and guilds keyword arguments _guild_idsrch|] }|j Sid).0gs Z/usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages/discord/app_commands/tree.py z&_retrieve_guild_ids..fs%%%%%%)r+ TypeErrorgetattrlenrE)r9r:r<s rH_retrieve_guild_idsrNUs Gg 5 5GHHH  W  7L$77 7 v;;!  4%%f%%%% }t H:rJceZdZdZdeeddod Zd ddpdZd ddqdZdrdZeedddsd"Z e d#ddtd(Z e d#d#d)dud,Z e d#ddvd/Z d e j d)dvd0Z d d1dwd3Ze d#ddtd4Ze d#d#d)dud5Ze d#ddvd6Zd e j d)dvd7Ze d#ddxd9Ze d#ddyd;Ze d#ddzd=Ze d#d#d)d{d?Zd d d)d|dAZe d#dd}dCZe d#d#d)d~dEZe d#dddGZd e j d)ddHZd dddIZddKZddPZddSZeedeededTdd\Zedeeded]dd_ZeddaZddcZd ddqddZddeZddfZddiZddkZddlZ ddmZ!ddnZ"d S)r8a Represents a container that holds application command information. Parameters ----------- client: :class:`~discord.Client` The client instance to get application command information from. fallback_to_global: :class:`bool` If a guild-specific command is not found when invoked, then try falling back into a global command in the tree. For example, if the tree locally has a ``/ping`` command under the global namespace but the guild has a guild-specific ``/ping``, instead of failing to find the guild-specific ``/ping`` command it will fall back to the global ``/ping`` command. This has the potential to raise more :exc:`~discord.app_commands.CommandSignatureMismatch` errors than usual. Defaults to ``True``. allowed_contexts: :class:`~discord.app_commands.AppCommandContext` The default allowed contexts that applies to all commands in this tree. Note that you can override this on a per command basis. .. versionadded:: 2.4 allowed_installs: :class:`~discord.app_commands.AppInstallationType` The default allowed install locations that apply to all commands in this tree. Note that you can override this on a per command basis. .. versionadded:: 2.4 T)fallback_to_globalallowed_contextsallowed_installsclientr/rPboolrQr"rRr#cB||_|j|_|j|_|jjt d||j_||_|turtn||_ |turtn||_ i|_ i|_i|_dS)Nz3This client already has an associated command tree.)rShttp_http _connection_state _command_treer'rPr+r"rQr#rR_guild_commands_global_commands_context_menus)selfrSrPrQrRs rH__init__zCommandTree.__init__s & [ ( ; $ 0!"WXX X$( !(:7G77R7R 1 3 3 3Xh9IW9T9T 3 5 5 5ZjLNBD RTrJNr: command_idintr:r;r>rcK|jjt|,|j|jj|d{V}n1|j|jj|j|d{V}t||jS)a`|coro| Fetches an application command from the application. Parameters ----------- command_id: :class:`int` The ID of the command to fetch. guild: Optional[:class:`~discord.abc.Snowflake`] The guild to fetch the command from. If not passed then the global command is fetched instead. Raises ------- HTTPException Fetching the command failed. MissingApplicationID The application ID could not be found. NotFound The application command was not found. This could also be because the command is a guild command and the guild was not specified and vice versa. Returns -------- :class:`~discord.app_commands.AppCommand` The application command. Ndatastate) rSapplication_idr!rWget_global_commandget_guild_commandrErrY)r^rar:r9s rH fetch_commandzCommandTree.fetch_commands: ; % -& & = J99$+:TV`aaaaaaaaGG J889SUZU]_ijjjjjjjjGwdk::::rJList[AppCommand]cKjjt|+jjjd{V}n0jjj|jd{V}fd|DS)a|coro| Fetches the application's current commands. If no guild is passed then global commands are fetched, otherwise the guild's commands are fetched instead. .. note:: This includes context menu commands. Parameters ----------- guild: Optional[:class:`~discord.abc.Snowflake`] The guild to fetch the commands from. If not passed then global commands are fetched instead. Raises ------- HTTPException Fetching the commands failed. MissingApplicationID The application ID could not be found. Returns -------- List[:class:`~discord.app_commands.AppCommand`] The application's commands. Nc<g|]}t|jSrdrrY)rFrer^s rH z.CommandTree.fetch_commands..s(NNNT DK888NNNrJ)rSrgr!rWget_global_commandsget_guild_commandsrE)r^r:commandss` rHfetch_commandszCommandTree.fetch_commandss< ; % -& & =!Z;;DKz.CommandTree.copy_global_to..sIG G G *$$8cyAMM58X &)MMrJc3"K|] \}}}|V dSr|rC)rF_r~s rH z-CommandTree.copy_global_to..s(BB~q!X(BBBBBBrJryrztypeN) r[rEcopyKeyErrorupdater\rMrr]itemsrr))r^r:mappingctx_menucounterr~countas_enums ` rHcopy_global_tozCommandTree.copy_global_tos_( *58499;;GG   GGG  t,--- w<<#  %uxsCCC CG G G G .2.A.G.G.I.IG G G  BBBBBBB&}} T TOHeqyy(22)5817SSSS ""8,,,)0UX&&&s $( 77F)r:r<overrider91Union[Command[Any, ..., Any], ContextMenu, Group]r<r=rcvt||}ttrajj}j}||fdfd }||d jn-i} |D]} || | j| d Stttfstd j j dj p} | j}||D]a} j| i} || v} | rst!|| o| }t#| |zdkrt%| db|D]"} j| i} | | |<#d S|jv} | rst!|d o| }t#j|zdkrt%d d| j|<d S)a?Adds an application command to the tree. This only adds the command locally -- in order to sync the commands and enable them in the client, :meth:`sync` must be called. The root parent of the command is added regardless of the type passed. Parameters ----------- command: Union[:class:`Command`, :class:`Group`] The application command or group to add. guild: Optional[:class:`~discord.abc.Snowflake`] The guild to add the command to. If not given or ``None`` then it becomes a global command instead. .. note :: Due to a Discord limitation, this keyword argument cannot be used in conjunction with contexts (e.g. :func:`.app_commands.allowed_contexts`) or installation types (e.g. :func:`.app_commands.allowed_installs`). guilds: List[:class:`~discord.abc.Snowflake`] The list of guilds to add the command to. This cannot be mixed with the ``guild`` parameter. If no guilds are given at all then it becomes a global command instead. .. note :: Due to a Discord limitation, this keyword argument cannot be used in conjunction with contexts (e.g. :func:`.app_commands.allowed_contexts`) or installation types (e.g. :func:`.app_commands.allowed_installs`). override: :class:`bool` Whether to override a command with the same name. If ``False`` an exception is raised. Default is ``False``. Raises -------- ~discord.app_commands.CommandAlreadyRegistered The command was already registered and no override was specified. TypeError The application command passed is not a valid application command. Or, ``guild`` and ``guilds`` were both given. CommandLimitReached The maximum number of commands was reached globally or for that guild. This is currently 100 for slash commands and 5 for context menu commands. ry Optional[int]re1Dict[Tuple[str, Optional[int], int], ContextMenu]r}strrrbr>ruc|f}| jv}|r st| o| }tfd jD}||zdkrtdt ||<dS)Nc3<K|]\}}}|k |kdVdS)rNrC)rFrrGtryrs rHrzLCommandTree.add_command.._context_menu_add_helper..ks=``'!QAMMVW[_V_V_AV_V_V_V_``rJrr)r]rsumrr)) ryrer}rkeyfoundto_addtotalr9rr^s ` ` rH_context_menu_add_helperz9CommandTree.add_command.._context_menu_add_helper]s Xt,t22CC24BBB'051`````T-@`````6>A%%-xq~^bOcOcdddd#S rJNz*Expected an application command, received  insteadrwrx) ryrrerr}rrrbr>ru)rN isinstancerrvaluer}r]rrrrK __class____name__ root_parentr[getrrMr setdefaultr\)r^r9r:r<r guild_idsrr}rcurrentryrootrsrrs`` ` rH add_commandzCommandTree.add_commands|r(?? g{ + +$ o<%D >, , ,},00$???7#3EH=H$<<666    44 n)>+AB B B$}tt%(HHdj1C&**355 5C BsA A#"A#)rOptional[AppCommandType]ctjurT||jn8 |j|j}|n#t $rYnwxYw|dn|j,fd|jD|_dStj tj fvr-fd|jD|_dSdS)aXClears all application commands from the tree. This only removes the commands locally -- in order to sync the commands and remove them in the client, :meth:`sync` must be called. Parameters ----------- guild: Optional[:class:`~discord.abc.Snowflake`] The guild to remove the commands from. If ``None`` then it removes all global commands instead. type: :class:`~discord.AppCommandType` The type of command to clear. If not given or ``None`` then it removes all commands regardless of the type. Nc6i|]\\}}}}|k|||f|SrCrC)rFr} _guild_idrrrys rHrz.CommandTree.clear_commands..sB###1,T9ec((y%(#(((rJcLi|] \\}}}}|ks |jk|||f|!SrC)r)rFr}rrrryrs rHrz.CommandTree.clear_commands.. sN###1,T9ec((ETZ,?,?y%(#,?,?,?rJ) r)rr\clearr[rErr]rrr)r^r:rrsrys ` @rHclear_commandszCommandTree.clear_commandss< <4>#<<<}%++----%#3EH=HNN$$$$ D !=44eh <####595H5N5N5P5P###D    n)>+AB B B#####595H5N5N5P5P###D   C BsA A$#A$cdSr|rCrs rH get_commandzCommandTree.get_commandrrJcdSr|rCrs rHrzCommandTree.get_commandrrJcdSr|rCrs rHrzCommandTree.get_command'rrJc^|tjurU||j|S |j|j}||S#t $rYdSwxYw|tjtjfvr/|dn|j}|||j f}|j |SdS)aGets an application command from the tree. Parameters ----------- command: :class:`str` The name of the root command to get. guild: Optional[:class:`~discord.abc.Snowflake`] The guild to get the command from. If not given or ``None`` then it gets a global command instead. type: :class:`~discord.AppCommandType` The type of command to get. Defaults to :attr:`~discord.AppCommandType.chat_input`, i.e. slash commands. Returns --------- Optional[Union[:class:`Command`, :class:`ContextMenu`, :class:`Group`]] The application command that was found. If nothing was found then ``None`` is returned instead. N) r)rr\rr[rErrrrr]rs rHrzCommandTree.get_command1s8 >, , ,},009991#3EH=H$<<000    44 n)>+AB B B$}tt%(HHdj1C&**3// /C BsA A! A!List[ContextMenu]cdSr|rCr^r:rs rH get_commandszCommandTree.get_commands\s  CrJ*List[Union[Command[Any, ..., Any], Group]]cdSr|rCrs rHrzCommandTree.get_commandsds 69SrJDUnion[List[Union[Command[Any, ..., Any], Group]], List[ContextMenu]]cdSr|rCrs rHrzCommandTree.get_commandsls PSsrJ7List[Union[Command[Any, ..., Any], Group, ContextMenu]]cdSr|rCrs rHrzCommandTree.get_commandsts CF#rJ}Union[List[ContextMenu], List[Union[Command[Any, ..., Any], Group]], List[Union[Command[Any, ..., Any], Group, ContextMenu]]]c|||S|tjurn|&t|jS |j|j}t|S#t$rgcYSwxYw|dn|j|j fd|j DS)aGets all application commands from the tree. Parameters ----------- guild: Optional[:class:`~discord.abc.Snowflake`] The guild to get the commands from, not including global commands. If not given or ``None`` then only global commands are returned. type: Optional[:class:`~discord.AppCommandType`] The type of commands to get. When not given or ``None``, then all command types are returned. Returns --------- List[Union[:class:`ContextMenu`, :class:`Command`, :class:`Group`]] The application commands from the tree. Nr`c:g|]\\}}}}|k|k|SrCrC)rFrrGrr9ryrs rHrpz,CommandTree.get_commands..s<ttt 4!QGWX\dWdWdijnsisisGisisisrJ) _get_all_commandsr)rlistr\valuesr[rErrr]r)r^r:rrsryrs @@rHrzCommandTree.get_commands|s4 <)))66 6 >, , ,}D188::;;;3#3EH=H  1 1222 III %}tt%(HJEttttt8K8Q8Q8S8Sttt tsB BB"Generator[ContextMenu, None, None]cdSr|rCrs rH walk_commandszCommandTree.walk_commandss .1SrJ;Generator[Union[Command[Any, ..., Any], Group], None, None]cdSr|rCrs rHrzCommandTree.walk_commandss GJcrJfUnion[Generator[Union[Command[Any, ..., Any], Group], None, None], Generator[ContextMenu, None, None]]cdSr|rCrs rHrzCommandTree.walk_commandss ruqtrJc#6K|tjur|Q|jD]5}|Vt |t r|Ed{V6dS |j|j}|D]5}|Vt |t r|Ed{V6dS#t$rYdSwxYw|dn|j}|j }|j D]\\}}} } ||kr | |kr| VdS)aAn iterator that recursively walks through all application commands and child commands from the tree. Parameters ----------- guild: Optional[:class:`~discord.abc.Snowflake`] The guild to iterate the commands from, not including global commands. If not given or ``None`` then only global commands are iterated. type: :class:`~discord.AppCommandType` The type of commands to iterate over. Defaults to :attr:`~discord.AppCommandType.chat_input`, i.e. slash commands. Yields --------- Union[:class:`ContextMenu`, :class:`Command`, :class:`Group`] The application commands from the tree. N) r)rr\rrrrr[rErrr]r) r^r:rrrsryrrrGrr9s rHrzCommandTree.walk_commandss. >, , ,}0779977CIII!#u--7##4#6#6666666677 ;#3EH=H (00;;! %c511;'*'8'8':'::::::::;; FF %}tt%(HJE&*&9&?&?&A&A " "" Aq7==Q%ZZ!MMM " "s%C CCc&|^t|j}|d|jD|S |j|j}t|}|j|fd|jD|S#t$r/|jfd|jDcYSwxYw)Nc3,K|]\\}}}}| |VdSr|rC)rFrrGrs rHrz0CommandTree._get_all_commands..s3]] 0!QCSTS\S\S\S\S\]]rJc36K|]\\}}}}|k|VdSr|rCrFrrGrrys rHrz0CommandTree._get_all_commands..s:ee$4YaAWX\dWdWdCWdWdWdWdeerJc.g|]\\}}}}|k|SrCrCrs rHrpz1CommandTree._get_all_commands..s0aaa 0!QCSTX`S`S`S`S`S`rJ) rr\rextendr]rr[rEr)r^r:basersrys @rHrzCommandTree._get_all_commandss' =LPQUQfQmQmQoQoLpLpD KK]]D4G4M4M4O4O]]] ] ] ]K /9 QUU]UdUdUfUfPgPg 8 eeee8K8Q8Q8S8Seeeeee  b b b 8aaaaD4G4M4M4O4Oaaaaaa bs#C6DDr}cdg}|jD]6\}}|j*t||jr||7|D] }|j|= g}|jD]6\}}|j*t||jr||7|D] }|j|= |jD]W}g}|D]6\}}|j*t||jr||7|D]}||=XdSr|)r]rmoduler-appendr\r[r)r^r}removerrrs rH_remove_with_modulezCommandTree._remove_with_moduless+1133 # #HCz%-cj*I*I% c""" ) )C#C((-3355 # #HCz%-cj*I*I% c""" + +C%c**+2244 ! !GF#MMOO ' 'S:)mD#*.M.M)MM#&&& ! !CLL !  ! !rJ interactionInteraction[ClientT]errorrcK|j}|:|rdStd|j|dStd|dS)aA|coro| A callback that is called when any command raises an :exc:`AppCommandError`. The default implementation logs the exception using the library logger if the command does not have any error handlers attached to it. To get the command that failed, :attr:`discord.Interaction.command` should be used. Parameters ----------- interaction: :class:`~discord.Interaction` The interaction that is being handled. error: :exc:`AppCommandError` The exception that was raised. Nz Ignoring exception in command %r)exc_infoz"Ignoring exception in command tree)r9_has_any_error_handlers_logrr}r^rrr9s rHon_errorzCommandTree.on_errorsn&%  ..00  JJ97` The coroutine to register as the local error handler. Raises ------- TypeError The coroutine passed is not actually a coroutine or does not match the signature. z&The error handler must be a coroutine.r&z$error handler must have 2 parameters)inspectiscoroutinefunctionrK signature parametersrMr)r^rparamss rHrzCommandTree.error7sf&*400 FDEE E"4((3 v;;!  BCC C  rJ)r} descriptionnsfwr:r<auto_locale_stringsextrasUnion[str, locale_str]rrrrDict[Any, Any]>Callable[[CommandCallback[Group, P, T]], Command[Group, P, T]]c 0dfd }|S)a A decorator that creates an application command from a regular function directly under this tree. 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``. Due to a Discord limitation, this does not work on subcommands. guild: Optional[:class:`~discord.abc.Snowflake`] The guild to add the command to. If not given or ``None`` then it becomes a global command instead. .. note :: Due to a Discord limitation, this keyword argument cannot be used in conjunction with contexts (e.g. :func:`.app_commands.allowed_contexts`) or installation types (e.g. :func:`.app_commands.allowed_installs`). guilds: List[:class:`~discord.abc.Snowflake`] The list of guilds to add the command to. This cannot be mixed with the ``guild`` parameter. If no guilds are given at all then it becomes a global command instead. .. note :: Due to a Discord limitation, this keyword argument cannot be used in conjunction with contexts (e.g. :func:`.app_commands.allowed_contexts`) or installation types (e.g. :func:`.app_commands.allowed_installs`). 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. funcCommandCallback[Group, P, T]r>Command[Group, P, T]c tj|stdtur|jd}nt |j}n}t turn|j|| d} ||S)Nz-command function must be a coroutine functionu…)r}rcallbackrparentrrr:r<) rrrKr+__doc__r.rrr) rdescr9rrrr:r<r}rr^s rH decoratorz&CommandTree.command..decorators.t44 Q OPPPg%%<' DD#DL11DD"!00TTdm $7G   WE&  A A ANrJ)rr r>r rC) r^r}rrr:r<rrrs ```````` rHr9zCommandTree.commandTsTt             0rJ)r}rr:r<rr,Callable[[ContextMenuCallback], ContextMenu]c,dfd }|S)a A decorator that creates an application command context menu from a regular function directly under this tree. 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. guild: Optional[:class:`~discord.abc.Snowflake`] The guild to add the command to. If not given or ``None`` then it becomes a global command instead. .. note :: Due to a Discord limitation, this keyword argument cannot be used in conjunction with contexts (e.g. :func:`.app_commands.allowed_contexts`) or installation types (e.g. :func:`.app_commands.allowed_installs`). guilds: List[:class:`~discord.abc.Snowflake`] The list of guilds to add the command to. This cannot be mixed with the ``guild`` parameter. If no guilds are given at all then it becomes a global command instead. .. note :: Due to a Discord limitation, this keyword argument cannot be used in conjunction with contexts (e.g. :func:`.app_commands.allowed_contexts`) or installation types (e.g. :func:`.app_commands.allowed_installs`). 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. rr4r>rctj|stdtur|jn}t ||} ||S)Nz2context menu function must be a coroutine function)r}rr rrr)rrrKr+rtitlerr) r actual_name context_menurrr:r<r}rr^s rHrz+CommandTree.context_menu..decorators.t44 V TUUU377??$---///K& $7 L   \v  F F F rJ)rr4r>rrC)r^r}rr:r<rrrs``````` rHrzCommandTree.context_menusNN rJOptional[Translator]c|jjS)zOptional[:class:`Translator`]: The translator, if any, responsible for handling translation of commands. To change the translator, use :meth:`set_translator`. )rY _translator)r^s rH translatorzCommandTree.translators {&&rJrc.K|2t|tstd|jjd|jj}||d{V|d|j_dS|d{V||j_dS)a^|coro| Sets the translator to use for translating commands. If a translator was previously set, it will be unloaded using its :meth:`Translator.unload` method. When a translator is set, it will be loaded using its :meth:`Translator.load` method. Parameters ------------ translator: Optional[:class:`Translator`] The translator to use. If ``None`` then the translator is just removed and unloaded. Raises ------- TypeError The translator was not ``None`` or a :class:`Translator` instance. Nz/expected None or Translator instance, received r) rr$rKrrrYrunloadload)r^rold_translators rHset_translatorzCommandTree.set_translators*  !*Z*L*L !ujNbNkuuuvv v0  % '')) ) ) ) ) ) ) )  &*DK # # #//## # # # # # # #&0DK # # #rJc Kjjt|}jrfd|Dd{V}nfd|D} |-jjj|d{V}n2jjj|j|d{V}n:#t$r-}|j dkr|j dkrt||dd}~wwxYwfd|DS) a|coro| Syncs the application commands to Discord. This also runs the translator to get the translated strings necessary for feeding back into Discord. This must be called for the application commands to show up. Parameters ----------- guild: Optional[:class:`~discord.abc.Snowflake`] The guild to sync the commands to. If ``None`` then it syncs all global commands instead. Raises ------- HTTPException Syncing the commands failed. CommandSyncFailure Syncing the commands failed due to a user related error, typically because the command has invalid data. This is equivalent to an HTTP status code of 400. Forbidden The client does not have the ``applications.commands`` scope in the guild. MissingApplicationID The client does not have an application ID. TranslationError An error occurred while translating the commands. Returns -------- List[:class:`AppCommand`] The application's commands that got synced. Nr`cLKg|]}|d{VSr|)get_translated_payload)rFr9r^rs rHrpz$CommandTree.sync..Vs@fffRYW;;D*MMMMMMMMfffrJc:g|]}|SrC)to_dict)rFr9r^s rHrpz$CommandTree.sync..Xs%EEEwt,,EEErJ)payloadiisc<g|]}t|jSrnro)rFdr^s rHrpz$CommandTree.sync..ds(DDD! 555DDDrJ) rSrgr!rrrWbulk_upsert_global_commandsbulk_upsert_guild_commandsrEr(statuscoder )r^r:rsr&reers` @rHsynczCommandTree.sync*siJ ; % -& &)))66_  Ffffff]efffffffffGGEEEEHEEEG }!ZCCDKD^hoCpppppppp!ZBB4;C]_d_gqxByyyyyyyy   x316U??(H554?   EDDDtDDDDsA!B>> C5(C00C5cK|j}d|_ t|tr|||d{V|||d{VdS#|||d{VwxYw)NT)r9command_failedrr_invoke_error_handlersrrs rH_dispatch_errorzCommandTree._dispatch_errorfs%%) " 4'7++ I44[%HHHHHHHHH-- U33 3 3 3 3 3 3 3 3 3$-- U33 3 3 3 3 3 3 3 3s 1A!!A?chfd}jj|ddS)NcK d{VdS#t$r'}|d{VYd}~dSd}~wwxYwr|)_callrr2)r-rr^s rHwrapperz.CommandTree._from_interaction..wrapperps ;jj-----------" ; ; ;**;::::::::::::::: ;s" AAAzCommandTree-invoker)r})rSloop create_task)r^rr6s`` rH_from_interactionzCommandTree._from_interactionosO ; ; ; ; ; ; $$WWYY5J$KKKKKrJrer0c|d}t|d}|dd}|j|||f}|$|jr|j|d|fS|S)Nr}ryrr)r,rr]rP)r^rer}ryrrs rH_get_context_menuzCommandTree._get_context_menuxsxF|$T:66 HHVQ  !%%tXq&9:: ;42;&**D$?;; ; rJLTuple[Command[Any, ..., Any], List[ApplicationCommandInteractionDataOption]]cg}|d}t|d}|rz |j|}||}|!|jr|j|}nM#t $r&|jsdn|j|}YnwxYw|j|}|t ||d}|dg}|r|D]y} | dddvr\||| d}||}|t ||| dg}nd}nn|t|trt|||fS) Nr}ryToptionsrr)rr&F) r,r[rrPr\rrr_get_internal_commandrrr) r^reparentsr}command_guild_idguild_commandsr9 searchingr>options rH_get_app_command_optionsz$CommandTree._get_app_command_optionss F|,T:>>  6 >!%!56F!G),,T22?t'>?"377==G  c c c&*&=b$$4CXC\C\]aCbCb c+//55G ?!$00 0  AE)UWAXAX !  ::fa((F22NN4(((!&>D%;;DAAG-dG<<<$jjB77GE %IE " gu % % 4+733 3!!s A$$-BBc\K|d}t|d}|j|||f}|$|jr|j|d|f}||_|t |gt |tj||di}|d}tj |} || } |j j |krt|| td ||| d{V|jd||dS#t$rJ} |j||| d{V||| d{VYd} ~ dSd} ~ wwxYw)Nr}ryresolved target_idz8This should not happen if Discord sent well-formed data.app_command_completion)r,r]rrP _cs_commandrr)r_get_resolved_itemsrany_withrrrr_invokerSdispatchr) r^rrerr}ryrrGrHrrr-s rH_call_context_menuzCommandTree._call_context_menusF|$T:66&**D(D+ABB   7 *..dD/ABBH#+   !$N4,@,@AA A0dhhzSU>V>VWW04xx /D/D !),, S!! = $ & &*844 4 =!"\]] ] R"";66 6 6 6 6 6 6 6 K !9; Q Q Q Q Q  0 0 0 ,'' Q777777777-- Q// / / / / / / / / / / / / / 0sE F+!?F&&F+c KdS)a|coro| A global check to determine if an :class:`~discord.Interaction` should be processed by the tree. The default implementation returns True (all interactions are processed), but can be overridden if custom behaviour is desired. TrC)r^rs rHinteraction_checkzCommandTree.interaction_checks trJcK||d{Vs d|_dS|j}|dd}|dkr||||d{VdS||\}}||_t||di|}||_|j tj urtd|Dd}|td ||||d{VnA#t$r4t d|j|j|jjYnwxYwdS |||d{V|js|jd||dSdS#t$rJ}d|_|||d{V|||d{VYd}~dSd}~wwxYw) NTrrrGc3PK|]!}|d|dV"dS)focusedr}N)r)rFopts rHrz$CommandTree._call..s7QQCcggi>P>PQCKQQQQQQrJzOThis should not happen, but there is no focused element. This is a Discord bug.z?Ignoring exception in autocomplete for %r (Guild: %s, User: %s)rI)rQr0rerrOrErJr _cs_namespacerr* autocompletenextr_invoke_autocomplete Exceptionr exceptionqualified_nameryrrE_invoke_with_namespacerSrNr1r) r^rrerr9r> namespacerTr-s rHr5zCommandTree._calls++K88888888 )-K & F2=2Bxx"" 199))+tTBB B B B B B B B F88>>#* k488J+C+CWMM %. !  ; ; ;QQ7QQQSWXXG%&wxxx 22;SSSSSSSSSS   U*($'   F U00iHH H H H H H H H - U $$%={GTTTTT U U  0 0 0)-K &00a@@ @ @ @ @ @ @ @-- Q// / / / / / / / / / / / / / 0s*3D;EEF G,"?G''G,)rSr/rPrTrQr"rRr#)rarbr:r;r>r)r:r;r>rk)r:r3r>ru) r9rr:r;r<r=rrTr>ru)r9rr:r;rrr>r)r9rr:r;rrr>r)r9rr:r;rr)r>r)r:r;rrr>ru)r:r;rrr>r)r:r;rrr>r)r:r;rr)r>r)r:r;rrr>r)r:r;rrr>r)r:r;rrr>r)r:r;rrr>r)r:r;rr)r>r)r:r;r>r)r}rr>ru)rrrrr>ru)rrr>r)r}rrrrrTr:r;r<r=rrTrrr>r)r}rrrTr:r;r<r=rrTrrr>r)r>r)rrr>ru)rrr>ru)rer0r>r)rer0r>r<)rrrer0rrbr>ru)rrr>rT)#r __module__ __qualname__rr+r_rjrtrrrrr)rrrrrrrrrr9rpropertyrr r.r2r9r;rErOrQr5rCrJrHr8r8os:$(.507 TTTTTT6W[%;%;%;%;%;%;NDH&O&O&O&O&O&OP*1*1*1*1b&-&-}/}/}/}/}/}/~ &) $$$$$X$ &)36 =====X= &) JJJJJXJ&*-8 ,6,6,6,6,6,6\^b''''''R &) $$$$$X$ &)36 =====X= &) JJJJJXJ&*-8 )0)0)0)0)0)0V&)     X &)99999X9&)SSSSSXS&)), FFFFFXF&*)- *u*u*u*u*u*uX&)11111X1&)36 JJJJJXJ&)uuuuuXu&*-8 ,",",",",","^/3&!!!!4MMMM8@(/.5%,&-$(!(RRRRRRn(/%,&-$(!(VVVVVVp'''X' 1 1 1 1D:>:E:E:E:E:E:Ex4444LLLL3"3"3"3"j'R'R'R'RR    3U3U3U3U3U3UrJr8)r9rr:r;r<r=r>r?)Lr __future__rloggingrtypingrrrrrr r r r r rrrrr collectionsrr^rrmodelsrrsrrrerrorsrrrrrr r!installsr"r#rr$r%r'r(enumsr)r*utilsr+r,r-r._typesr/types.interactionsr0r1 interactionsr2abcr3r4r5r6r7 ErrorFunc__all__ getLoggerrrrNr8rCrJrHrrsJ0#"""""" -,,,,,,,1111111111=<<<<<<<........3333333333333333GGGGGGGGGGGG oooooooo******DDDDDDDDDDDD W /#sC-  "I w""07V]4nUnUnUnUnU''"nUnUnUnUnUrJ