i% 0UdZddlmZddlZddlZddlZddlmZddl m Z m Z m Z m Z mZmZmZmZmZmZmZmZddlmZddlZddlZddlmZdd lmZmZmZm Z dd l!m"Z"dd l#m$Z$m%Z%m&Z&m'Z'dd l(m)Z)m*Z*dd l+m,Z,ddl-m.Z.ddl/m0Z0ddl1m2Z2m3Z3m4Z4m5Z5m6Z6ddl7m8Z8ddl9m:Z:m;Z;mm?Z?dZ@ejAeBZCerddlDmEZEddlFmGZGddlHmIZIddlJmKZKddlLmMZMddl!mNZNddlOmPZPddl1mQZQddlRmSZSddlTmUZUddl9mVZVdd lWmXZXdd!lYmZZZm[Z[m\Z\dd"l]m^Z^ddl_Z_dd#l`maZbmcZddd lem"Zfdd$lgm*ZhmiZjdd%lkmlZmddlnm0Zodd&lpmqZqdd'lrmsZted(eu)ZveePd*fZwejxZxd+eyd,<Gd-d.ZzGd/d0Z{dcddd7Z|exd8exexexexexexexexdexd9 dedQZ}edRe{SZ~dTeydU<GdVdWe8ZGdXdYe8ZGdZd[ZGd\d*ZGd]d^e"ZGd_d`e8ZGdadbeZadS)fa: 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)quote) AnyDictListLiteralOptional TYPE_CHECKINGSequenceTupleUnionTypeVarTypeoverload) ContextVar)utils) HTTPException ForbiddenNotFoundDiscordServerError)Message)try_enum WebhookType ChannelType DefaultAvatar)BaseUserUser) MessageFlags)Asset) PartialEmoji)Routehandle_message_parametersMultipartParameters HTTPClient json_or_text)Hashable) TextChannel ForumChannelPartialMessageableForumTag)File)WebhookWebhookMessagePartialWebhookChannelPartialWebhookGuild)Self) TracebackType)Embed)Client)AllowedMentions) Attachment)ConnectionState)Response)Guild)Emoji) VoiceChannel) Snowflake)BaseViewView LayoutView)Poll)r- SourceGuild)r PartialUser)PartialChannel) SnowflakeList)InteractionCallbackBE)bound _WebhookStaterMISSINGc.eZdZddZddZdd ZddZdS)AsyncDeferredLocklock asyncio.Lockc"||_d|_dSN)rLdelta)selfrLs W/usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages/discord/webhook/async_.py__init__zAsyncDeferredLock.__init__hs &* returnr1cHK|jd{V|SrO)rLacquirerQs rR __aenter__zAsyncDeferredLock.__aenter__ls1i!!!!!!!!! rTrPfloatNonec||_dSrO)rP)rQrPs rRdelay_byzAsyncDeferredLock.delay_byps  rTexc_typeOptional[Type[BE]]exc Optional[BE] tracebackOptional[TracebackType]cK|jrtj|jd{V|jdSrO)rPasynciosleeprLrelease)rQr^r`rbs rR __aexit__zAsyncDeferredLock.__aexit__ssP : ,- ++ + + + + + + + rTN)rLrMrUr1)rPrZrUr[)r^r_r`rarbrcrUr[)__name__ __module__ __qualname__rSrYr]rhrTrRrKrKgsd++++rTrKc :eZdZdZddddddddddAdZddddddBdZdddddCd ZdddddDd#ZdddddDd$Zddddddd%d%d&dEd-Z dddd.dFd1Z ddddddd%d2dGd3Z dddd.dHd4Z ddd5dId6Z ddd5dId7Zddd5dJd;Zddd5dKd=Zdddddd>dLd?Zddd5dMd@ZdS)NAsyncWebhookAdapterc6tj|_dSrO)weakrefWeakValueDictionary_locksrXs rRrSzAsyncWebhookAdapter.__init__sFMFaFcFc rTN)payload multipartproxy proxy_authfilesreason auth_tokenparamsrouter"sessionaiohttp.ClientSessionrtOptional[Dict[str, Any]]ruOptional[List[Dict[str, Any]]]rv Optional[str]rwOptional[aiohttp.BasicAuth]rxOptional[Sequence[File]]ryrzr{rUrc Ki} |pg}d} |j|jf} |j| }n-#t$r t jx|j| <}YnwxYw|d| d<t j|} | d| | d<|t|d| d<d}d}|j }|j }|j}t|4d{V}tdD]}|D]}| | |r)tjd }|D]}|jdi||} |||| | | || 4d{V }t$d ||||jt+|d{V}|jd}|dkrP|jdkrEt j|}t$d||||d|jcxkrdkr+nn(|cdddd{Vccdddd{VS|jdkr~|jdst5||d}|d}t$|||t j|d{V dddd{V|jdkr4t jd|dzzd{V dddd{V|jdkrt;|||jdkrt=||t5||#1d{VswxYwYt#t>$r;}|dkr/|j dvr&t jd|dzzd{VYd}~d}~wwxYw|r+|jdkrtC||t5||tEd#1d{VswxYwYdS) Nzapplication/jsonz Content-TypezBot Authorizationz/ )safezX-Audit-Log-Reason)seekF) quote_fields)dataheadersr{rvrwz4Webhook ID %s with %s %s has returned status code %szX-Ratelimit-Remaining0iz>Webhook ID %s has exhausted its rate limit bucket (retry: %s).i,Viaz8Webhook ID %s is rate limited. Retrying in %.2f seconds. retry_afteririi)6iF'z"Unreachable code in HTTP handling.rm)# webhook_id webhook_tokenrsKeyErrorreLockr_to_jsonurlquotemethodurlrKrangeresetaiohttpFormData add_fieldrequest_logdebugstatusr&rget_parse_ratelimit_headerr]rwarningrfrrOSErrorerrnor RuntimeError)rQr|r}rtrurvrwrxryrzr{rto_sendbucketrLresponserrrrattemptfile form_datap remainingrPfmtres rRrzAsyncWebhookAdapter.requests#% :>"E$78 8;v&DD 8 8 8)0 7DK $$$ 8  &8GN #nW--G  !':j':':GO $  ,4V$,G,G,GG( )5959i% $T**E EE EE EE EE EE EE Ed 88= = !--DJJGJ,,,,( ' 0e D D DI&11+ +00a0000'G3&'76Y^ku /  ,@,@,@,@,@,@,@,@! R&"$O &2(%;%;;;;;;;$,$4$8$89P$Q$Q $++30F0F$)$A($K$KE JJ ` * % !MM%0007777C77777#'/,@,@,@,@,@,@,@,@,@,@,@,@,@,@,@E EE EE EE EE EE EE EE EE EE EE EE EE EE EJ$?c11#+#3#7#7#>#>D&3Hd&C&C C"\C15m1DK LLj+FFF")- "<"<<<<<<<<$C,@,@,@,@,@,@,@,@,@,@,@,@,@F$?c11")-GaK"@"@@@@@@@@$K,@,@,@,@,@,@,@,@,@,@,@,@,@N$?c11"+Hd";";;%_33"*8T":"::"/$"?"??Y,@,@,@,@,@,@,@,@,@,@,@,@,@,@,@\{{qw+'='=%mA! O<<<<<<<<<    4?c)),Xt<<<#Hd333CDD DKE EE EE EE EE EE EE EE EE EE EE EE EE EE EE EE Es ('AA>AO"M;B?L/:M O!A6L/M(O*,L/M'O)AL// L9 9M<L9 =MO N /N;ONN?O OO)tokenrvrwryrintrResponse[None]c\tdd|}|||||||S)NDELETE/webhooks/{webhook_id}r)r}rvrwryrzr"rrQrrr}rvrwryr|s rRdelete_webhookz"AsyncWebhookAdapter.delete_webhooks9h 8ZPPP||E7%J_erw|xxxrT)rvrwrystrc\tdd||}||||||S)Nr&/webhooks/{webhook_id}/{webhook_token}rrr}rvrwryrrs rRdelete_webhook_with_tokenz-AsyncWebhookAdapter.delete_webhook_with_tokens:h HU_otuuu||E7%J_e|fffrTDict[str, Any]Response[WebhookPayload]c ^tdd|}||||||||S)NPATCHrr)r}rvrwryrtrzr rQrrrtr}rvrwryr|s rR edit_webhookz AsyncWebhookAdapter.edit_webhook sIg7JOOO|| !   rTc^tdd||}|||||||S)Nrrr)r}rvrwryrtrrs rRedit_webhook_with_tokenz+AsyncWebhookAdapter.edit_webhook_with_token!s=gGT^nsttt||E7%J_eov|wwwrTF)rvrwrtrurx thread_idwaitwith_componentsr Optional[int]rboolr"Response[Optional[MessagePayload]]c t| t| d} | r| | d<tdd||} || ||||||| S)N)rrrPOSTrrr}rvrwrtrurxr{)rr"r)rQrrr}rvrwrtrurxrrrr{r|s rRexecute_webhookz#AsyncWebhookAdapter.execute_webhook/s}d))O8L8LMM  ,"+F; fFS]mrsss|| !   rT)rvrwr message_idResponse[MessagePayload]cntdd|||}|dnd|i} |||||| S)NGETz7interaction_message_response_params..Es 666!!))++666rTrr componentsT) components_v2rrc<g|]}t|t|Srm) isinstancer,)ras rRrz7interaction_message_response_params..ns'???q:a+>+>????rTrrrr)rr payload_json)namevaluezfiles[]zapplication/octet-stream)rrfilename content_typer)rI TypeErrorlen ValueErrorrr to_componentshas_components_v2rrrmergerr,append_to_dictrr enumeratefprr$)rrrrrrxrrrrrrrr file_indexattachments_payload attachmentruindexs rR#interaction_message_response_paramsr-#s  GG 3 3FGGG Wg!5!5HIII 7'!!e7&:&:MNNN s&DW v;;  CDD D66v666X G =DNN#mmoo.DNg  !'llDOO"DO 7  !%!3!3!5!5D %%'' =''*.E''(t<<$;O;OPPQQQ$U++  KE4   -U---!W $ $>      d++ ty N N NNrTasync_webhook_context)defaultzContextVar[AsyncWebhookAdapter] async_contextc>eZdZdZdZd dZd d Zed d Zd S)r/aRepresents a partial channel for webhooks. These are typically given for channel follower webhooks. .. versionadded:: 2.0 Attributes ----------- id: :class:`int` The partial channel's ID. name: :class:`str` The partial channel's name. )idrrPartialChannelPayloadrUr[cTt|d|_|d|_dS)Nr2r)rr2rrQrs rRrSzPartialWebhookChannel.__init__s"4:f rTrc(d|jd|jdS)Nzrr2rXs rR__repr__zPartialWebhookChannel.__repr__sIdiIItwIIIIrTcd|jdS)z^:class:`str`: The string that allows you to mention the channel that the webhook is following.z<#r8r2rXs rRmentionzPartialWebhookChannel.mentionsDGrTN)rr3rUr[rUr) rjrkrl__doc__ __slots__rSr:propertyr=rmrTrRr/r/sq  I&&&&JJJJXrTr/c>eZdZdZdZdd Zdd Zedd ZdS)r0aRepresents a partial guild for webhooks. These are typically given for channel follower webhooks. .. versionadded:: 2.0 Attributes ----------- id: :class:`int` The partial guild's ID. name: :class:`str` The partial guild's name. )r2r_icon_staterSourceGuildPayloadstate_StaterUr[c|||_t|d|_|d|_|d|_dS)Nr2ricon)rDrr2rrC)rQrrFs rRrSzPartialWebhookGuild.__init__s4# 4:f v, rTrc(d|jd|jdS)NzrUrK) rjrkrlr?r@rSr:rArIrmrTrRr0r0sw  2I'''' HHHHHHHXHHHrTr0ceZdZdZddZdS) !_FriendlyHttpAttributeErrorHelperrmattrrrUrc td)Nz2PartialWebhookState does not support http methods.)AttributeErrorrQrQs rR __getattr__z-_FriendlyHttpAttributeErrorHelper.__getattr__sQRRRrTNrQrrUr)rjrkrlr@rUrmrTrRrPrPs3ISSSSSSrTrPc|eZdZdZefd"dZd#d Zddd$dZd%dZe d&dZ d'dZ e d(dZ d)d Z d!S)*rH)_parent_webhook_threadwebhookrparentOptional[_State]threadr<cn||_|t|trd|_n||_||_dSrO)rYrrHrXrZ)rQr[r\r^s rRrSz_WebhookState.__init__s<$  / fm , , "DLL!DL"( rTguild_idrrUOptional[Guild]cH|j|j|SdSrO)rX _get_guild)rQr`s rRrcz_WebhookState._get_guilds% < #<**844 4trTTcacher&Union[UserPayload, PartialUserPayload]rerrcj|j|j||St||S)NrdrFr)rX store_userr)rQrres rRriz_WebhookState.store_users8 < #<**4u*== =d....rTc$t||S)Nrh)rr5s rR create_userz_WebhookState.create_usersd....rTr cdSrOrmrXs rRrz_WebhookState.allowed_mentionsstrTPartialEmojiPayloadUnion[PartialEmoji, Emoji, str]c|j|j|Stj|d}|s|dSt |dd||dS)Nr2ranimatedF)rpr2r)rXget_emoji_from_partial_payloadr_get_as_snowflaker!r)rQremoji_ids rRget_reaction_emojiz _WebhookState.get_reaction_emojisn < #<>>tDD D*466 < TXXj%%@%@XTXY_T`aaaarT4Union[HTTPClient, _FriendlyHttpAttributeErrorHelper]cD|j |jjStSrO)rXhttprPrXs rRrwz_WebhookState.http s# < #<$ $1222rTrQrc`|jt|j|Std|d)Nz%PartialWebhookState does not support .)rXgetattrrSrTs rRrUz_WebhookState.__getattr__s6 < #4<.. .NTNNNOOOrTN)r[rr\r]r^r<)r`rrUra)rrfrerrUr)rrfrUr)rUr )rrmrUrn)rUrurV)rjrkrlr@rIrSrcrirkrArrtrwrUrmrTrRrHrHs2ISZ ) ) ) ) ) Y]////// ////X b b b b333X3PPPPPPrTcTeZdZUdZded<eeeeeddddZddZd dZddd!dZ dS)"r.aRepresents a message sent from your webhook. This allows you to edit or delete a message sent by your webhook. This inherits from :class:`discord.Message` with changes to :meth:`edit` and :meth:`delete` to work. .. versionadded:: 1.6 rHrDN)rrrrrrrrrr rr rr rr rr rUc ~K|jj|j|||||||jjd{VS)a |coro| Edits the message. .. versionadded:: 1.6 .. versionchanged:: 2.0 The edit is no longer in-place, instead the newly edited message is returned. .. versionchanged:: 2.0 This function will now raise :exc:`ValueError` instead of ``InvalidArgument``. Parameters ------------ content: Optional[:class:`str`] The content to edit the message with or ``None`` to clear it. embeds: List[:class:`Embed`] A list of embeds to edit the message with. embed: Optional[:class:`Embed`] The embed to edit the message with. ``None`` suppresses the embeds. This should not be mixed with the ``embeds`` parameter. attachments: List[Union[:class:`Attachment`, :class:`File`]] A list of attachments to keep in the message as well as new files to upload. If ``[]`` is passed then all attachments are removed. .. note:: New files will always appear after current attachments. .. versionadded:: 2.0 allowed_mentions: :class:`AllowedMentions` Controls the mentions being processed in this message. See :meth:`.abc.Messageable.send` for more information. view: Optional[:class:`~discord.ui.View`] The updated view to update this message with. If ``None`` is passed then the view is removed. If the webhook is partial or is not managed by the library, then you can not send interactable components. Otherwise, you can send views with any type of components. .. note:: To update the message to add a :class:`~discord.ui.LayoutView`, you must explicitly set the ``content``, ``embed``, ``embeds``, and ``attachments`` parameters to either ``None`` or an empty array, as appropriate. .. versionadded:: 2.0 Raises ------- HTTPException Editing the message failed. Forbidden Edited a message that is not yours. TypeError You specified both ``embed`` and ``embeds`` ValueError The length of ``embeds`` was invalid or there was no token associated with this webhook. Returns -------- :class:`WebhookMessage` The newly edited message. rrrrrrr^N)rDrY edit_messager2rZ)rQrrrrrrs rReditzWebhookMessage.edit(shV[)66 G#-;&7         rTrxr,cPK|g|j|d{VS)a|coro| Adds new files to the end of the message attachments. .. versionadded:: 2.0 Parameters ----------- \*files: :class:`File` New files to add to the message. Raises ------- HTTPException Editing the message failed. Forbidden Tried to edit a message that isn't yours. Returns -------- :class:`WebhookMessage` The newly edited message. rNrr)rQrxs rR add_fileszWebhookMessage.add_files~s<0YY+FT-=+F+FYGGGGGGGGGrTr6cbK|fd|jDd{VS)a|coro| Removes attachments from the message. .. versionadded:: 2.0 Parameters ----------- \*attachments: :class:`Attachment` Attachments to remove from the message. Raises ------- HTTPException Editing the message failed. Forbidden Tried to edit a message that isn't yours. Returns -------- :class:`WebhookMessage` The newly edited message. cg|]}|v| Srmrm)rrrs rRrz5WebhookMessage.remove_attachments..s$+`+`+`!1T_K_K_AK_K_K_rTrNr)rQrs `rRremove_attachmentsz!WebhookMessage.remove_attachmentssG0YY+`+`+`+`t7G+`+`+`YaaaaaaaaarT)delayrOptional[float]r[cK|&|fdfd }tj|dSjjjjjd{VdS)a|coro| Deletes the message. Parameters ----------- delay: Optional[:class:`float`] If provided, the number of seconds to wait before deleting the message. The waiting is done in the background and deletion failures are ignored. Raises ------ Forbidden You do not have proper permissions to delete the message. NotFound The message was deleted already. HTTPException Deleting the message failed. NrrZcKtj|d{V jjjjjd{VdS#t$rYdSwxYw)Nr^)rerfrDrYdelete_messager2rZr)rrQs rR inner_callz)WebhookMessage.delete..inner_callsmE*********+.==dgdkNa=bbbbbbbbbbb$DDs6A A%$A%r)rrZ)re create_taskrDrYrr2rZ)rQrrs` rRdeletezWebhookMessage.deletes*  05          - - - - -+&55dgdkFY5ZZ Z Z Z Z Z Z Z Z ZrT)rrrr rr rr rr rr rUr.)rxr,rUr.)rr6rUr.)rrrUr[) rjrkrlr?__annotations__rIrrrrrmrTrRr.r.s   ")")!(9@#*6:T T T T T T lHHHH4bbbb48< [ [ [ [ [ [ [ [rTr.ceZdZUdZded< ddd ZddZd dZd dZe d!dZ e d"dZ e d#dZ e d$dZ e d%dZe d%dZdS)& BaseWebhook) r2rr` channel_idrrzuserr_avatarsource_channel source_guildrDTuple[str, ...]r@NrWebhookPayloadrrrFr]rUr[cn||_|pt|||_||dS)N)r\)rzrHrD_update)rQrrrFs rRrSzBaseWebhook.__init__s< */#H}T%'H'H'H  TrTct|d|_ttt|d|_t j|d|_t j|d|_| d|_ | d|_ | d|_ | d}d|_ |t|j| |_ | d }|rt!| }||_| d }|rt%||j }||_dS)Nr2rrr`ravatarrrrhr)rr)rrF)rr2rrrrrrrr`rrrrrrrDr/rr0r)rQrrrrs rRrzBaseWebhook._updates44:!)+s4<7H7H!I!I ).)@|)T)T','>tZ'P'P #'88F#3#3 &*hhx&8&8 $(HHW$5$5 xx59  4;T:::DI"233  H2GGGN?Mxx//  U.L TTTL;GrTrc|jduS)zY:class:`bool`: Whether the webhook is a "partial" webhook. .. versionadded:: 2.0N)rrXs rR is_partialzBaseWebhook.is_partial s$&&rTc|jduS)zm:class:`bool`: Whether the webhook is authenticated with a bot token. .. versionadded:: 2.0 N)rzrXs rRis_authenticatedzBaseWebhook.is_authenticateds d**rTracN|jo|j|jS)zOptional[:class:`Guild`]: The guild this webhook belongs to. If this is a partial webhook, then this will always return ``None``. )rDrcr`rXs rRguildzBaseWebhook.guilds# {Dt{55dmDDDrT8Optional[Union[ForumChannel, VoiceChannel, TextChannel]]cH|j}|o||jS)zOptional[Union[:class:`ForumChannel`, :class:`VoiceChannel`, :class:`TextChannel`]]: The channel this webhook belongs to. If this is a partial webhook, then this will always return ``None``. )r get_channelr)rQrs rRchannelzBaseWebhook.channels&  ;**4?;;;rTdatetime.datetimec4tj|jS)zG:class:`datetime.datetime`: Returns the webhook's creation time in UTC.)rsnowflake_timer2rXs rR created_atzBaseWebhook.created_at(s#DG,,,rTrKc^|j%tj|j|j|jSdS)a Optional[:class:`Asset`]: Returns an :class:`Asset` for the avatar the webhook has. If the webhook does not have a traditional avatar, ``None`` is returned. If you want the avatar that a webhook has displayed, consider :attr:`display_avatar`. N)rr _from_avatarrDr2rXs rRrzBaseWebhook.avatar-s, < #%dk47DLII ItrTr cptj|j|jdz t t zS)z\ :class:`Asset`: Returns the default avatar. .. versionadded:: 2.0 )r _from_default_avatarrDr2r rrXs rRdefault_avatarzBaseWebhook.default_avatar8s,)$+2 ]I[I[7[\\\rTc|jp|jS)z:class:`Asset`: Returns the webhook's display avatar. This is either webhook's default avatar or uploaded avatar. .. versionadded:: 2.0 )rrrXs rRdisplay_avatarzBaseWebhook.display_avatarAs{1d11rT)NN)rrrrrFr]rUr[)rrrUr[)rUr)rUra)rUr)rUrrN)rUr )rjrkrlr@rrSrrrrArrrrrrrmrTrRrrsZ "I    $ $"& HHHH6'''' ++++EEEXE<<<X<---X-X]]]X]222X222rTrceZdZUdZdZded< dpdqfd ZdrdZedrdZ e e e dddsdZ e e e dddtd Z e dud!Ze dvd#Zd$d%dwd(Zdd$d)dxd+Zde e dd$d,dyd2Zdzd5Zee e e e e e e e e e e d6 d{dKZee e e e e e dLe e e e e dM d|dOZee fe e e e e e e e e e e e e e e e dPd}dZZee fe e e e e e e e e e e e dLe e e e d[d~d\Ze fe e d]d]e e e e e e e e d]d]d]e e d[dd`Ze daddbZedLdLdLdcddhZedLdLdLdLdLdLdLdiddlZe e e e e de diddnZe daddoZxZS)r-a] Represents an asynchronous Discord webhook. Webhooks are a form to send messages to channels in Discord without a bot user or authentication. There are two main ways to use Webhooks. The first is through the ones received by the library such as :meth:`.Guild.webhooks`, :meth:`.TextChannel.webhooks`, :meth:`.VoiceChannel.webhooks` and :meth:`.ForumChannel.webhooks`. The ones received by the library will automatically be bound using the library's internal HTTP session. The second form involves creating a webhook object manually using the :meth:`~.Webhook.from_url` or :meth:`~.Webhook.partial` classmethods. For example, creating a webhook from a URL and using :doc:`aiohttp `: .. code-block:: python3 from discord import Webhook import aiohttp async def foo(): async with aiohttp.ClientSession() as session: webhook = Webhook.from_url('url-here', session=session) await webhook.send('Hello World', username='Foo') For a synchronous counterpart, see :class:`SyncWebhook`. .. container:: operations .. describe:: x == y Checks if two webhooks are equal. .. describe:: x != y Checks if two webhooks are not equal. .. describe:: hash(x) Returns the webhooks's hash. .. versionchanged:: 1.4 Webhooks are now comparable and hashable. Attributes ------------ id: :class:`int` The webhook's ID type: :class:`WebhookType` The type of the webhook. .. versionadded:: 1.3 token: Optional[:class:`str`] The authentication token of the webhook. If this is ``None`` then the webhook cannot be used to make requests. guild_id: Optional[:class:`int`] The guild ID this webhook is for. channel_id: Optional[:class:`int`] The channel ID this webhook is for. user: Optional[:class:`abc.User`] The user this webhook was created by. If the webhook was received without authentication then this will be ``None``. name: Optional[:class:`str`] The default name of the webhook. source_guild: Optional[:class:`PartialWebhookGuild`] The guild of the channel that this webhook is following. Only given if :attr:`type` is :attr:`WebhookType.channel_follower`. .. versionadded:: 2.0 source_channel: Optional[:class:`PartialWebhookChannel`] The channel that this webhook is following. Only given if :attr:`type` is :attr:`WebhookType.channel_follower`. .. versionadded:: 2.0 rrr@Nrrr}r~rrrFr]rvrwrrUr[cxt|||||_||_||_dSrO)superrSr}rvrw)rQrr}rrFrvrw __class__s rRrSzWebhook.__init__s: ue,,,.5 $) 7ArTrc8d|jd|jd|jdS)Nz > >s4 ????rTrctjd|}|tdd}|tur|j}|tur |jj}|turtd|}d|d<|||||S)aHCreates a partial :class:`Webhook` from a webhook URL. .. versionchanged:: 2.0 This function will now raise :exc:`ValueError` instead of ``InvalidArgument``. Parameters ------------ url: :class:`str` The URL of the webhook. session: :class:`aiohttp.ClientSession` The session to use to send requests with. Note that the library does not manage the session and will not close it. .. versionadded:: 2.0 client: :class:`Client` The client to initialise this webhook with. This allows it to attach the client's internal state. If ``session`` is not given while this is given then the client's internal session will be used. .. versionadded:: 2.2 bot_token: Optional[:class:`str`] The bot authentication token for authenticated requests involving the webhook. .. versionadded:: 2.0 Raises ------- ValueError The URL is invalid. TypeError Neither ``session`` nor ``client`` were given. Returns -------- :class:`Webhook` A partial :class:`Webhook`. A partial webhook is just a webhook object with an ID and a token. zXdiscord(?:app)?\.com/api/webhooks/(?P[0-9]{17,20})/(?P[A-Za-z0-9\.\-\_]{60,})NzInvalid webhook URL given.rrrr) researchr!rIrrwrr groupdict)rrr}rrmrFrs rRfrom_urlzWebhook.from_urlsd Iqsv w w 99:: :  &E'!! +: g  =>> > {{}}V s4 ????rTc |jd|}|dd||j|jj|j|j|j|j|j|jdd}|j}|j}|j }|j } |j } ||||| | |jj S)Nz #rr)username discriminatorr2ravatar_decoration_data global_name)r2rrrr`rr}rFrwrvr) rr2rrr_avatar_decoration_datarrDrwrrwrvr) rrrrrfeedrFrwr}rwrvs rR _as_followerzWebhook._as_follower8s-,,7,,|$!* ( I!%!3g,*.*F#/     z+_  s4*TYafakaqrrrrrTr7cp|j}|j}|j}|j}|||||||jjS)Nr)rwrrwrvr)rrrFrwr}rwrvs rR from_statezWebhook.from_stateRsDz+_  s4*TYafakaqrrrrrTT) prefer_authrrcKt}|rA|jr:||j|j|j|j|jd{V}nP|jr:| |j|j|j|j|jd{V}ntdt||j|j|j|j|j S)a|coro| Fetches the current webhook. This could be used to get a full webhook from a partial webhook. .. versionadded:: 2.0 .. note:: When fetching with an unauthenticated webhook, i.e. :meth:`is_authenticated` returns ``False``, then the returned webhook does not contain any user information. Parameters ----------- prefer_auth: :class:`bool` Whether to use the bot token over the webhook token if available. Defaults to ``True``. Raises ------- HTTPException Could not fetch the webhook NotFound Could not find the webhook by this ID ValueError This webhook does not have a token associated with it. Returns -------- :class:`Webhook` The fetched webhook. rN5This webhook does not have a token associated with itr}rvrwrrF) r0rrzrr2r}rvrwrrr!r-rD)rQradapterrs rRfetchz Webhook.fetchZs$F ##%%  V4? V .. j? /DDZ V 99  j? :DDTUU U L*/+     rT)ryrrycK|j|jtdt}|rC|jr<||j|j|j|j|j |d{VdS|jr<| |j|j|j|j|j |d{VdSdS)a|coro| Deletes this Webhook. Parameters ------------ reason: Optional[:class:`str`] The reason for deleting this webhook. Shows up on the audit log. .. versionadded:: 1.4 prefer_auth: :class:`bool` Whether to use the bot token over the webhook token if available. Defaults to ``True``. .. versionadded:: 2.0 Raises ------- HTTPException Deleting the webhook failed. NotFound This webhook does not exist. Forbidden You do not have permissions to delete this webhook. ValueError This webhook does not have a token associated with it. Nr)rr}rvrwryr) rrzr!r0rrr2r}rvrwr)rQryrrs rRrzWebhook.deletes 8 : $/"9TUU U##%%  4? ((o j? )         Z 33  j? 4           rT)ryrrrrrrOptional[bytes]rOptional[Snowflake]c HK|j|jtdi}|tur|t |nd|d<|tur|t j|nd|d<t}d}|\|jtd|j |d<| |j |j||j |j |j |d{V}n|rC|jr<| |j |j||j |j |j |d{V}nB|jr;||j |j||j |j |j |d{V}|tdt!||j |j |j |j|j S) a|coro| Edits this Webhook. .. versionchanged:: 2.0 This function will now raise :exc:`ValueError` instead of ``InvalidArgument``. Parameters ------------ name: Optional[:class:`str`] The webhook's new default name. avatar: Optional[:class:`bytes`] A :term:`py:bytes-like object` representing the webhook's new default avatar. channel: Optional[:class:`abc.Snowflake`] The webhook's new channel. This requires an authenticated webhook. .. versionadded:: 2.0 reason: Optional[:class:`str`] The reason for editing this webhook. Shows up on the audit log. .. versionadded:: 1.4 prefer_auth: :class:`bool` Whether to use the bot token over the webhook token if available. Defaults to ``True``. .. versionadded:: 2.0 Raises ------- HTTPException Editing the webhook failed. NotFound This webhook does not exist. ValueError This webhook does not have a token associated with it or it tried editing a channel without authentication. Nrrrz.Editing channel requires authenticated webhookr)rtr}rvrwryz+Unreachable code hit: data was not assignedr)rrzr!rIrr_bytes_to_base64_datar0rr2rr}rvrwrrr-rD) rQryrrrrrtrrs rRrz Webhook.edits*^ : $/"9TUU U w  +/+;c$iiiGFO  GMGY ;F C C C_cGH ##%%)-  & !QRRR$+JGL ! -- j?.DD T_  -- j?.DDZ  88  j?9D <LMM M L*/+     rTr^r<cht||j|}|turt|d}|j}|j|krHt |tr tj n|o|j }t|j|j ||}n|jpt|j|j |}nn|j}t |ttfr||j}|/t|j|j t|d}t!|||S)N)r\r^r)rFr`r2r)rFr`r2)rrFr)rHrDrIrrrrr)r public_threadrr*r`r( get_threadr2r.)rQrr^rFrrrs rR_create_messagezWebhook._create_message;s+d4;vFFF W  T,/00JlG*,,4>w 4U4Uu{00\c\thoht,4;[elpqqq,v*<4;Y]Yfku*v*v*vlG'L+#>?? 8!,,VY77,4;[^_cdp_q[r[rsss4ugFFFFrT) r avatar_url ephemeralrrxrr^ thread_namesuppress_embedssilent applied_tagsrrrrrr,rxrrr5rr?r Literal[True]rrrrList[ForumTag]r.c  KdSrOrmrQrrrrrxrrrr^rrrrs rRsendz Webhook.sendSs "rT.) rrrrrxrrr^rrrrLiteral[False]c  KdSrOrmrs rRrz Webhook.sendfs "srT)rrrrrrxrrrrr^rrrrrrrrr3rr r>rr@c KdSrOrmrQrrrrrrrxrrrrr^rrrrrrs rRrz Webhook.sendys ,rT)rrrrrrxrrrrr^rrrrrrc KdSrOrmrs rRrz Webhook.sends ,srTFr=Optional[WebhookMessage]crK|jtdt|jdd}|t}|s|s|r*t jd}||_||_||_ nt}|j tj u}|r|std|rd}| turt| dstd| jjt#|jt$r#| rtd |dur"| j| rd | _| tur| turtd |turt}n d |D}t+|||||||| || | | ||| 5}t,}d}| tur| j}||j|j|j|j|j|j|j|j||| tu d{V}dddn #1swxYwYd}|r| || }| turN| !s:| r&|dn|j}|j"| ||tur|r|#||S)a|coro| Sends a message using the webhook. The content must be a type that can convert to a string through ``str(content)``. To upload a single file, the ``file`` parameter should be used with a single :class:`File` object. If the ``embed`` parameter is provided, it must be of type :class:`Embed` and it must be a rich embed type. You cannot mix the ``embed`` parameter with the ``embeds`` parameter, which must be a :class:`list` of :class:`Embed` objects to send. .. versionchanged:: 2.0 This function will now raise :exc:`ValueError` instead of ``InvalidArgument``. Parameters ------------ content: :class:`str` The content of the message to send. wait: :class:`bool` Whether the server should wait before sending a response. This essentially means that the return type of this function changes from ``None`` to a :class:`WebhookMessage` if set to ``True``. If the type of webhook is :attr:`WebhookType.application` then this is always set to ``True``. username: :class:`str` The username to send with this message. If no username is provided then the default username for the webhook is used. avatar_url: :class:`str` The avatar URL to send with this message. If no avatar URL is provided then the default avatar for the webhook is used. If this is not a string then it is explicitly cast using ``str``. tts: :class:`bool` Indicates if the message should be sent using text-to-speech. ephemeral: :class:`bool` Indicates if the message should only be visible to the user. This is only available to :attr:`WebhookType.application` webhooks. If a view is sent with an ephemeral message and it has no timeout set then the timeout is set to 15 minutes. .. versionadded:: 2.0 file: :class:`File` The file to upload. This cannot be mixed with ``files`` parameter. files: List[:class:`File`] A list of files to send with the content. This cannot be mixed with the ``file`` parameter. embed: :class:`Embed` The rich embed for the content to send. This cannot be mixed with ``embeds`` parameter. embeds: List[:class:`Embed`] A list of embeds to send with the content. Maximum of 10. This cannot be mixed with the ``embed`` parameter. allowed_mentions: :class:`AllowedMentions` Controls the mentions being processed in this message. .. versionadded:: 1.4 view: Union[:class:`discord.ui.View`, :class:`discord.ui.LayoutView`] The view to send with the message. If the webhook is partial or is not managed by the library, then you can not send interactable components. Otherwise, you can send views with any type of components. .. versionadded:: 2.0 thread: :class:`~discord.abc.Snowflake` The thread to send this webhook to. .. versionadded:: 2.0 thread_name: :class:`str` The thread name to create with this webhook if the webhook belongs to a :class:`~discord.ForumChannel`. Note that this is mutually exclusive with the ``thread`` parameter, as this will create a new thread with the given name. .. 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 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 applied_tags: List[:class:`ForumTag`] Tags to apply to the thread if the webhook belongs to a :class:`~discord.ForumChannel`. .. versionadded:: 2.4 poll: :class:`Poll` The poll to send with this message. .. warning:: When sending a Poll via webhook, you cannot manually end it. .. versionadded:: 2.4 Raises -------- HTTPException Sending the message failed. NotFound This webhook was not found. Forbidden The authorization token for the webhook is incorrect. TypeError You specified both ``embed`` and ``embeds`` or ``file`` and ``files`` or ``thread`` and ``thread_name``. ValueError The length of ``embeds`` was invalid, there was no token associated with this webhook or ``ephemeral`` was passed with the improper webhook type or there was no state attached with this webhook when giving it a view that had components other than URL buttons. Returns --------- Optional[:class:`WebhookMessage`] If ``wait`` is ``True`` then the message that was sent, otherwise ``None``. Nrrrz=ephemeral messages can only be sent from application webhooksT__discord_ui_view__>expected view parameter to be of type View or LayoutView, not WWebhook views with interactable components require an associated state with the webhookg @z4Cannot mix thread_name and thread keyword arguments.cg|] }|j Srmr<)rtags rRrz Webhook.send..]s-M-M-Mcf-M-M-MrT)rrrrrrxrrrrrrrrr) r}rvrwrtrurxrrrr)$rr!rzrDrIr _from_valuerrsuppress_notificationsrr applicationhasattrrrrjrrHis_dispatchabletimeoutr#r0rr2rr}rvrwrtrurxr is_finished store_viewr)rQrrrrrrrxrrrrr^rrrrrrprevious_mentionsrapplication_webhookapplied_tag_idsr{rrrmsgrs rRrz Webhook.sends|^ : TUU U7>t{L^`d7e7e ?G   6  ,Q//E'EO$3E !+1E ( (E"i;+BB  ^0 ^\]] ]  D w  4!677 | zaeaoax z z{{{$+}55 |$:N:N:P:P | !z{{{D  T\%9d>R>R>T>T%9( g % %&*?*?RSS S 7 " "%OO-M-M -M-M-MO &!#-&7(   "  #''))G'+IW$$"I  00  j? *l# $G 31        D-" " " " " " " " " " " " " " " H  <&&tF&;;C w  t'7'7'9'9 d>R>R>T>T !$#&J K " "4 4 4 4 w  3  LL    s BHH!Hrc ,K|jtdd}|tur|j}t}||j|j||j|j|j |d{V}| ||S)a|coro| Retrieves a single :class:`~discord.WebhookMessage` owned by this webhook. .. versionadded:: 2.0 Parameters ------------ id: :class:`int` The message ID to look for. thread: :class:`~discord.abc.Snowflake` The thread to look in. Raises -------- ~discord.NotFound The specified message was not found. ~discord.Forbidden You do not have the permissions required to get a message. ~discord.HTTPException Retrieving the message failed. ValueError There was no token associated with this webhook. Returns -------- :class:`~discord.WebhookMessage` The message asked for. Nrr}rvrwrr) rr!rIr2r0rrr}rvrwr)rQr2r^rrrs rR fetch_messagezWebhook.fetch_messages> : TUU U#'   I##%%00 G J L*1        ##D#888rT)rrr^rrr r c KdSrOrm)rQrrrrr^s rRr~zWebhook.edit_messages rTr}r Optional[View]c KdSrOrm) rQrrrrrrrr^s rRr~zWebhook.edit_messages rTr cXK|jtd|rit|dstd|jjt |jtr#| rtdt|jdd} t||||||| 5} d} |tur|j } t} | |j |j||j|j|j| j| j| j| t/| d{V} dddn #1swxYwY|| | }|rC|s/| r|j|||S) a |coro| Edits a message owned by this webhook. This is a lower level interface to :meth:`WebhookMessage.edit` in case you only have an ID. .. versionadded:: 1.6 .. versionchanged:: 2.0 The edit is no longer in-place, instead the newly edited message is returned. .. versionchanged:: 2.0 This function will now raise :exc:`ValueError` instead of ``InvalidArgument``. Parameters ------------ message_id: :class:`int` The message ID to edit. content: Optional[:class:`str`] The content to edit the message with or ``None`` to clear it. embeds: List[:class:`Embed`] A list of embeds to edit the message with. embed: Optional[:class:`Embed`] The embed to edit the message with. ``None`` suppresses the embeds. This should not be mixed with the ``embeds`` parameter. attachments: List[Union[:class:`Attachment`, :class:`File`]] A list of attachments to keep in the message as well as new files to upload. If ``[]`` is passed then all attachments are removed. .. versionadded:: 2.0 allowed_mentions: :class:`AllowedMentions` Controls the mentions being processed in this message. See :meth:`.abc.Messageable.send` for more information. view: Optional[Union[:class:`~discord.ui.View`, :class:`~discord.ui.LayoutView`]] The updated view to update this message with. If ``None`` is passed then the view is removed. If the webhook is partial or is not managed by the library, then you can not send interactable components. Otherwise, you can send views with any type of components. .. note:: To update the message to add a :class:`~discord.ui.LayoutView`, you must explicitly set the ``content``, ``embed``, ``embeds``, and ``attachments`` parameters to either ``None`` or an empty array, as appropriate. .. versionadded:: 2.0 thread: :class:`~discord.abc.Snowflake` The thread the webhook message belongs to. .. versionadded:: 2.0 Raises ------- HTTPException Editing the message failed. Forbidden Edited a message that is not yours. TypeError You specified both ``embed`` and ``embeds`` ValueError The length of ``embeds`` was invalid, there was no token associated with this webhook or the webhook had no state. Returns -------- :class:`WebhookMessage` The newly edited webhook message. Nrrrrr)rrrrrrr)r}rvrwrtrurxrrr)rr!rrrrjrrDrHrrzr#rIr2r0rrr}rvrwrtrurxrrrr)rQrrrrrrrr^rr{rrrmessages rRr~zWebhook.edit_messages%h : TUU U  |4!677 | zaeaoax z z{{{$+}55 |$:N:N:P:P | !z{{{7>t{L^`d7e7e &#-&7    '+IW$$"I #''))G 55  j? *l# $T 6        D               8&&tF&;;  5((** 5t/C/C/E/E 5 K " "4 4 4 4s0BEE Ec K|jtdd}|tur|j}t}||j|j||j|j|j |d{VdS)a|coro| Deletes a message owned by this webhook. This is a lower level interface to :meth:`WebhookMessage.delete` in case you only have an ID. .. versionadded:: 1.6 .. versionchanged:: 2.0 ``message_id`` parameter is now positional-only. .. versionchanged:: 2.0 This function will now raise :exc:`ValueError` instead of ``InvalidArgument``. Parameters ------------ message_id: :class:`int` The message ID to delete. thread: :class:`~discord.abc.Snowflake` The thread the webhook message belongs to. .. versionadded:: 2.0 Raises ------- HTTPException Deleting the message failed. Forbidden Deleted a message that is not yours. ValueError This webhook does not have a token associated with it. Nrr) rr!rIr2r0rrr}rvrw)rQrr^rrs rRrzWebhook.delete_message[sH : TUU U#'   I##%%,, G J L*-           rT)NNNN)rrr}r~rrrFr]rvrrwrrUr[r>) r2rrrr}r~rr4rrrUr1) rrr}r~rr4rrrUr1ri)rrrFr7rUr1)rrrUr-)ryrrrrUr[) ryrrrrrrrrrrUr-)r^r<)rrrrrrrr,rxrrr5rr?rrr^r<rrrrrrrrrUr.)rrrrrrrr,rxrrr5rr?rrr^r<rrrrrrrrrUr[)&rrrrrrrrrrrr,rxrrr3rr rr5rr>r^r<rrrrrrrrrrrr@rUr.)&rrrrrrrrrrrr,rxrrr3rr rr5rr>r^r<rrrrrrrrrrrr@rUr[)&rrrrrrrrrrrr,rxrrr3rr rr5rr=r^r<rrrrrrrrrrrr@rUr)r2rr^r<rUr.) rrrr rr?rr r^r<rUr.)rrrrrr rr rr rr rr r^r<rUr.)rrrrrr rr rr rr rr r^r<rUr.)rrr^r<rUr[)rjrkrlr?r@rrSr:rAr classmethodrIrrrrrrrrrrr r~r __classcell__)rs@rRr-r-LsNN`"DICCCC $"&#26 B B B B B B BQQQQJJJXJ *1 #'=@=@=@=@=@[=@~ *1 #' @@@@@@@@@@[@@Dsss[s2sss[s26? ? ? ? ? ? B7;PT222222n!%%")'+ j j j j j j XGGGG0 !! ',3$" ''.X$ !! ',3"#" ''.X$ !! '"),3#" ''.)X. !! '"),3#"" ''.)X2e ! '"),3 #" %'.)eeeeeeNFM090909090909d :=69X "%"%!$9<"69     X "")")!(9@#*6:#~~~~~~@OV4 4 4 4 4 4 4 4 4 4 rTr-rO)rrrrrUr$)rrrrrrrrrr,rxrrr rr rr rr rr rr rr@rUr$)r? __future__rloggingrer urllib.parserrtypingrrrrr r r r r rrr contextvarsrrqrrerrorsrrrrrrenumsrrrrrrrrrassetr partial_emojir!rwr"r#r$r%r&mixinsr'rr(r)r*r+rr,__all__ getLoggerrjrtyping_extensionsr1typesr2rr3rr4mentionsr5r6rFr7r8rr9emojir:r;abcr<ui.viewr=r>r?rr@datetime types.webhookr-rrArE types.messageMessagePayload types.user UserPayloadrBPartialUserPayload types.channelrCr3 types.emojirmtypes.snowflakerDtypes.interactionsrE"InteractionCallbackResponsePayload BaseExceptionrFrGrIrrKrorr-r0r/r0rPrHr.rrmrTrRr2s0#""""" ******uuuuuuuuuuuuuuuuuuuuuuuuuuuu""""""KKKKKKKKKKKKEEEEEEEEEEEE!!!!!!!! ((((((bbbbbbbbbbbbbbMMMMMMMMMMMM w""&5&&&&&&######******$$$$$$''''''&&&&&&4444444444OOOBAAAAA////// ] + + +B ?O3 4F}.WTWTWTWTWTWTWTWTt LLLLL%!#$%5<&29;?mOmOmOmOmOmO`2<