iUdZddlmZddlZddlmZmZmZmZm Z m Z m Z m Z m Z mZmZmZddlZddlZddlmZmZmZmZmZmZmZmZmZddlmZddlm Z dd l!m"Z"erdd l#m$Z$m%Z%m&Z&dd lm'Z'dd l(m)Z)dd l*m+Z+ddl,m-Z-ddl.m/Z/ddl0m1Z1ddl2m3Z3ddl4m5Z5ddl6m7Z7ddl8m9Z9m:Z:ddl;mm?Z?m@Z@mAZAddlBmCZCddlDmEZEddlFmGZGddlHmIZIddlJmKZKddlLmMZMe deNZOdZPejQjRZRd eSd!<e d"ZTe d#d$ZUer e%d%ZVn e d%ZVd.d)ZWGd*d+e e"ZXGd,d-ejYjZe e"Z[dS)/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) TYPE_CHECKINGAnyDict GeneratorGenericListOptionalTypeVarUnionSequenceTypeoverload) InteractionMessage Attachment MessageTypeUserPartialMessageable Permissions ChannelTypeThread)Typing) StringView)BotT)Self ParamSpec TypeGuard)MessageableChannel)Guild)Member)ConnectionState) ClientUser) VoiceProtocol)Embed)File)AllowedMentions) GuildSticker StickerItem)MessageReferencePartialMessage)BaseViewView LayoutView)!ApplicationCommandInteractionData)Poll)Cog)Command) Parameter) TracebackTypeBE)bound)ContextrMISSINGTCogTr2PobjreturnTypeGuard[Cog]c"t|dS)N__cog_commands__)hasattr)r=s ]/usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages/discord/ext/commands/context.pyis_cogrDRs 3* + ++c6eZdZddZddZdd Zdd ZddZdS) DeferTypingctx Context[BotT] ephemeralboolc"||_||_dSN)rHrJ)selfrHrJs rC__init__zDeferTyping.__init__Ws"%(rEr>NonecK|jjrU|jjjs4|jjj|jd{VdSdSdS)NrJ)rH interactionresponseis_donedeferrJrNs rCdo_deferzDeferTyping.do_defer[s 8  P(<(E(M(M(O(O P(&/555OO O O O O O O O O O P P P PrEGenerator[Any, None, None]cN|SrM)rX __await__rWs rCr[zDeferTyping.__await___s}}((***rEc>K|d{VdSrM)rXrWs rC __aenter__zDeferTyping.__aenter__bs,mmoorEexc_typeOptional[Type[BE]]exc Optional[BE] tracebackOptional[TracebackType]c KdSrM)rNr^r`rbs rC __aexit__zDeferTyping.__aexit__es rEN)rHrIrJrK)r>rP)r>rY)r^r_r`rarbrcr>rP)__name__ __module__ __qualname__rOrXr[r]rfrerErCrGrGVs|))))PPPP++++      rErGceZdZdZeedddeddddddd ddZedd#Zdd(Zdd)d*dd.Z e dd/Z dd1Z e dd3Z e dd5Ze dd7Zejjdd9Zejjdd;Zejjdd=Zejjdd?ZejjddAZejjddBZe ddDZddFZedGdGdGdGdGdGdGdGdGdH ddXZedGdGdGdGdGdGdGdGdGdY dd\Ze ddGdGdGdGdGdGdGdGdGdGdGdGdGdGd]ddgZe ddGdGdGdGdGdGdGdGdGdGdGdGdGdGdhddiZe ddGdGdGdGdGdGdGdGdGdGdGdGdGdGdjddmZe ddGdGdGdGdGdGdGdGdGdGdGdGdGdGdnddoZdddpZddqddsZddqddtZedGdGdGdGdGdGdGdGdGdH dduZedGdGdGdGdGdGdGdGdGdY ddvZe ddGdGdGdGdGdGdGdGdGdGdGdGdGdGd]ddwZe ddGdGdGdGdGdGdGdGdGdGdGdGdGdGdhddxZe ddGdGdGdGdGdGdGdGdGdGdGdGdGdGdjddyZe ddGdGdGdGdGdGdGdGdGdGdGdGdGdGdnddzZ dddddddddddddddddd{dfdZxZ S)r8a{ Represents the context in which a command is being invoked under. This class contains a lot of meta data to help you understand more about the invocation context. This class is not created manually and is instead passed around to commands as the first parameter. This class implements the :class:`~discord.abc.Messageable` ABC. Attributes ----------- message: :class:`.Message` The message that triggered the command being executed. .. note:: In the case of an interaction based context, this message is "synthetic" and does not actually exist. Therefore, the ID on it is invalid similar to ephemeral messages. bot: :class:`.Bot` The bot that contains the command being executed. args: :class:`list` The list of transformed arguments that were passed into the command. If this is accessed during the :func:`.on_command_error` event then this list could be incomplete. kwargs: :class:`dict` A dictionary of transformed arguments that were passed into the command. Similar to :attr:`args`\, if this is accessed in the :func:`.on_command_error` event then this dict could be incomplete. current_parameter: Optional[:class:`Parameter`] The parameter that is currently being inspected and converted. This is only of use for within converters. .. versionadded:: 2.0 current_argument: Optional[:class:`str`] The argument string of the :attr:`current_parameter` that is currently being converted. This is only of use for within converters. .. versionadded:: 2.0 interaction: Optional[:class:`~discord.Interaction`] The interaction associated with this context. .. versionadded:: 2.0 prefix: Optional[:class:`str`] The prefix that was used to invoke the command. For interaction based contexts, this is ``/`` for slash commands and ``\u200b`` for context menu commands. command: Optional[:class:`Command`] The command that is being invoked currently. invoked_with: Optional[:class:`str`] The command name that triggered this invocation. Useful for finding out which alias called the command. invoked_parents: List[:class:`str`] The command names of the parents that triggered this invocation. Useful for finding out which aliases called the command. For example in commands ``?a b c test``, the invoked parents are ``['a', 'b', 'c']``. .. versionadded:: 1.7 invoked_subcommand: Optional[:class:`Command`] The subcommand that was invoked. If no valid subcommand was invoked then this is equal to ``None``. subcommand_passed: Optional[:class:`str`] The string that was attempted to call a subcommand. This does not have to point to a valid registered subcommand and could just point to a nonsense string. If nothing was passed to attempt a call to a subcommand then this is set to ``None``. command_failed: :class:`bool` A boolean that indicates if the command failed to be parsed, checked, or invoked. NF) argskwargsprefixcommand invoked_withinvoked_parentsinvoked_subcommandsubcommand_passedcommand_failedcurrent_parametercurrent_argumentrSmessagerbotrviewrrk List[Any]rlDict[str, Any]rm Optional[str]rn Optional[Command[Any, ..., Any]]rorp List[str]rqrrrsrKrtOptional[Parameter]rurSOptional[Interaction[BotT]]c||_||_|pg|_|pi|_||_||_||_||_| pg|_| |_ | |_ | |_ | |_ ||_ ||_|jj|_dSrM)rvrwrkrlrmrnrxrorprqrrrsrtrurS_state)rNrvrwrxrkrlrmrnrorprqrrrsrtrurSs rCrOzContext.__init__s&!( #zr &,l %+ 9@ $ +7*9*?RDV0A$26G/?8C'+|': rEInteraction[BotT]r>rcKddlm}t|j|st d|j}|t d|j}|j}|dd}|j |j ggdddd|dkrtj j ntjj dd gggd }|jt!d |jp t%|j|j|j }t+|j|| } |j| _d|jD| _n|j } |dkrdnd} || |t5d gi| ||j| } | |_|j| _| S)a|coro| Creates a context from a :class:`discord.Interaction`. This only works on application command based interactions, such as slash commands or context menus. On slash command based interactions this creates a synthetic :class:`~discord.Message` that points to an ephemeral message that the command invoker has executed. This means that :attr:`Context.author` returns the member that invoked the command. In a message context menu based interaction, the :attr:`Context.message` attribute is the message that the command is being executed on. This means that :attr:`Context.author` returns the author of the message being targetted. To get the member that invoked the command then :attr:`discord.Interaction.user` should be used instead. .. versionadded:: 2.0 Parameters ----------- interaction: :class:`discord.Interaction` The interaction to create a context with. Raises ------- ValueError The interaction does not have a valid command. TypeError The interaction client is not derived from :class:`Bot` or :class:`AutoShardedBot`. r)BotBasezNInteraction client is not derived from commands.Bot or commands.AutoShardedBotNz&interaction does not have command datatypeF@) id reactionsembedsmention_everyonettspinnededited_timestamprflagscontentmentions mention_roles attachmentsz>interaction channel ID is null, this is probably a Discord bug)stateguild_idr)rchanneldatacBg|]\}}t|t|Sre) isinstancer).0_as rC z,Context.from_interaction.. s-"d"d"dA*UVXbJcJc"d1"d"d"drE/u​) rvrwrxrkrlrmrSrorn)rwrrclient TypeErrorrn ValueErrorrgetrvrrchat_input_commandvaluecontext_menu_command channel_id RuntimeErrorrrrrruserauthor namespacerrname_batonrs) clsrSrrnrwrtype_synthetic_payloadrrvrmrHs rCfrom_interactionzContext.from_interactionsB !     +,g66 nlmm m% ?EFF F&2=2B##   &!n$)$(@E 6<``. .. versionadded:: 2.0 Nrz<@!?%s>z@%s\z\\)rmmerecompilersub display_namereplace)rNrpatterns rC clean_prefixzContext.clean_prefixs^ ; 2w *Z$'122{{54#4#<#) |coro| Shows the help command for the specified entity if given. The entity can be a command or a cog. If no entity is given, then it'll show help for the entire bot. If the entity is a string, then it looks up whether it's a :class:`Cog` or a :class:`Command`. .. note:: Due to the way this function works, instead of returning something similar to :meth:`~.commands.HelpCommand.command_not_found` this returns ``None`` on bad input or no help command. Parameters ------------ entity: Optional[Union[:class:`Command`, :class:`Cog`, :class:`str`]] The entity to show help for. Returns -------- Any The result of the help command, if any. r)r3Group wrap_callback) CommandErrorNr)corer3rrerrorsrrw help_commandcopycontextrprepare_help_commandget_bot_mapping send_bot_helpon_help_command_errorrrget_cog get_commandqualified_nameAttributeErrorrD send_cog_helpsend_group_helpsend_command_help) rNrkr3rrrrwrmappinginjectedeentitys rC send_helpzContext.send_help's< 8777777777((((((h ;4hhjj t99>>**466 6 6 6 6 6 6 6))++G$}S%677H %Xg.........   //a888888888ttttt a fc " " D[[((CCOOF,C,CF >4   ! ! !   44 &&tV-BCCCCCCCCC 5f~~ (=):;;%Xf---------FE** (=)<==%Xf---------FG,, (=)>??%Xf---------t 5 5 5++D!44 4 4 4 4 4 4 4 4 4 4 4 4 4 5sNB%%C*C  C D(( D65D6/G/ 0G/<0G//H4HH.) file delete_afternonceallowed_mentions referencemention_authorsuppress_embedsrJsilentrr'rfloatrUnion[str, int]rr(r0Union[Message, MessageReference, PartialMessage]rr/rrJrc  KdSrMre rNrrrrrrrxrrJrs rCreplyz Context.replyy #rE) filesrrrrrrrJrr$Sequence[File]c  KdSrMre rNr$rrrrrrxrrJrs rCr"z Context.replyr#rE)rembedrstickersrrrrrrxrrJrpollrrr(r&r)*Sequence[Union[GuildSticker, StickerItem]]r.r*r1c KdSrMrerNrrr(rr)rrrrrrxrrJrr*s rCr"z Context.reply &#rE)rr(r$r)rrrrrrxrrJrr*c KdSrMrerNrrr(r$r)rrrrrrxrrJrr*s rCr"z Context.replyr.rE)rrrr)rrrrrrxrrJrr*rSequence[Embed]c KdSrMrerNrrrrr)rrrrrrxrrJrr*s rCr"z Context.replyr.rE)rrr$r)rrrrrrxrrJrr*c KdSrMrerNrrrr$r)rrrrrrxrrJrr*s rCr"z Context.replyr.rEcrK|j|j|fd|ji|d{VS|j|fi|d{VS)a_|coro| A shortcut method to :meth:`send` to reply to the :class:`~discord.Message` referenced by this context. For interaction based contexts, this is the same as :meth:`send`. .. versionadded:: 1.6 .. versionchanged:: 2.0 This function will now raise :exc:`TypeError` or :exc:`ValueError` instead of ``InvalidArgument``. Raises -------- ~discord.HTTPException Sending the message failed. ~discord.Forbidden You do not have the proper permissions to send the message. ValueError The ``files`` list is not of the appropriate size TypeError You specified both ``file`` and ``files``. Returns --------- :class:`~discord.Message` The message that was sent. Nr)rSsendrv)rNrrls rCr"z Context.replysp<   #"7MMdlMfMMMMMMMM M"755f55555555 5rErR Union[Typing, DeferTyping[BotT]]cP|jt|St||S)aReturns an asynchronous context manager that allows you to send a typing indicator to the destination for an indefinite period of time, or 10 seconds if the context manager is called using ``await``. In an interaction based context, this is equivalent to a :meth:`defer` call and does not do any typing calls. Example Usage: :: async with channel.typing(): # simulate something heavy await asyncio.sleep(20) await channel.send('Done!') Example Usage: :: await channel.typing() # Do some computational magic for about 10 seconds await channel.send('Done!') .. versionchanged:: 2.0 This no longer works with the ``with`` syntax, ``async with`` must be used instead. .. versionchanged:: 2.0 Added functionality to ``await`` the context manager to send a typing indicator for 10 seconds. Parameters ----------- ephemeral: :class:`bool` Indicates whether the deferred message will eventually be ephemeral. Only valid for interaction based contexts. .. versionadded:: 2.0 NrR)rSrrGrNrJs rCtypingzContext.typings-H   #$<< 495555rEchK|jr(|jj|d{VdSdS)a_|coro| Defers the interaction based contexts. This is typically used when the interaction is acknowledged and a secondary action will be done later. If this isn't an interaction based context then it does nothing. Parameters ----------- ephemeral: :class:`bool` Indicates whether the deferred message will eventually be ephemeral. Raises ------- HTTPException Deferring the interaction failed. InteractionResponded This interaction has already been responded to before. rRN)rSrTrVr:s rCrVz Context.defer8sU.   G"+11I1FF F F F F F F F F F G GrEc  KdSrMrer!s rCr7z Context.sendRr#rEc  KdSrMrer's rCr7z Context.sendbr#rEc KdSrMrer-s rCr7z Context.sendrr.rEc KdSrMrer0s rCr7z Context.sendr.rEc KdSrMrer3s rCr7z Context.sendr.rEc KdSrMrer5s rCr7z Context.sendr.rE)rr(rrr$r)rrrrrrxrrJrr*Optional[Embed]Optional[Sequence[Embed]]Optional[File]Optional[Sequence[File]]4Optional[Sequence[Union[GuildSticker, StickerItem]]]Optional[float]Optional[Union[str, int]]Optional[AllowedMentions]:Optional[Union[Message, MessageReference, PartialMessage]]Optional[bool]Optional[BaseView]Optional[Poll]cK|j|jr7t||||||||| | | | | |||d{VS|||tn||tn||tn||tn|| tn| | tn| ||||tn|d }|jjr"|jjjdi|ddid{V}nc|jjjdi|d{V}t|j tj s |j d{V}n|j }|||d{V|S)a|coro| Sends a message to the destination with the content given. This works similarly to :meth:`~discord.abc.Messageable.send` for non-interaction contexts. For interaction based contexts this does one of the following: - :meth:`discord.InteractionResponse.send_message` if no response has been given. - A followup message if a response has been given. - Regular send if the interaction has expired .. versionchanged:: 2.0 This function will now raise :exc:`TypeError` or :exc:`ValueError` instead of ``InvalidArgument``. Parameters ------------ content: Optional[:class:`str`] The content of the message to send. tts: :class:`bool` Indicates if the message should be sent using text-to-speech. embed: :class:`~discord.Embed` The rich embed for the content. file: :class:`~discord.File` The file to upload. files: List[:class:`~discord.File`] A list of files to upload. Must be a maximum of 10. nonce: :class:`int` The nonce to use for sending this message. If the message was successfully sent, then the message will have a nonce with this value. delete_after: :class:`float` If provided, the number of seconds to wait in the background before deleting the message we just sent. If the deletion fails, then it is silently ignored. allowed_mentions: :class:`~discord.AllowedMentions` Controls the mentions being processed in this message. If this is passed, then the object is merged with :attr:`~discord.Client.allowed_mentions`. The merging behaviour only overrides attributes that have been explicitly passed to the object, otherwise it uses the attributes set in :attr:`~discord.Client.allowed_mentions`. If no object is passed at all then the defaults given by :attr:`~discord.Client.allowed_mentions` are used instead. .. versionadded:: 1.4 reference: Union[:class:`~discord.Message`, :class:`~discord.MessageReference`, :class:`~discord.PartialMessage`] A reference to the :class:`~discord.Message` to which you are replying, this can be created using :meth:`~discord.Message.to_reference` or passed directly as a :class:`~discord.Message`. You can control whether this mentions the author of the referenced message using the :attr:`~discord.AllowedMentions.replied_user` attribute of ``allowed_mentions`` or by setting ``mention_author``. This is ignored for interaction based contexts. .. versionadded:: 1.6 mention_author: Optional[:class:`bool`] If set, overrides the :attr:`~discord.AllowedMentions.replied_user` attribute of ``allowed_mentions``. This is ignored for interaction based contexts. .. versionadded:: 1.6 view: Union[:class:`discord.ui.View`, :class:`discord.ui.LayoutView`] A Discord UI View to add to the message. .. versionadded:: 2.0 embeds: List[:class:`~discord.Embed`] A list of embeds to upload. Must be a maximum of 10. .. versionadded:: 2.0 stickers: Sequence[Union[:class:`~discord.GuildSticker`, :class:`~discord.StickerItem`]] A list of stickers to upload. Must be a maximum of 3. This is ignored for interaction based contexts. .. versionadded:: 2.0 suppress_embeds: :class:`bool` Whether to suppress embeds for the message. This sends the message without any embeds if set to ``True``. .. versionadded:: 2.0 ephemeral: :class:`bool` Indicates if the message should only be visible to the user who started the interaction. If a view is sent with an ephemeral message and it has no timeout set then the timeout is set to 15 minutes. **This is only applicable in contexts with an interaction**. .. versionadded:: 2.0 silent: :class:`bool` Whether to suppress push and desktop notifications for the message. This will increment the mention counter in the UI, but will not actually send a notification. .. versionadded:: 2.2 poll: Optional[:class:`~discord.Poll`] The poll to send with this message. .. versionadded:: 2.4 .. versionchanged:: 2.6 This can now be ``None`` and defaults to ``None`` instead of ``MISSING``. Raises -------- ~discord.HTTPException Sending the message failed. ~discord.Forbidden You do not have the proper permissions to send the message. ValueError The ``files`` list is not of the appropriate size. TypeError You specified both ``file`` and ``files``, or you specified both ``embed`` and ``embeds``, or the ``reference`` object is not a :class:`~discord.Message`, :class:`~discord.MessageReference` or :class:`~discord.PartialMessage`. Returns --------- :class:`~discord.Message` The message that was sent. N)rrr(rrr$r)rrrrrrxrrr*) rrr(rrr$rrxrrJrr*waitT)delayre)rS is_expiredsuperr7r9rTrUfollowup send_messagerresourcerInteractionMessageoriginal_responsedelete)rNrrr(rrr$r)rrrrrrxrrJrr*rlmsgrT __class__s rCr7z Context.sendsP   #t'7'B'B'D'D #!)!1#- /!& * % WW5!'ggV#|GG % WW5+;+CIY#|GG."#|GG      $ , , . . (6(16KKKKdKKKKKKKKKCCCT-6CMMfMMMMMMMMHh/1KLL ( ,>>@@@@@@@@'  #**<*00 0 0 0 0 0 0 0 rE)rvrrwrrxrrkryrlrzrmr{rnr|ror{rpr}rqr|rrr{rsrKrtr~rur{rSr)rSrr>r)rnrrkrrlrr>r:)rrKrrKr>rP)r>rK)r>r)r>r)r>r)r>r)r>r)r>r )r>r)r>r)r>r)r>r)rkrr>r)rr'rrrrrr(rrrrKrxr/rrKrJrKrrKr>r)r$r%rrrrrr(rrrrKrxr/rrKrJrKrrKr>r).) rr{rrKr(r&rr'r)r+rrrrrr(rrrrKrxr.rrKrJrKrrKr*r1r>r) rr{rrKr(r&r$r%r)r+rrrrrr(rrrrKrxr.rrKrJrKrrKr*r1r>r) rr{rrKrr1rr'r)r+rrrrrr(rrrrKrxr.rrKrJrKrrKr*r1r>r) rr{rrKrr1r$r%r)r+rrrrrr(rrrrKrxr.rrKrJrKrrKr*r1r>rrM)rr{rlrr>r)rJrKr>r8)rJrKr>rP)$rr{rrKr(rCrrDrrEr$rFr)rGrrHrrIrrJrrKrrLrxrMrrKrJrKrrKr*rNr>r)!rgrhri__doc__r9rO classmethodrrrpropertyrrrrrrrcached_propertyrrrrrrrrrr"r;rVr7 __classcell__)r[s@rCr8r8nsEEZ"!( $48&*%,?C+/$15*.37#";";";";";";HWWW[Wr#4#4#4#4J49$<7<7<7<7<7<7|DDDXDXXXXX    X tttXt ]""""#"" ]"$$$#"$  ]"####"#  ]"JJJ#"J ]"#"2 ]")))#")V---X- P5P5P5P5d!!$,/FI" #     X !$!!$,/FI" #     X "%?B!!$,/FI" ##X("% #?B!!$,/FI" ##X("%"%?B!!$,/FI" ##X("%"% #?B!!$,/FI" ##X(!6!6!6!6!6F+0&6&6&6&6&6&6P05GGGGGG4!!$,/FI" #     X !$!!$,/FI" #     X "%?B!!$,/FI" ##X("% #?B!!$,/FI" ##X("%"%?B!!$,/FI" ##X("%"% #?B!!$,/FI" ##X,"&w!%,0#*.IM(,+/6:PT)-#' %#'wwwwwwwwwwwwrEr8)r=rr>r?)\r\ __future__rrr;rrrrrr r r r r rr discord.abcr discord.utilsrrrrrrrrrdiscord.context_managersrrxr_typesrtyping_extensionsrrrr discord.guildr!discord.memberr" discord.stater# discord.userr$discord.voice_clientr%discord.embedsr& discord.filer'discord.mentionsr(discord.stickerr)r*discord.messager+r,discord.ui.viewr-r.r/discord.types.interactionsr0 discord.pollr1rr2rr3 parametersr4typesr5 BaseExceptionr6__all__rr9__annotations__r:r;r<rDrGabc Messageabler8rerErCr{s0#""""" yyyyyyyyyyyyyyyyyyyyyyyyyyyy}}}}}}}}}}}}}}}}}}}}}}++++++,<<<<<<<<<<......######%%%%%%------''''''222222$$$$$$!!!!!!00000099999999@@@@@@@@::::::::::LLLLLL!!!!!!%%%%%%###### ] + + +B  }$$$$$ GCLLwvU### #AA A,,,,     '$-   0OOOOOgk%wt}OOOOOrE