cjh9dZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z m Z ddlmZmZmZmZmZmZmZddlmZddlmZdd lmZmZmZmZmZm Z m!Z!m"Z"dd l#m$Z$m%Z%m&Z&dd l'm(Z(m)Z)dd l*m+Z+dd l,m-Z-ddl.m*Z*ddl/m0Z0ddl1m2Z2m3Z3m4Z4m5Z5edeeeeffZ6ede6Z7dZ8ejre:Z;Gdde Z<GddeGdde=e-Z?y)ae The MIT License (MIT) Copyright (c) 2015-2021 Rapptz Copyright (c) 2021-present Pycord Development Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ) annotationsN)ABCabstractmethod)AnyCallable Coroutine GeneratorLiteralMappingTypeVar)Client)CogMixin)ApplicationCommandApplicationContextAutocompleteContextMessageCommand SlashCommandSlashCommandGroup UserCommandcommand)IntegrationTypeInteractionContextTypeInteractionType) CheckFailureDiscordException) Interaction)AutoShardedClient) interactions)User)MISSING async_allfindget.CFT)bound)ApplicationCommandMixinBotAutoShardedBotceZdZdZd!fd ZedZedZed"dZed#dZ d$dZ d%dZ ed Z d e f d&d Z d' d(d Z d) d*dZ d+ d,dZd ddd d gd f d-dZ d. d/dZ d0dZdZdZdZdZdZ d' d1dZ d2 d3dZeZd4dZef d5dZe f d6dZ!d7dZ"ee#d8d Z$xZ%S)9r'aA mixin that implements common functionality for classes that need application command compatibility. Attributes ---------- application_commands: :class:`dict` A mapping of command id string to :class:`.ApplicationCommand` objects. pending_application_commands: :class:`list` A list of commands that have been added but not yet registered. This is read-only and is modified via other methods. c@t||i|g|_i|_yN)super__init___pending_application_commands_application_commands)selfargskwargs __class__s >/var/www/html/venv/lib/python3.12/site-packages/discord/bot.pyr.z ApplicationCommandMixin.__init__Ts% $)&)-/*%'"c|jSr,)r0r1s r5 all_commandsz$ApplicationCommandMixin.all_commandsYs)))r6c|jSr,)r/r8s r5pending_application_commandsz4ApplicationCommandMixin.pending_application_commands]s111r6c|j}|jjr/t|jdr|t |jdz }|S)Nprefixed_commands)application_commands_bot_supports_prefixed_commandshasattrgetattr)r1commandss r5rCz ApplicationCommandMixin.commandsasH,, 99 0 0W II*6   +>? ?Hr6cHt|jjSr,)listr0valuesr8s r5r>z,ApplicationCommandMixin.application_commandsjsD..55788r6czt|tr|jr td|jj r'|j |jj |_|jjr'|j|jj|_|jjr'|j|jj|_ |jD]3}||k(s |j|_ ||j|j<n|jj|y)a]Adds an :class:`.ApplicationCommand` into the internal list of commands. This is usually not called, instead the :meth:`command` or other shortcut decorators are used instead. .. versionadded:: 2.0 Parameters ---------- command: :class:`.ApplicationCommand` The command to add. z.The provided command is a sub-command of groupN) isinstancer is_subcommand TypeErrorr? debug_guilds guild_idsdefault_command_contextscontexts!default_command_integration_typesintegration_typesr;idr0r/append)r1rcmds r5add_application_commandz/ApplicationCommandMixin.add_application_commandns g| ,1F1FLM M 99 ! !g&7&7&? $ 6 6G  99 - -'2B2B2J#yyAAG  II 7 7))1(, (S(SG %44 Cg~ VV 9@**7::6   **11':r6c|jr&|jj|jd||jvr|jj ||Sy)aRemove an :class:`.ApplicationCommand` from the internal list of commands. .. versionadded:: 2.0 Parameters ---------- command: :class:`.ApplicationCommand` The command to remove. Returns ------- Optional[:class:`.ApplicationCommand`] The command that was removed. If the command has not been added, ``None`` is returned instead. N)rQr0popr/remover1rs r5remove_application_commandz2ApplicationCommandMixin.remove_application_commandsQ& ::  & & * *7::t < d88 8  . . 5 5g >N 9r6c|jS)zShortcut for :meth:`.get_application_command`. .. note:: Overridden in :class:`ext.commands.Bot`. .. versionadded:: 2.0 )get_application_commandr8s r5 get_commandz#ApplicationCommandMixin.get_commands+++r6Nc^|jj}|D] }|j|k(r#t||r||j|k7ry|cS|j x}d|jk(sYt|t sjt|dkDrZt||jd}t|t r||j|k7ry|j}t|dkDrZt||j}t||r||j|k7ry|cSy)atGet an :class:`.ApplicationCommand` from the internal list of commands. .. versionadded:: 2.0 Parameters ---------- name: :class:`str` The qualified name of the command to get. guild_ids: List[:class:`int`] The guild ids associated to the command to get. type: Type[:class:`.ApplicationCommand`] The type of the command to get. Defaults to :class:`.ApplicationCommand`. Returns ------- Optional[:class:`.ApplicationCommand`] The command that was requested. If not found, returns ``None``. Nrr name) r0rFr_rHrLsplitrlenr$rV subcommands)r1r_rLtyperCrnamess r5r[z/ApplicationCommandMixin.get_application_commands2--446 G||t# 7D(A(W->->)-K::<'%+w||; *A%j1n!(1>G%g/@A!-'2C2Cy2P&22H %j1nhUYY[9!'40)g.?.?9.L) r6c p Kd fd g}|jj}||Dcgc]}|j|}}n)|Dcgc]}|j||jvr| }}g}||}n|jjr|L|jj j |jjjd{}nL|jj j|jjj|d{}|Dcic]}|d| }}|D]}|j|j} | |j|dd5 || r/|j|dt||jddm|j|dt| dd|jD]B\}} t|||d } | |j||dt| dd d D|Scc}wcc}w7X7cc}ww) at|coro| Gets the list of commands that are desynced from discord. If ``guild_id`` is specified, it will only return guild commands that are desynced from said guild, else it will return global commands. .. note:: This function is meant to be used internally, and should only be used if you want to override the default command registration behavior. .. versionadded:: 2.0 Parameters ---------- guild_id: Optional[:class:`int`] The guild id to get the desynced commands for, else global commands if unspecified. prefetched: Optional[List[:class:`.ApplicationCommand`]] If you already fetched the commands, you can pass them here to be used. Not recommended for typical usage. Returns ------- List[Dict[:class:`str`, Any]] A list of the desynced commands. Each will come with at least the ``cmd`` and ``action`` keys, which respectively contain the command and the action to perform. Other keys may also be present depending on the action, including ``id``. c  t|trt|jt|j dgk7ryt |jD]5\} t fd|dDt}|tus+ |s5yy|j}ddddddgdddd }|jD]\}}t||tk(rdgf}|D]} ||vr'||D cgc]} | j | tc} ng} t | D]\}} | |vs t| |<|j |ttusn| ||D cgc]} | j | tc} k7syt||d|j |k7s|dk(r!t||dur|j |yycc} wcc} w)NoptionsTc3FK|]}|djk(r|yw)r_Nr^).0data subcommands r5 zXApplicationCommandMixin.get_desynced_commands.._check_command.. s) $#F|z>!s!)rcr_ description autocompletechoicesname_localizationsdescription_localizations) nsfwdefault_member_permissionsr_rmrprqrgrNrPFdefault_permission) rHrrarbr$ enumeratenextr!to_dictitemsrcrErB)rSmatchimatch_as_dictto_checkcheckvalue falsy_valsoptvalcmd_valsrk_check_commands @r5rzEApplicationCommandMixin.get_desynced_commands.._check_commands #01s'3uyyB/G+HH%.s%? $MAz!(-i(8  FW, F1S# $@i++- 26 #'*.15 !%)-#&%-NN$4$LE5HUO,4',R[ #(,C$)G#3CJ%. Q3g!6 Q%'% +4H*=:3#&*#429HQK: %yy %w %, -19AFu>:=W 5>2(,, !eT2eii6FF"%99 'U 3t ; % % 0 8%#?$@3!R>s 1G G Nr_upsert)ractioneditrQ)rrrQr^delete)rrQr)rSrryzMapping[str, Any]returnbool)r;copyrLr?userhttpget_global_commandsrQget_guild_commandsr$r_rRintrx) r1guild_id prefetched return_valuecmdsrSpendingregistered_commandsregistered_commands_dictryvalue_rs @r5get_desynced_commandsz-ApplicationCommandMixin.get_desynced_commandssUBD L 00557  &*Dscmm.CsDGD ==,S]]1JG FH  !",  YY^^,0IINN,N,NIINN%%-'#-1IINN,M,MIINN%%x-'#AT#TCK$4#T #T C,00:E}##x$HIU+###&"(!":388"DT"JK## #t3uT{;KL (499; KC&>s&CF&KLE}###;C#@#H!&,/"* sE''$UsZ)H6H!H!H6 #H&,A'H6H+A H6 H.!H6) H16B?H666H6.H61H6TcKtw)a|coro| Registers a command. If the command has ``guild_ids`` set, or if the ``guild_ids`` parameter is passed, the command will be registered as a guild command for those guilds. Parameters ---------- command: :class:`~.ApplicationCommand` The command to register. force: :class:`bool` Whether to force the command to be registered. If this is set to False, the command will only be registered if it seems to already be registered and up to date with our internal cache. Defaults to True. guild_ids: :class:`list` A list of guild ids to register the command for. If this is not set, the command's :attr:`ApplicationCommand.guild_ids` attribute will be used. Returns ------- :class:`~.ApplicationCommand` The command that was registered )NotImplementedError)r1rforcerLs r5register_commandz(ApplicationCommandMixin.register_commands8"!s bulkFc F K| j}|Dcgc]}tj|}}|D] }g}||_du}g} |rtt d|} j j jj j jj j jj j jd d%fd ntt fd|} j j jj j jj j jj j jd d%fd ddd d&fd} g} |sg} j jrLj j j!j jj"d{} nLj j j%j jj"d{} j'| d{}|D]}|d d k(r<| j)|rd ndt+j,d d g|d|ddGt/| |dj0|dj2}|r|d dk(r| j)d||dd|d dk(r| j)d|d|d | j)d|dt5d|d tt d| }tt d| }|dk(s|dk(rt7|t7| k(r|Dcgc]}|dj9}}t7|dk(rt:j=d| } n*t:j=d| Dcic]}|dj0|d c}| d|dd{} n|sg} |D]}|d d k(r%| d |d|dj0d{0|d dk(rF| j)| d|d|dj9|dj0d{~|d dk(rB| j)| d|dj9|dj0d{t5d|d |dk7rj jrˉLj j j!j jj"d{} n}j j j%j jj"d{} n0| Dcgc]}|j9}}| d| d{} | D]u}t/j|d |j/d!}|s$t5d"|d d#|j/d!d$|d|_|j>|j"<w| Scc}w7p7&7cc}wcc}w7`7-777#7cc}w7w)'a8|coro| Register a list of commands. .. versionadded:: 2.0 Parameters ---------- commands: Optional[List[:class:`~.ApplicationCommand`]] A list of commands to register. If this is not set (``None``), then all commands will be registered. guild_id: Optional[int] If this is set, the commands will be registered as a guild command for the respective guild. If it is not set, the commands will be registered according to their :attr:`ApplicationCommand.guild_ids` attribute. method: Literal['individual', 'bulk', 'auto'] The method to use when registering the commands. If this is set to "individual", then each command will be registered individually. If this is set to "bulk", then all commands will be registered in bulk. If this is set to "auto", then the method will be determined automatically. Defaults to "bulk". force: :class:`bool` Registers the commands regardless of the state of the command on Discord. This uses one less API call, but can result in hitting rate limits more often. Defaults to False. delete_existing: :class:`bool` Whether to delete existing commands that are not in the list of commands to register. Defaults to True. Nc|jduSr,rLcs r5z;ApplicationCommandMixin.register_commands..sAKK4,?r6)rrrrc|jjxr jjjg|i|Sr,r?rrQ)methodr2r3registration_methodsr1s r5 _registerz._registersH4+F3IINN8tyy~~'8'8;?CIr6c@|jduxr|jvSr,r)rrs r5rz;ApplicationCommandMixin.register_commands..sakk5Q(akk:Qr6c|jjxr jjjg|i|Sr,r)rr2r3rrr1s r5rz._registersJ4+F3IINN8tyy~~'8'8(EIMSr6)cmd_namercx|jddr|dk(r0tjd|dDcgc]}|d c}d|nb|dk(rtjd |d|nA|d k(rtjd |d|n |d k(rtjd |d||g|i|Scc}w)N_logTrzBulk updating commands rr_z for guild rzCreating command rzEditing command rzDeleting command )rVrdebug)rrrr2r3rrs r5registerz;ApplicationCommandMixin.register_commands..registerszz&$'V#JJ1d1g2N1V92N1OP""*-x'JJ!28*KzRSv%JJ!1(;xjQRx'JJ!28*KzRSV5d5f5 53Os B7 )rrrrCommandr_rr^rQ)rrrQ)r_rcrr)rrzUnknown action: c|dduS)Nrrs r5rz;ApplicationCommandMixin.register_commands..Js8D!8r6c|ddk7S)Nrrr)as r5rz;ApplicationCommandMixin.register_commands..Ms8!8r6rautorz5Skipping bulk command update: Commands are up to datez&Bulk updating commands %s for guild %sF)r)rrczRegistered command z, type z not found in pending commands)r+Literal['bulk', 'upsert', 'delete', 'edit'])rrrstrr int | None) r;rrLrEfilterr?rbulk_upsert_global_commandsupsert_global_commanddelete_global_commandedit_global_commandbulk_upsert_guild_commandsupsert_guild_commanddelete_guild_commandedit_guild_commandrrrQrrrR collections namedtupler$r_rc ValueErrorrarwrrr0)r1rCrrrdelete_existingrS to_rep_with is_global registeredrrpending_actionsprefetched_commandsdesyncedryfiltered_no_actionfiltered_deletedrjrrzrrs` ` @@r5register_commandsz)ApplicationCommandMixin.register_commandss>  88H.67sDIIcN77   ,'j +  ,$  6"?JKG BB))..>>))..>> :: $  C QG AA))..==))..== 99 $  C !#'  6? 6 6!  6*IK yy~~#04 0R0R ))1+'15 0Q0Q ))81+'"77!.A8H ' Ix=H,#**2Aht'R{'='=i&'R%(^(#&d) G#i.*=*=C NDWDWX=x=F*#**&,',"%d)]h.#**&.', ]*#**&*',%'7H %GHHO' IP"&8/J"  $8/J  & S)9%:c'l%J=MMSI..0MM)*a/JJVW!4JJJ@APQA9**AhK7Q  (05'I!IJ)!#J-MC8}0&$I%(^%8%8%-  !8}."))"* & #D #I 6 6 8),Y)<)<)1 #X(2"))"* ( #I 6 6 8),Y)<)<)1 #)+;CM?)KLL;M@99>>'+/99>>+M+M IINN--,& ,099>>+L+L IINN--x,& .55cCKKM5D5'xHHJ 5A11vYUU6]C  )!F)GAEE&M?K((tWCF14D & &svv . 5g8V++lNR"J &&6HsZ!Y1GZ!Y6A Z!Y9Z!.Y</D3Z!"Y?<=Z!9Z Z!)Z *5Z!Z  A Z!)Z *A Z!3Z 4A>Z!2Z3A Z!?Z Z! Z Z!0Z1BZ!9Z!<Z!? Z! Z!Z!Z!Z!Z!Z!c Ktt|xsg|jjxsgz}| |j}||D] }||_ |Dcgc]}|j |} }|j | |||d{} i} |rg} |D]*}|j | j|j ,|| j|t| D]N} |Dcgc]}|j | |j vr| }}|j || |||d{}|| | <P| D]St|jddjd}|s1d|_ ||j|j<U|rb| r_| jD]K\} }|D]Atfd|j}|sd|_ ||j|j<CMyyycc}w7kcc}w7խw) a |coro| Registers all commands that have been added through :meth:`.add_application_command`. This method cleans up all commands over the API and should sync them with the internal cache of commands. It attempts to register the commands in the most efficient way possible, unless ``force`` is set to ``True``, in which case it will always register all commands. By default, this coroutine is called inside the :func:`.on_connect` event. If you choose to override the :func:`.on_connect` event, then you should invoke this coroutine as well such as the following: .. code-block:: python @bot.event async def on_connect(): if bot.auto_sync_commands: await bot.sync_commands() print(f"{bot.user.name} connected.") .. note:: If you remove all guild commands from a particular guild, the library may not be able to detect and update the commands accordingly, as it would have to individually check for each guild. To force the library to unregister a guild's commands, call this function with ``commands=[]`` and ``guild_ids=[guild_id]``. .. versionadded:: 2.0 Parameters ---------- commands: Optional[List[:class:`~.ApplicationCommand`]] A list of commands to register. If this is not set (None), then all commands will be registered. method: Literal['individual', 'bulk', 'auto'] The method to use when registering the commands. If this is set to "individual", then each command will be registered individually. If this is set to "bulk", then all commands will be registered in bulk. If this is set to "auto", then the method will be determined automatically. Defaults to "bulk". force: :class:`bool` Registers the commands regardless of the state of the command on Discord. This uses one less API call, but can result in hitting rate limits more often. Defaults to False. guild_ids: Optional[List[:class:`int`]] A list of guild ids to register the commands for. If this is not set, the commands' :attr:`~.ApplicationCommand.guild_ids` attribute will be used. register_guild_commands: :class:`bool` Whether to register guild commands. Defaults to True. check_guilds: Optional[List[:class:`int`]] A list of guilds ids to check for commands to unregister, since the bot would otherwise have to check all guilds. Unlike ``guild_ids``, this does not alter the commands' :attr:`~.ApplicationCommand.guild_ids` attribute, instead it adds the guild ids to a list of guilds to sync commands for. If ``register_guild_commands`` is set to False, then this parameter is ignored. delete_existing: :class:`bool` Whether to delete existing commands that are not in the list of commands to register. Defaults to True. N)rrr)rrrrr_rc)r_rLrcrQc|jdk(xrS|jjdk(xr3|jduxr#jdx}xr||jvS)Nr_rcr)r_rcr$rL)rSrrzs r5rz7ApplicationCommandMixin.sync_commands..slCHH& $9%6HHf 5%6MM5%6*+z)::X%6% 5 r6) rEsetr?rKr;rLrextendr$rQr0rxr#)r1rCrrrLregister_guild_commands check_guildsrrSglobal_commandsrregistered_guild_commands cmd_guild_idsrguild_commandsapp_cmds guild_cmdsrzs @r5 sync_commandsz%ApplicationCommandMixin.sync_commandssfxC!3 8N8N8TRT UVW  88H   * )  *+3L3cmm6K3LL$($:$: F%%;%  WY! "')M 8==,!((7 8'$$\2 . ? ("}}0X5N"" "&!7!7"%!$3 "8"7?)(3 ?% 9A11vYUU6] C 458**3662 9 #'@(A(G(G(I =$*# =A6 99 C tWCF9G/+G//G> G4 G>&AG>(#G7 G>&G<'=G>%BG>7G>cXK||jj}|jtjtj fvryd} |j r|j|j d}|jtj ur|jj%d||S|j'|d{}|r||_|j+|d{y#t$r/|j|jzD]}|j s|j jd}|r t|}|j|j dk(sU||jk(s*t|jt s||jvs|}n|r_|j rS|j jd}||j#d{7n|j#|gd{7|jj%d|cYSYwxYw7d7Ew)a|coro| This function processes the commands that have been registered to the bot and other groups. Without this coroutine, none of the commands will be triggered. By default, this coroutine is called inside the :func:`.on_interaction` event. If you choose to override the :func:`.on_interaction` event, then you should invoke this coroutine as well. This function finds a registered command matching the interaction id from application commands and invokes it. If no matching command was found, it replies to the interaction with a default message. .. versionadded:: 2.0 Parameters ---------- interaction: :class:`discord.Interaction` The interaction to process auto_sync: Optional[:class:`bool`] Whether to automatically sync and unregister the command if it is not found in the internal cache. This will invoke the :meth:`~.Bot.sync_commands` method on the context of the command, either globally or per-guild, based on the type of the command, respectively. Defaults to :attr:`.Bot.auto_sync_commands`. NrQrr_)runknown_application_command!application_command_auto_complete)r?auto_sync_commandsrcrapplication_command auto_completerjr0KeyErrorr>r;r$rr_rLrHrErdispatchget_application_contextrinvoke_application_command)r1 interaction auto_syncrrSrctxs r5process_application_commandsz4ApplicationCommandMixin.process_application_commandss8   44I     / /  ) )$   -1 V44[5E5Ed5KL2   << <99%%3[' 00== !CK--c222A V0043T3TT V##*//33J?H#&x=xx;#3#3F#;; CMM1&s}}d; (CMM 9#& V!1!1*//33J?H'"00222"00xj0IIIyy))*GUU V:> 3s{AH* (C(3A H*H$!H*"H'#H*(2H!AH! )H! H!AH!GH!9G<:!H!H* H!!H*'H*cBKdfd }jjj|} jjdfddd{|j s|j yy7&#t j$rYywxYww)NcKjd{}|_j|d{S7%7wr,)get_autocomplete_contextrinvoke_autocomplete_callback)rrrr1s r5callbackzNApplicationCommandMixin.on_application_command_auto_complete..callbacklsA55kBBC!CK===cBB BCBsA> AAAArc|k(Sr,r)rzrrs r5rzNApplicationCommandMixin.on_application_command_auto_complete..us 1<r6)r~timeoutrNone)r?loop create_taskwait_fordonecancelasyncio TimeoutError)r1rrrautocomplete_tasks``` r5$on_application_command_auto_completezApplicationCommandMixin.application_command..decorators*&W&v&t,F  ( ( 0Mr6)rrr)r1r3r s`` r5rz+ApplicationCommandMixin.application_commands  r6c &|jdi|S)aAn alias for :meth:`application_command`. .. note:: This decorator is overridden by :class:`discord.ext.commands.Bot`. .. versionadded:: 2.0 Returns ------- Callable[..., :class:`ApplicationCommand`] A decorator that converts the provided method into an :class:`.ApplicationCommand`, adds it to the bot, then returns it. r)rrs r5rzApplicationCommandMixin.commands(t''1&11r6c P|xsd}t|||fi|}|j||S)aBA shortcut method that creates a slash command group with no subcommands and adds it to the internal command list via :meth:`add_application_command`. .. versionadded:: 2.0 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. kwargs: Any additional keyword arguments to pass to :class:`.SlashCommandGroup`. Returns ------- SlashCommandGroup The slash command group that was created. zNo description provided.)rrT)r1r_rmrLr3groups r5 create_groupz$ApplicationCommandMixin.create_groups5:"?%? !$ YI&I $$U+ r6c dfd }|S)ajA shortcut decorator that initializes the provided subclass of :class:`.SlashCommandGroup` and adds it to the internal command list via :meth:`add_application_command`. .. 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 |j|j4xs2tj|jj dnd}j ||S)NrzNo description providedr)__name____doc__inspectcleandoc splitlinesrT)rr rmrLr_r1s r5innerz,ApplicationCommandMixin.group..inner sg$ {{. P7#3#3CKK#@#K#K#Ma#P2#E  ( ( /Lr6)rztype[SlashCommandGroup]rrr)r1r_rmrLrs```` r5r zApplicationCommandMixin.groups6   r6c#K|jD]/}t|tr|jEd{|1y7 w)zAn iterator that recursively walks through all application commands and subcommands. Yields ------ :class:`.ApplicationCommand` An application command from the internal list of application commands. N)r>rHr walk_commandsrXs r5walk_application_commandsz1ApplicationCommandMixin.walk_application_commandssD00 G'#450700222M 2s4AA AcK|||Sw)aH|coro| Returns the invocation context from the interaction. This is a more low-level counter-part for :meth:`.process_application_commands` to allow users more fine-grained control over the processing. Parameters ----------- interaction: :class:`discord.Interaction` The interaction to get the invocation context from. cls The factory class that will be used to create the context. By default, this is :class:`.ApplicationContext`. Should a custom class be provided, it must be similar enough to :class:`.ApplicationContext`\'s interface. Returns -------- :class:`.ApplicationContext` The invocation context. The type of this can change via the ``cls`` parameter. rr1rrs r5rz/ApplicationCommandMixin.get_application_context+44%% cK|||Sw)aO|coro| Returns the autocomplete context from the interaction. This is a more low-level counter-part for :meth:`.process_application_commands` to allow users more fine-grained control over the processing. Parameters ----------- interaction: :class:`discord.Interaction` The interaction to get the invocation context from. cls The factory class that will be used to create the context. By default, this is :class:`.AutocompleteContext`. Should a custom class be provided, it must be similar enough to :class:`.AutocompleteContext`\'s interface. Returns -------- :class:`.AutocompleteContext` The autocomplete context. The type of this can change via the ``cls`` parameter. rrs r5rz0ApplicationCommandMixin.get_autocomplete_contextGrrcK|jjd| |jj|dd{r$|jj |d{n t d |jjd|y7Q70#t $r/}|jj||d{7Yd}~yd}~wwxYww)a|coro| Invokes the application command given under the invocation context and handles all the internal event dispatch mechanisms. Parameters ---------- ctx: :class:`.ApplicationCommand` The invocation context to invoke. rT call_onceNz'The global check once functions failed.application_command_completion)r?rcan_runrinvokerrdispatch_error)r1rexcs r5rz2ApplicationCommandMixin.invoke_application_commandcs 0#6 FYY&&sd&;;;kk((---"#LMM. II  ? E<-  7++,,S#6 6 6 7s^C BB"B#B$B5CBB CC >C?C C CCcyr,rr8s r5r?zApplicationCommandMixin._botys,/r6r)rzlist[ApplicationCommand | Any])rzlist[ApplicationCommand])rrrr)rrrApplicationCommand | None)r_rrLlist[int] | Nonercztype[ApplicationCommand]rr()NN)rrrz,list[interactions.ApplicationCommand] | Nonerzlist[dict[str, Any]])TN)rrrrrLr)rr)NNrFT) rClist[ApplicationCommand] | Nonerrr%Literal['individual', 'bulk', 'auto']rrrrrz%list[interactions.ApplicationCommand])rCr*rr+rrrLr)rrrr)rrrrr,)rrrz bool | Nonerr)rrrrrr)r_rrm str | NonerLr)rr)NNN)r_r,rmr,rLr)rz6Callable[[type[SlashCommandGroup]], SlashCommandGroup])rz)Generator[ApplicationCommand, None, None])rrrrrr)rrrrrr)rrrr)rzBot | AutoShardedBot)&r __module__ __qualname__rr.propertyr9r;rCr>rTrYr\rr[rrrrrrrrrrrrr  slash_grouprrrrrrrr? __classcell__r4s@r5r'r'Gs- ( **2299;B) "4 , ,'+); ..$.' . # .d $CGddAd  dR&* "#""$ "  "@59#8> $ u1uu6 u  u  u /ur598>&*(,)+ $|=1|=6|= |= $ |= "& |='|=|= |=~BFI3&I33>I3 I3V+&+1C+ +* D C F(2(#'&*    $   H "&&* (( ($ ( @ (TK 4F&&&-0& &:4G&&&-0& &8F,//r6r'ceZdZdZdfd ZdZdZ ddZdZddddZ dddd Z d Z dd dd Z d Z d ZddZxZS)BotBaseFc,t||i|i|_i|_g|_g|_d|_d|_|rtj|nd|_ |jd|_ |jdt|_|jdd|_|j!dd|_|j!dt$j&t$j(t$j*h|_|j!dt.j0h|_|jr|jr t5d |jrPt7|jt8j:j<s"t5d |jj>t7|j,t8j:j<s"t5d |j,j>t7|j2t8j:j<s"t5d |j2j>t|j,|_t|j2|_g|_g|_d|_d|_y) Nowner_id owner_idsrTrKrMrOz$Both owner_id and owner_ids are set.z#owner_ids must be a collection not z2default_command_contexts must be a collection not z;default_command_integration_types must be a collection not ) r-r._BotBase__cogs_BotBase__extensions_checks _check_once_before_invoke _after_invokerrrmr$r7rr8rrVrKrguildbot_dmprivate_channelrMr guild_installrOrJrHrabc Collectionr4)r1rmr2rgr4s r5r.zBotBase.__init__s5 $*'*  "!>* NNKOO66# 5dnn6N6N5QR $779S9STDTEbEbElElDop   2 2KOO4N4N MdNtNtN~N~NBC ),D,I,I(J%14  2 22 . "!r6cZK|jr|jd{yy7wr,)rrr8s r5 on_connectzBotBase.on_connects)  " "$$& & & # &s +)+cBK|j|d{y7wr,)r)r1rs r5on_interactionzBotBase.on_interactions// <<.Bs4!qv4s)r<r;r")r1rr!rjs ` r5r#zBotBase.can_run9s;$-t$,,4t44444s 5?=?cTtj|s td||_|S)asA 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, a :class:`.Context`. .. note:: The :meth:`~.Bot.before_invoke` and :meth:`~.Bot.after_invoke` hooks are only called if all checks and argument parsing procedures pass without error. If any check or argument parsing procedures fail then the hooks are not called. 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.)riscoroutinefunctionrJr=r1coros r5 before_invokezBotBase.before_invokeDs+0**40FG G" r6cTtj|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, a :class:`.Context`. .. note:: Similar to :meth:`~.Bot.before_invoke`\, this is not called unless checks and argument parsing procedures succeed. This hook is, however, **always** called regardless of the internal command callback raising an error (i.e. :exc:`.CommandInvokeError`\). This makes it ideal for clean-up scenarios. 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.)rrfrJr>rgs r5 after_invokezBotBase.after_invokebs+4**40GH H! r6cK|jr|j|jk(S|jr|j|jvS|jd{}|jrC|jj Dchc]}|jc}x|_}|j|vS|j jx|_}|j|k(S7cc}ww)a]|coro| Checks if a :class:`~discord.User` or :class:`~discord.Member` is the owner of this bot. If an :attr:`owner_id` is not set, it is fetched automatically through the use of :meth:`~.Bot.application_info`. .. versionchanged:: 1.3 The function also checks if the application is team-owned if :attr:`owner_ids` is not set. Parameters ---------- user: :class:`.abc.User` The user to check for. Returns ------- :class:`bool` Whether the user is the owner. N)r7rQr8application_infoteammembersowner)r1rappmidsr7s r5is_ownerzBotBase.is_owners0 ==77dmm+ + ^^77dnn, ,--//Cxx69hh6F6F'G'GGww#~%+.99<<7 ww(** 0'Gs%AC&C (C&C!AC&!C&r,)rVrrWrrr)r!rrr)rrr!rrr)rr rr)rr-r.r@r.rFrHrJr~rZr_rar#rirkrtr1r2s@r5r4r4~s"'9"v'= ) 6F  <.49&"7<(:=B 5% 559 5  5<@#+r6r4c"eZdZdZeddZy)r(aRepresents a discord bot. This class is a subclass of :class:`discord.Client` and as a result anything that you can do with a :class:`discord.Client` you can do with this bot. This class also subclasses ``ApplicationCommandMixin`` to provide the functionality to manage commands. .. versionadded:: 2.0 Attributes ---------- description: :class:`str` The content prefixed into the default help message. owner_id: Optional[:class:`int`] The user ID that owns the bot. If this is not set and is then queried via :meth:`.is_owner` then it is fetched automatically using :meth:`~.Bot.application_info`. owner_ids: Optional[Collection[:class:`int`]] The user IDs that owns the bot. This is similar to :attr:`owner_id`. If this is not set and the application is team based, then it is fetched automatically using :meth:`~.Bot.application_info`. For performance reasons it is recommended to use a :class:`set` for the collection. You cannot set both ``owner_id`` and ``owner_ids``. .. versionadded:: 1.3 debug_guilds: Optional[List[:class:`int`]] Guild IDs of guilds to use for testing commands. The bot will not create any global commands if debug guild IDs are passed. .. versionadded:: 2.0 auto_sync_commands: :class:`bool` Whether to automatically sync slash commands. This will call :meth:`~.Bot.sync_commands` in :func:`discord.on_connect`, and in :attr:`.process_application_commands` if the command is not found. Defaults to ``True``. .. versionadded:: 2.0 default_command_contexts: Collection[:class:`InteractionContextType`] The default context types that the bot will use for commands. Defaults to a set containing :attr:`InteractionContextType.guild`, :attr:`InteractionContextType.bot_dm`, and :attr:`InteractionContextType.private_channel`. .. versionadded:: 2.6 default_command_integration_types: Collection[:class:`IntegrationType`]] The default integration types that the bot will use for commands. Defaults to a set containing :attr:`IntegrationType.guild_install`. .. versionadded:: 2.6 c|Sr,rr8s r5r?zBot._bot r6N)rr(rr-r.rr/r?rr6r5r(r(s0dr6r(c"eZdZdZeddZy)r)zThis is similar to :class:`.Bot` except that it is inherited from :class:`discord.AutoShardedClient` instead. .. versionadded:: 2.0 c|Sr,rr8s r5r?zAutoShardedBot._botrwr6N)rr)rxrr6r5r)r)s r6r))@r __future__rrrcollections.abcrrloggingrQrSrCrrtypingrrrr r r r clientrrOrrCrrrrrrrrenumsrrrerrorsrrrrshardrtypesrr utilsr!r"r#r$CoroFuncr%__all__ getLoggerrrr'r4r(r)rr6r5rs2#  #QQQ   LK2%$00 C3S=11 2 e8$  w"t0ct0n!g+%xg+T 5'65p W/ r6