cjhѡdZddlmZddlZddlZddlZddlZddlZddlZddl m Z m Z m Z m Z ddlmZddlmZddlmZdd lmZmZmZmZmZdd lmZdd lmZdd lm Z dd l!m"Z"ddl#m$Z$m%Z%m&Z&dZ'ejPe)Z*e r'ddl+m,Z,ddl-m.Z.ddl/m0Z0ddl1m2Z2ddl3m4Z5 ddl6m7Z7m8Z8ejtZ:GddZ;GddZ<GddejzZ>e>Z?d"dZ@GddeZAGd d!e$ZBy#e9$rY^wxYw)#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) TYPE_CHECKINGAnyLiteraloverload)quote)utils)PartialMessageable)DiscordServerError Forbidden HTTPExceptionInvalidArgumentNotFound)Route)Message)Object)Thread) BaseWebhook _WebhookStatehandle_message_parameters) SyncWebhookSyncWebhookMessage) Snowflake)Embed)File)AllowedMentions)Webhook)ResponseSessionc(eZdZddZdZddZdZy) DeferredLockc ||_d|_yN)lockdelta)selfr&s G/var/www/html/venv/lib/python3.12/site-packages/discord/webhook/sync.py__init__zDeferredLock.__init__Qs #' c:|jj|Sr%)r&acquirer(s r) __enter__zDeferredLock.__enter__Us  r+c||_yr%)r')r(r's r)delay_byzDeferredLock.delay_byYs  r+c|jrtj|j|jj yr%)r'timesleepr&release)r(typevalue tracebacks r)__exit__zDeferredLock.__exit__\s) :: JJtzz " r+N)r&zthreading.Lock)r'floatreturnNone)__name__ __module__ __qualname__r*r/r1r9r+r)r#r#Ps(r+r#ceZdZdZddddddd ddZddd ddZdd ddZdd dd Zdd dd Zdddddd d  dd Z dd ddZ ddddd ddZ dd ddZ ddZ ddZy)WebhookAdapterc6tj|_yr%)weakrefWeakValueDictionary_locksr.s r)r*zWebhookAdapter.__init__cs3:3N3N3P r+N)payload multipartfilesreason auth_tokenparamsc i} |xsg}d} |j|jf} |j| } |d| d<t j|} |d|| d<|t|d| d<d} d}d}|j}|j}|j}t| 5} tdD]X}|D]}|j| |r,i}|D]%}|d }|d k(rd |d i} |d |d |df||<' |j||| || |5} tj!d|||| j"d| _| j"| _| j(xsd}|r'| j*ddk(rt-j.|}| j*j1d}|dk(rL| j"dk7r=t j2| }tj!d||| j5|d| j"cxkDrdk\rnn|cdddccdddS| j"dk(rc| j*j1ds t7| ||d}tj9d||t;j<| ddd| j"dk\r&t;j<d|dzz ddd| j"dk(r t?| || j"dk(r tA| |t7| || r'| j"dk\r tG| |t7| |tId"#t$r't j x|j| <} Y8wxYw#1swYnxYw#tB$r:}|d kr/|jDd!vr!t;j<d|dzzYd}~d}~wwxYw#1swYyxYw)#Nzapplication/jsonz Content-TypezBot Authorizationz/ )safezX-Audit-Log-Reason)seekname payload_jsonr7filename content_type)datarIheadersrLz4Webhook ID %s with %s %s has returned status code %szutf-8zX-Ratelimit-Remaining0izGWebhook ID %s has been pre-emptively rate limited, waiting %.2f secondsi,Via retry_afterz7Webhook ID %s is rate limited. Retrying in %.2f secondsirr ii)6iF'z"Unreachable code in HTTP handling.)% webhook_id webhook_tokenrFKeyError threadingLockr _to_jsonurlquotemethodurlr#rangeresetrequest_logdebug status_codeencodingstatustextrWjsonloadsget_parse_ratelimit_headerr1rwarningr3r4r rOSErrorerrnor RuntimeError)r(routesessionrGrHrIrJrKrLrWto_sendbucketr&responserV file_datarerfr^attemptfileprR remainingr'r[es r)rizWebhookAdapter.requestfsN#% /3""E$7$78 :;;v&D  &8GN #nnW-G  !)-j\':GO $  ,4V$,GG( )$(,0+/ ii%% $ c E4 8[ !-DJJGJ,- "I&  y>1'5qz&BG!"* !' !. 1/IdO J $' '% )C@" R&"$00 -4)*2*>*>'}}4 ( 0 0 @DV V#'::d#3D$,$4$4$8$89P$Q $+0D0D0K$)$A$A($KE JJ%<!+ % !MM%0!5!5<<#'QC@C@'c Ec Ez$//36#+#3#3#7#7#>&3Hd&C C15m1DK LL%/!+ + !JJ{3$qC@C@t$//36 JJq7Q;7$yC@C@|$//36"+Hd";;%11S8"*8T"::"/$"??k[ z''3.,Xt<<#Hd33CD Do :)2)9 9DKK $ :NC@C@C@J{qww+'= 1w{?3  qc Ec EsL< AO8M=C:M/ M=OA(M/M=O+M/;M=OAM/5O<,M,+M,/M8 4M=;O= O.N;4O:N;;OOO )tokenrJcHtdd|}|j||||S)NDELETE/webhooks/{webhook_id}r^)rJrKrrir(r^rryrJrxs r)delete_webhookzWebhookAdapter.delete_webhooks*h 8ZP||E76e|LLr+rJcHtdd||}|j|||S)Nr&/webhooks/{webhook_id}/{webhook_token}r^r_rrrs r)delete_webhook_with_tokenz(WebhookAdapter.delete_webhook_with_tokens1  4!   ||E76|::r+cJtdd|}|j|||||S)NPATCHrr)rJrGrKrr(r^rrGryrJrxs r) edit_webhookzWebhookAdapter.edit_webhook s4g7JO|| 767u  r+cJtdd||}|j||||S)Nrrr)rJrGrrs r)edit_webhook_with_tokenz&WebhookAdapter.edit_webhook_with_tokens3  4!   ||E767|KKr+F)rGrHrI thread_id thread_namewaitcdt| i} |r|| d<|r||d<tdd||} |j| ||||| S)NrrrPOSTrr)rGrHrIrL)intrri) r(r^rryrGrHrIrrrrLrxs r)execute_webhookzWebhookAdapter.execute_webhook,sl#d)$ "+F;  %0GM "  4!   ||     r+rc\i}|r||d<tdd|||}|j|||S)NrGETr?r*rirrrrrrrrrrr@r+r)rBrBbsQ*.15#'!!%(,JEJEJE ' JE / JE!JEJEJE&JE JE`!! M M M  M  M"" ;;;  ;  ;."            *"LLL L  LL.*.15#' $"&! ! !  ! ' ! /! !! !  ! ! T!%;;; ;  ;;<!%)-15#'        ' / ! P!%;;; ;  ;;.FFF  F 4 4 4  4r+rBceZdZUdZded<y)_WebhookContextNzWebhookAdapter | Noneadapter)r=r>r?r__annotations__r@r+r)rrs %)G ")r+rchtjtt_tjSr%)_contextrrBr@r+r)_get_webhook_adapterrs%)+   r+c`eZdZUdZded<eeeeedef ddZddd dZy) raRepresents 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:: 2.0 r_stateNc pt}t|drt|j}n9t |j t rt|j j}|tur|jj}|jjj|j|||||||| S)aEdits the message. 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. 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. allowed_mentions: :class:`AllowedMentions` Controls the mentions being processed in this message. See :meth:`.abc.Messageable.send` for more information. suppress: Optional[:class:`bool`] Whether to suppress embeds for the message. Returns ------- :class:`SyncWebhookMessage` The newly edited message. Raises ------ HTTPException Editing the message failed. Forbidden Edited a message that is not yours. TypeError You specified both ``embed`` and ``embeds`` or ``file`` and ``files`` ValueError The length of ``embeds`` was invalid InvalidArgument There was no token associated with this webhook. _thread_idcontentembedsembedrrIallowed_mentionsthreadsuppress) MISSINGhasattrrr isinstancechannelridflagssuppress_embedsr_webhook edit_message) r(rrrrrIrrrs r)editzSyncWebhookMessage.editsd 4 &DOO,F  f -DLLOO,F w zz11H{{##00 GG-1  r+)delayc*d}t|dr |j}n0t|jtr|jj }|t j||jjj|j |y)aDeletes the message. Parameters ---------- delay: Optional[:class:`float`] If provided, the number of seconds to wait before deleting the message. This blocks the thread. Raises ------ Forbidden You do not have proper permissions to delete the message. NotFound The message was deleted already. HTTPException Deleting the message failed. Nrr) rrrrrrr3r4rrdelete_message)r(rrs r)deletezSyncWebhookMessage.deletesj&!% 4 &I  f - I   JJu  ++DGGy+Ir+)rrr list[Embed]r Embed | NonerrrI list[File]rAllowedMentions | Nonerz bool | Noner;r)rz float | Noner;r<)r=r>r?__doc__rrrrr@r+r)rrs  &%%#37 'E E E  E  E  E 1E E  E N/3Jr+rceZdZUdZdZded< d d!fd ZdZed"dZ e e dd  d#d Z e e dd  d$d Z d d d%dZdd dd&dZde e dd d d'dZdZee fe e e e e e e e e dd d(dZee fe e e e e e e e e dde d d)dZe fe e de e e e e e dddd d*dZdd d+dZe e e e e de dd d,dZddd-dZxZS).raeRepresents a synchronous Discord webhook. For an asynchronous counterpart, see :class:`Webhook`. .. 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 webhook'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 rztuple[str, ...] __slots__Nc6t||||||_yr%)superr*ry)r(rVryrstate __class__s r)r*zSyncWebhook.__init__ss ue, r+c"d|jdS)Nz )rr.s r)__repr__zSyncWebhook.__repr__}sdgg[**r+c:d|jd|jS)zReturns the webhook's url.z!https://discord.com/api/webhooks//)rrr.s r)rfzSyncWebhook.urls3477)1TZZLIIr+)ry bot_tokenc|d|d}ddl}|tur|}n.t||jst d|j ||||S)aACreates a partial :class:`Webhook`. Parameters ---------- id: :class:`int` The ID of the webhook. token: :class:`str` The authentication token of the webhook. session: :class:`requests.Session` The session to use to send requests with. Note that the library does not manage the session and will not close it. If not given, the ``requests`` auto session creation functions are used instead. bot_token: Optional[:class:`str`] The bot authentication token for authenticated requests involving the webhook. Returns ------- :class:`Webhook` A partial :class:`Webhook`. A partial webhook is just a webhook object with an ID and a token. r)rr6rrNexpected requests.Session not r)requestsrrr! TypeErrorr)clsrrryrrVrs r)partialzSyncWebhook.partials`B   g GGX%5%56\d{17,20})/(?P[\w\.\-_]{60,68})NzInvalid webhook URL given.rr6rrr) researchr groupdictrrrr!rr)rrfryrmrVrs r)from_urlzSyncWebhook.from_urls< II ]   9!">? ? {{}V  g GGX%5%56#7"8 4??(($//4<<(XD ZZ33T\\4D"G 4T__DKKXXr+)rJrcb|j|j tdt}|r@|jr4|j |j |j|j |y|jr4|j|j |j|j |yy)aDeletes 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``. Raises ------ HTTPException Deleting the webhook failed. NotFound This webhook does not exist. Forbidden You do not have permissions to delete this webhook. InvalidArgument This webhook does not have a token associated with it. Nr)rryrJ)ryrJ)rrKrrrrryr)r(rJrrs r)rzSyncWebhook.deletes0 :: $//"9!G #7"8 4??  " "t V # ZZ  - -T\\& . r+)rJrRavatarrrc|j|j tdi}|tur| t |nd|d<|tur|t j |nd|d<t}d}|Z|j td|j|d<|j|j|j||j|}|rA|jr5|j|j|j||j|}n@|jr4|j|j|j||j|}| tdt||j|j|j S) aYEdits this Webhook. 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. 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``. Returns ------- :class:`SyncWebhook` The newly edited webhook. Raises ------ HTTPException Editing the webhook failed. NotFound This webhook does not exist. InvalidArgument This webhook does not have a token associated with it, or it tried editing a channel without authentication. NrrRrz.Editing channel requires authenticated webhook channel_id)rGryrJz+Unreachable code hit: data was not assigned)rVryrr)rrKrrrr _bytes_to_base64_datarrrryrrwrr) r(rJrRrrrrGrrVs r)rzSyncWebhook.edit7sT :: $//"9!G  w +/+;c$iGFO  7=7I++F3t H #7"8&*  &%&VWW$+JJGL !''  (D 4??''  (DZZ22   3D <LM Mt||4??$++  r+ct||j}|jxs#t|jt |d}t |||S)N)parentr)rr)rVrr)rrrr rr)r(rVrrs r)_create_messagezSyncWebhook._create_messagesFd4;;7,,c"44;;3tT`OaKb"c!t5'JJr+) username avatar_urlttsrrIrrrrrc yr%r@) r(rrrrrrIrrrrrrs r)sendzSyncWebhook.sends !r+.) rrrrrIrrrrrrrc yr%r@)r(rrrrrrIrrrrrrrs r)rzSyncWebhook.sends"r+Fc |j tdt|jdd}|t}| r | r tdt ||||||||| ||  }t }d}| tur | j}|j|j|j|j|j|j|j|| |  }| r|j|Sy)a 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. 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``. 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. 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 thread: :class:`~discord.abc.Snowflake` The thread to send this message to. .. versionadded:: 2.0 thread_name: :class:`str` The name of the thread to create. Only works for forum channels. .. versionadded:: 2.0 suppress: :class:`bool` Whether to suppress embeds for the message. Returns ------- Optional[:class:`SyncWebhookMessage`] If ``wait`` is ``True`` then the message that was sent, otherwise ``None``. 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`` ValueError The length of ``embeds`` was invalid InvalidArgument There was no token associated with this webhook, or you specified both a thread to send to and a thread to create (the ``thread`` and ``thread_name`` parameters). Nrrz2You cannot specify both a thread and a thread name) rrrrrrIrrrprevious_allowed_mentionsr)ryrGrHrIrrr)rrgetattrrrrrrrryrGrHrIr)r(rrrrrrIrrrrrrrprevious_mentionsrLrrrVs r)rzSyncWebhook.sendsz :: !G 5< KK+T5  ?G k!"VW W*!-&7  #7"8 $   I&& GG JJLLNN&&,,#'   ''- - r+rc|j tdt}|j|j|j||j |}|j |}|r!t|jtr||_ |S)a Retrieves a single :class:`~discord.SyncWebhookMessage` owned by this webhook. .. versionadded:: 2.0 Parameters ---------- id: :class:`int` The message ID to look for. thread_id: Optional[:class:`int`] The ID of the thread that contains the message. Returns ------- :class:`~discord.SyncWebhookMessage` The message asked for. 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. InvalidArgument There was no token associated with this webhook. rryr) rrrrrryrrrr r)r(rrrrVmsgs r) fetch_messagezSyncWebhook.fetch_messageOs> :: !G #7"8** GG JJ LL + ""4( CKK1CD&CN r+rc |j tdt|jdd} t ||||||| | } t } d} |t ur |j} | j|j|j||j| | j| j| j}|j|S)auEdits 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 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. 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. allowed_mentions: :class:`AllowedMentions` Controls the mentions being processed in this message. See :meth:`.abc.Messageable.send` for more information. thread: Optional[:class:`~discord.abc.Snowflake`] The thread that contains the message. Raises ------ HTTPException Editing the message failed. Forbidden Edited a message that is not yours. TypeError You specified both ``embed`` and ``embeds`` or ``file`` and ``files`` ValueError The length of ``embeds`` was invalid InvalidArgument There was no token associated with this webhook. Nrr)rrrIrrrrr)ryrrGrHrI)rrr rrrrrrryrGrHrIr)r(rrrrrrIrrrr rLrrrVs r)rzSyncWebhook.edit_messagesp :: !G 5< KK+T5 +-&7  #7"8 $   I++ GG JJ LLNN&&,,,  ##D))r+c|j tdt}|j|j|j||j |y)a4Deletes 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 Parameters ---------- message_id: :class:`int` The message ID to delete. thread_id: Optional[:class:`int`] The ID of the thread that contains the message. Raises ------ HTTPException Deleting the message failed. Forbidden Deleted a message that is not yours. Nrr )rrrrrry)r(rrrs r)rzSyncWebhook.delete_messagesV, :: !G #7"8&& GG JJ LL ' r+)NN)rVWebhookPayloadryr!rr)r;r) rrrrryr!rrr;r)rfrryr!rrr;r)rrr;r)rJrrrr;r<) rJrrRrrz bytes | NonerSnowflake | Nonerrr;r)rrrrrrrrrrrIrrrrrrrrrrrrz Literal[True]r;r)rrrrrrrrrrrIrrrrrrrrrrrrzLiteral[False]rrr;r<)rrrrrrrrrrrIrrrrrrrrrrrrrrrr;zSyncWebhookMessage | None)rrrrr;r)rrrrrrrrrrrIrrrrrrrr;r)rrrrr;r<)r=r>r?rrrr*rpropertyrf classmethodrrrrrrrrrrrr __classcell__)rs@r)rr9sv5n".I- !  +JJ # $ *3 *3*3  *3  *3 *3*3X-4d,3,3#*,3AK,3 ,3,3\,0,Y\.2t&V""&$( _ _  _  _ " _ _  _ BK! !#%,3#"&!! !  !  !!!!!*!! !! !!" !#%,3#"&"      *  !(I. !#%,3#"&I.I. I.  I.  I.I.I.I.I.*I.I. I.I.I. #!I.X3700%/0 0l&%%#37#*Z*Z* Z*  Z*  Z*Z*Z*1Z*!Z*Z* Z*xJN" " r+r)r;rB)Cr __future__rrploggingrrar3rDtypingrrrr urllib.parserrdr rr errorsr r rrrhttprmessagerobjectrthreadsrasync_rrr__all__ getLoggerr=rjabcrrrrrmentionsr types.webhookrrrr r!ModuleNotFoundErrorrr#rBlocalrrrrrr@r+r)r(s>#   88*(II  w"*9 . --$S4S4l *ioo*   qJqJhF  +F  _    s$DD  D