i/^dZddlmZddlZddlmZmZmZmZm Z m Z m Z m Z m Z ddlmZddlmZddlmZmZd ZGd d ZGd d eZe r_ddlmZddlmZmZe dZGdde ZGdde Z Gdde Z!Gdde Z"Gdde Z#GddZdS)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) AnyDictListMappingOptionalProtocol TYPE_CHECKINGTypeVarUnion)utils)Colour)AttachmentFlags EmbedFlags)Embedc6eZdZddZddZddZdd ZddZdS) EmbedProxylayerDict[str, Any]c:|j|dSN)__dict__update)selfrs U/home/ubuntu/.hermes/hermes-agent/venv/lib/python3.11/site-packages/discord/embeds.py__init__zEmbedProxy.__init__*s U#####returnintc*t|jSrlenrrs r__len__zEmbedProxy.__len__-s4=!!!rstrcldfdtD}d|dS)Nz, c3lK|].}|d|dt|V/dS)_=N) startswithgetattr).0krs r z&EmbedProxy.__repr__..1sPcc1QRQ]Q]^aQbQbca66'$"2"266ccccccrz EmbedProxy())joindir)rinners` r__repr__zEmbedProxy.__repr__0s@ ccccD cccdd%U%%%%rattrNonecdSr)rr5s r __getattr__zEmbedProxy.__getattr__4strotherobjectboolcLt|to|j|jkSr) isinstancerrrr:s r__eq__zEmbedProxy.__eq__7s %,,P%.1PPrNrrrr )rr&)r5r&rr6)r:r;rr<)__name__ __module__ __qualname__rr%r4r9r@r8rrrr)s~$$$$""""&&&&QQQQQQrrc@eZdZd fd Zd dZed dZxZS) EmbedMediaProxyrrct||jdd|_dS)Nflagsr)superrrpop_flags)rr __class__s rrzEmbedMediaProxy.__init__<s8 m''33 rrr<c2t|jdkS)Nr r"r$s r__bool__zEmbedMediaProxy.__bool__@s4=!!A%%rrc8tj|jpdSNr)r _from_valuerLr$s rrIzEmbedMediaProxy.flagsFs*4;+;!<<Zd?d@d]dBZd?d@d^dDZ dLdEZ!d_dFZ"d?d@d^dGZ#d`dIZ$dS)araRepresents a Discord embed. .. container:: operations .. describe:: len(x) Returns the total size of the embed. Useful for checking if it's within the 6000 character limit. .. describe:: bool(b) Returns whether the embed has any data set. .. versionadded:: 2.0 .. describe:: x == y Checks if two embeds are equal. .. versionadded:: 2.0 For ease of use, all parameters that expect a :class:`str` are implicitly casted to :class:`str` for you. .. versionchanged:: 2.0 ``Embed.Empty`` has been removed in favour of ``None``. Attributes ----------- title: Optional[:class:`str`] The title of the embed. This can be set during initialisation. Can only be up to 256 characters. type: :class:`str` The type of embed. Usually "rich". This can be set during initialisation. Possible strings for embed types can be found on discord's :ddocs:`api docs ` description: Optional[:class:`str`] The description of the embed. This can be set during initialisation. Can only be up to 4096 characters. url: Optional[:class:`str`] The URL of the embed. This can be set during initialisation. timestamp: Optional[:class:`datetime.datetime`] The timestamp of the embed content. This is an aware datetime. If a naive datetime is passed, it is converted to an aware datetime with the local timezone. colour: Optional[Union[:class:`Colour`, :class:`int`]] The colour code of the embed. Aliased to ``color`` as well. This can be set during initialisation. )titlergtype _timestamp_colour_footer_image _thumbnail_video _provider_author_fields descriptionrLNrich)colourcolorrqrrrgr| timestampr~Optional[Union[int, Colour]]rrq Optional[Any]rrrWrgr|rOptional[datetime.datetime]c8||n||_||_||_||_||_d|_|jt |j|_|jt |j|_|jt |j|_| ||_dSdSrQ)r~rqrrrgr|rLr&r)rr~rrqrrrgr|rs rrzEmbed.__init__s!' 2ff $) # "%*5 : !TZDJ   '"4#344D  8 48}}DH  &DNNN ! rdataMapping[str, Any]rrVc||}|dd|_|dd|_|dd|_|dd|_|dd|_|jt|j|_|jt|j|_|jt|j|_ t|d |_ n#t$rYnwxYw tj |d |_ n#t$rYnwxYwd D]/} ||}t|d |z| #t$rY,wxYw|S) arConverts a :class:`dict` to a :class:`Embed` provided it is in the format that Discord expects it to be in. You can find out about this format in the :ddocs:`official Discord documentation `. Parameters ----------- data: :class:`dict` The dictionary to convert into an embed. rqNrrr|rgrIrrrcr) thumbnailvideoproviderauthorfieldsimagefooterr))__new__getrqrrr|rgrLr&rrtKeyErrorr parse_timerssetattr)clsrrr5rcs r from_dictzEmbed.from_dicts{{3XXgt,, HHVT** 88M48888E4((hhw** : !TZDJ   '"4#344D  8 48}}DH !W 666DLL    D  #.tK/@AADOO    D ^ 1 1D 1T cDj%0000      s6>D D'&D'+E EE E== F  F cZ|j|S)z$Returns a shallow copy of the embed.)rMrto_dictr$s rcopyz Embed.copy s ~'' 777rr ct|jpdt|jpdz}t|dgD]0}|t|dt|dzz }1 |jd}|t|z }n#t t f$rYnwxYw |j}|t|dz }n#t $rYnwxYw|S)Nr{rbrcr\)r#rqr|r,ruAttributeErrorrrz)rtotalfield footer_textrs rr%z Embed.__len__ s DJ$"%%D,<,B(C(CCT9b11 > >E Sv''#eGn*=*== =EE &,v.K S%% %EE)    D   )\F S(( (EE    D   s$1 BB%$B%)C CCr<ct|j|j|j|j|j|j|j|j|j |j |j |j f Sr) anyrqrgr|r~rrrrrrrrr$s rrOzEmbed.__bool__"sV             rr:ct|to|j|jko|j|jko|j|jko|j|jko|j|jko|j|jko|j|jkoo|j |j ko_|j |j koO|j |j ko?|j |j ko/|j |j ko|j|jko|j|jkSr)r>rrrrqrgr|r~rrrrrrrrrLr?s rr@z Embed.__eq__4s%'' I # , ek) ,EI% , E$55 , u|+ ,  u|+ , %/1 , u|+ ,%/1 , u|+ , ek) , / , ek) , u|+ rrc8tj|jpdS)zU:class:`EmbedFlags`: The flags of this embed. .. versionadded:: 2.5 r)rrRrLr$s rrIz Embed.flagsFs %dk&6Q777rOptional[Colour]c$t|ddS)Nrtr,r$s rr~z Embed.colourNstY---rrcr6c| d|_dSt|tr ||_dSt|trt||_dSt d|jjd)Nrz3Expected discord.Colour, int, or None but received z instead.)rtr>rr TypeErrorrMrCrrcs rr~z Embed.colourRsz =DLLL v & & w DLLL s # # w!...DLLLuRWRaRjuuuvv vrc$t|ddS)Nrsrr$s rrzEmbed.timestamp_st\4000rct|tjr$|j|}||_dS| d|_dSt d|jjd)Nz,Expected datetime.datetime or None received z instead)r>datetimetzinfo astimezonersrrMrCrs rrzEmbed.timestampcsk eX. / / o|#((**#DOOO ]"DOOOm5?Kcmmmnn nrrZc>tt|diS)zReturns an ``EmbedProxy`` denoting the footer contents. See :meth:`set_footer` for possible values you can access. If the attribute has no value then ``None`` is returned. rurr,r$s rrz Embed.footern'$ 266777r)r\r]r\r]cxi|_|t||jd<|t||jd<|S)aSets the footer for the embed content. This function returns the class instance to allow for fluent-style chaining. Parameters ----------- text: :class:`str` The footer text. Can only be up to 2048 characters. icon_url: :class:`str` The URL of the footer icon. Only HTTP(S) is supported. Inline attachment URLs are also supported, see :ref:`local_image`. Nr\r])rur&)rr\r]s r set_footerzEmbed.set_footerys@  #&t99DL  '*8}}DL $ rc. |`n#t$rYnwxYw|S)zClears embed's footer information. This function returns the class instance to allow for fluent-style chaining. .. versionadded:: 2.0 )rurr$s r remove_footerzEmbed.remove_footer5      D   rfc>tt|diS)aReturns an ``EmbedProxy`` denoting the image contents. Possible attributes you can access are: - ``url`` for the image URL. - ``proxy_url`` for the proxied image URL. - ``width`` for the image width. - ``height`` for the image height. - ``flags`` for the image's attachment flags. If the attribute has no value then ``None`` is returned. rvrGr,r$s rrz Embed.imagewtXr::;;;rc^| |`n&#t$rYnwxYwdt|i|_|S)aSets the image for the embed content. This function returns the class instance to allow for fluent-style chaining. Parameters ----------- url: Optional[:class:`str`] The source URL for the image. Only HTTP(S) is supported. If ``None`` is passed, any existing image is removed. Inline attachment URLs are also supported, see :ref:`local_image`. Nrg)rvrr&rrgs r set_imagezEmbed.set_imagesR ; KK!    s3xxDK  c>tt|diS)aReturns an ``EmbedProxy`` denoting the thumbnail contents. Possible attributes you can access are: - ``url`` for the thumbnail URL. - ``proxy_url`` for the proxied thumbnail URL. - ``width`` for the thumbnail width. - ``height`` for the thumbnail height. - ``flags`` for the thumbnail's attachment flags. If the attribute has no value then ``None`` is returned. rwrr$s rrzEmbed.thumbnailswt\2>>???rc^| |`n&#t$rYnwxYwdt|i|_|S)aSets the thumbnail for the embed content. This function returns the class instance to allow for fluent-style chaining. Parameters ----------- url: Optional[:class:`str`] The source URL for the thumbnail. Only HTTP(S) is supported. If ``None`` is passed, any existing thumbnail is removed. Inline attachment URLs are also supported, see :ref:`local_image`. Nrg)rwrr&rs r set_thumbnailzEmbed.set_thumbnailsR ; OO!    s3xxDO rc>tt|diS)aReturns an ``EmbedProxy`` denoting the video contents. Possible attributes include: - ``url`` for the video URL. - ``proxy_url`` for the proxied video URL. - ``height`` for the video height. - ``width`` for the video width. - ``flags`` for the video's attachment flags. If the attribute has no value then ``None`` is returned. rxrr$s rrz Embed.videorrrlc>tt|diS)zReturns an ``EmbedProxy`` denoting the provider contents. The only attributes that might be accessed are ``name`` and ``url``. If the attribute has no value then ``None`` is returned. ryrr$s rrzEmbed.providers'$ R88999rrnc>tt|diS)zReturns an ``EmbedProxy`` denoting the author contents. See :meth:`set_author` for possible values you can access. If the attribute has no value then ``None`` is returned. rzrr$s rrz Embed.authorrr)rgr]rbrcdt|i|_|t||jd<|t||jd<|S)aSets the author for the embed content. This function returns the class instance to allow for fluent-style chaining. Parameters ----------- name: :class:`str` The name of the author. Can only be up to 256 characters. url: :class:`str` The URL for the author. icon_url: :class:`str` The URL of the author icon. Only HTTP(S) is supported. Inline attachment URLs are also supported, see :ref:`local_image`. rbNrgr])r&rz)rrbrgr]s r set_authorzEmbed.set_authorsN$ CII   ?"%c((DL   '*8}}DL $ rc. |`n#t$rYnwxYw|S)zClears embed's author information. This function returns the class instance to allow for fluent-style chaining. .. versionadded:: 1.4 )rzrr$s r remove_authorzEmbed.remove_author:rrList[_EmbedFieldProxy]c8dt|dgDS)zList[``EmbedProxy``]: Returns a :class:`list` of ``EmbedProxy`` denoting the field contents. See :meth:`add_field` for possible values you can access. If the attribute has no value then ``None`` is returned. c,g|]}t|Sr8)r)r-ds r z Embed.fields..RsDDD! 1 DDDrr{rr$s rrz Embed.fieldsIs%EDwtY'C'CDDDDrT)rdrdc|t|t|d} |j|n#t$r |g|_YnwxYw|S)aAdds a field to the embed object. This function returns the class instance to allow for fluent-style chaining. Can only be up to 25 fields. Parameters ----------- name: :class:`str` The name of the field. Can only be up to 256 characters. value: :class:`str` The value of the field. Can only be up to 1024 characters. inline: :class:`bool` Whether the field should be displayed inline. rdrbrc)r&r{appendr)rrbrcrdrs r add_fieldzEmbed.add_fieldTsr"IIZZ    # L   & & & & # # #!7DLLL # s=AAindexc|t|t|d} |j||n#t$r |g|_YnwxYw|S)alInserts a field before a specified index to the embed. This function returns the class instance to allow for fluent-style chaining. Can only be up to 25 fields. .. versionadded:: 1.2 Parameters ----------- index: :class:`int` The index of where to insert the field. name: :class:`str` The name of the field. Can only be up to 256 characters. value: :class:`str` The value of the field. Can only be up to 1024 characters. inline: :class:`bool` Whether the field should be displayed inline. r)r&r{insertrrrrbrcrdrs rinsert_field_atzEmbed.insert_field_atqst*IIZZ    # L  u - - - - # # #!7DLLL # s>AAcj |jn#t$r g|_YnwxYw|S)zRemoves all fields from this embed. This function returns the class instance to allow for fluent-style chaining. .. versionchanged:: 2.0 This function now returns the class instance. )r{clearrr$s r clear_fieldszEmbed.clear_fieldssK  L      DLLL  s 00cH |j|=n#ttf$rYnwxYw|S)aSRemoves a field at a specified index. If the index is invalid or out of bounds then the error is silently swallowed. This function returns the class instance to allow for fluent-style chaining. .. note:: When deleting a field by index, the index of the other fields shift to fill the gap just like a regular list. .. versionchanged:: 2.0 This function now returns the class instance. Parameters ----------- index: :class:`int` The index of the field to remove. )r{r IndexError)rrs r remove_fieldzEmbed.remove_fields@,  U## +    D  s  c |j|}n*#tttf$rtdwxYwt ||d<t ||d<||d<|S)aModifies a field to the embed object. The index must point to a valid pre-existing field. Can only be up to 25 fields. This function returns the class instance to allow for fluent-style chaining. Parameters ----------- index: :class:`int` The index of the field to modify. name: :class:`str` The name of the field. Can only be up to 256 characters. value: :class:`str` The value of the field. Can only be up to 1024 characters. inline: :class:`bool` Whether the field should be displayed inline. Raises ------- IndexError An invalid index was provided. zfield index out of rangerbrcrd)r{rrrr&rs r set_field_atzEmbed.set_field_atst2 9L'EE:~6 9 9 9788 8 9D f Ug h s '7 EmbedDatacpfdtjD} |d}|r |j|d<n#t$rYnwxYw |d}|r||jr;|tjj  |d<nK| tjj  |d<n#t$rYnwxYwj r j |d<j r j |d<jr j|d <jr j|d <|S) z'Converts this embed object into a dict.czi|]7}|ddkt||ddt|8S)rr)r N)hasattrr,)r-keyrs r z!Embed.to_dict..sP   1v}}s!3!3} GWT3''}}rr~rr)tz)rrrr|rgrq)r __slots__rKrcrrrrtimezoneutc isoformatreplacerrr|rgrq)rresultr~rs` rrz Embed.to_dicts         /ZZ))F /"(,w     D  f ;//I f#f*3*>*>(BSBW*>*X*X*b*b*d*dF;''*3*;*;8CTCX*;*Y*Y*c*c*e*eF;'    D  9 '!YF6N   5$($4F= ! 8 % HF5M : )"jF7O s!= A  A C"" C/.C/)r~rrrrqrrrrWrgrr|rrr)rrrrV)rrVrBrS)r:rrr<)rr)rr)rcrrr6)rr)rcrrr6)rrZ)r\rr]rrrV)rrf)rgrrrV)rrl)rrn)rbrrgrr]rrrV)rr)rbrrcrrdr<rrV) rr rbrrcrrdr<rrV)rr rrV)rr)%rCrDrE__doc__rr classmethodrrr%rOr@rTrIr~setterrrrrrrrrrrrrrrrrrrrrrr8rrrrms44lI(04.2# !%)15''''''<333[3j8888*    $    $888X8...X. ]www]w E 111X1oooo888X837RV0    <<<X< 4@@@X@ 4<<<X< :::X:888X8=A\`:    EEEXEBF:TXB :QU!!!!!!F......rr)$r __future__rrtypingrrrrrr r r r rrr~rrIrr__all__rrGtyping_extensionsrV types.embedrrrWrXrZrarfrlrnr8rrrsZ0#"""""^^^^^^^^^^^^^^^^^^^^^^........  QQQQQQQQ$ = = = = =j = = = &&&&&&&:::::::: A     H   8 8h&&&&&H&&&c c c c c c c c c c r