cjhxdZddlmZddlZddlmZmZmZmZddl m Z ddl m Z dZ ed d Zer dd lmZdd lmZGddZGddZGddZGddZGddZGdd Zy)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_CHECKINGAnyMappingTypeVar)utils)Colour)Embed EmbedField EmbedAuthor EmbedFooter EmbedMedia EmbedProviderEr )bound)r ) EmbedTypecVeZdZdZ d d dZed dZd dZd dZd dZ y)r aRepresents the author on the :class:`Embed` object. .. versionadded:: 2.5 Attributes ---------- name: :class:`str` The name of the author. url: :class:`str` The URL of the hyperlink created in the author's name. icon_url: :class:`str` The URL of the author icon image. proxy_icon_url: :class:`str` The proxied URL of the author icon image. This can't be set directly, it is set by Discord. Nc<||_||_||_d|_yN)nameurlicon_urlproxy_icon_urlselfrrrs A/var/www/html/venv/lib/python3.12/site-packages/discord/embeds.py__init__zEmbedAuthor.__init__Ds!  "$, *.c|j|}|jd}|s td||_|jd|_|jd|_|jd|_|S)Nrzname field is requiredrrr)__new__get ValueErrorrrrr)clsdatarrs r from_dictzEmbedAuthor.from_dictOsj{{3xx56 6 88E?, "hh'78 rcdt|ji}|jrt|j|d<|jrt|j|d<|S)Nrrr)strrrrrds rto_dictzEmbedAuthor.to_dict[sJ S^ $ 88488}AeH == .AjMrc,t|jS)z:Returns the total number of characters in the author name.)lenrrs r__len__zEmbedAuthor.__len__c499~rcVd|jd|jd|jdS)Nz)rrrr.s r__repr__zEmbedAuthor.__repr__gs+#DII=dhh\DMMK\\]^^r)NN)rr(r str | Nonerr6returnNone)r%dict[str, str | None]r7r )r7zdict[str, str]r7intr7r( __name__ __module__ __qualname____doc__r classmethodr&r+r/r5rrr r 3s^&# / / / /  /  _rr cPeZdZdZ d d dZed dZd dZd dZd dZ y)ravRepresents the footer on the :class:`Embed` object. .. versionadded:: 2.5 Attributes ---------- text: :class:`str` The text inside the footer. icon_url: :class:`str` The URL of the footer icon image. proxy_icon_url: :class:`str` The proxied URL of the footer icon image. This can't be set directly, it is set by Discord. Nc.||_||_d|_yr)textrrrrFrs rrzEmbedFooter.__init__zs  $, *.rc|j|}|jd}|s td||_|jd|_|jd|_|S)NrFztext field is requiredrr)r!r"r#rFrr)r$r%rrFs rr&zEmbedFooter.from_dicts[{{3xx56 6 , "hh'78 rc|dt|ji}|jrt|j|d<|S)NrFr)r(rFrr)s rr+zEmbedFooter.to_dicts2 S^ $ == .AjMrc,t|jS)z:Returns the total number of characters in the footer text.)r-rFr.s rr/zEmbedFooter.__len__r0rc<d|jd|jdS)Nz$>E$>SZ  FJ  rc pd|jd|jd|jd|jd S)Nz height=z width=r4rRr.s rr5zEmbedMedia.__repr__s>!$(([8J)TXT_T_SbbijnjtjtiwwxyyrN)rr()r%zdict[str, str | int]r7rr<) r>r?r@rA__annotations__rrBr&r5rCrrrrs?" H   zrrc@eZdZUdZded<ded<eddZd dZy) rzRepresents a provider on the :class:`Embed` object. .. versionadded:: 2.5 Attributes ---------- name: :class:`str` The name of the provider. url: :class:`str` The URL of the provider. r6rrc|j|}|jd|_|jd|_|S)Nrr)r!r"rrr$r%rs rr&zEmbedProvider.from_dicts4{{3HHV$ 88E? rc<d|jd|jdS)Nzr?r@rArVrBr&r5rCrrrrs,   O Frrc<eZdZdZdddZed dZd dZd dZy) r a-Represents a field on the :class:`Embed` object. .. versionadded:: 2.0 Attributes ---------- name: :class:`str` The name of the field. value: :class:`str` The value of the field. inline: :class:`bool` Whether the field should be displayed inline. c.||_||_||_yrrvalueinlinerrr^r_s rrzEmbedField.__init__s   rc~|j|}|d|_|d|_|jdd|_|S)aConverts a :class:`dict` to a :class:`EmbedField` provided it is in the format that Discord expects it to be in. You can find out about this format in the `official Discord documentation`__. .. _DiscordDocsEF: https://discord.com/developers/docs/resources/channel#embed-object-embed-field-structure __ DiscordDocsEF_ Parameters ---------- data: :class:`dict` The dictionary to convert into an EmbedField object. rr^r_F)r!rr^r"r_rYs rr&zEmbedField.from_dicts? {{3L '] hhx/  rcJ|j|j|jdS)zConverts this EmbedField object into a dict. Returns ------- Dict[:class:`str`, Union[:class:`str`, :class:`bool`]] A dictionary of :class:`str` embed field keys bound to the respective value. r]r]r.s rr+zEmbedField.to_dicts#IIZZkk  rcVd|jd|jd|jdS)Nzr?r@rArrBr&r+r5rCrrr r s+  .  ^rr c &eZdZdZdZddddddddddddd d.dZed/dZd0dZd1d Z d2d Z e d3d Z e jd4d Z e Ze d5d Zejd6dZe d7dZejd8dZddd d9dZd0dZe d:dZejd;dZddZejd?dZddd  d@d!Zd0d"Ze dAd#ZejdBd$ZdCd%Zd&d'dDd(Z d&d' dEd)Z!dFd*Z"dGd+Z#d&d' dEd,Z$dHd-Z%y)Ir aRepresents 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 For ease of use, all parameters that expect a :class:`str` are implicitly cast to :class:`str` for you. Attributes ---------- title: :class:`str` The title of the embed. This can be set during initialisation. Must be 256 characters or fewer. 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 `api docs `_ description: :class:`str` The description of the embed. This can be set during initialisation. Must be 4096 characters or fewer. url: :class:`str` The URL of the embed. This can be set during initialisation. timestamp: :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: Union[:class:`Colour`, :class:`int`] The colour code of the embed. Aliased to ``color`` as well. This can be set during initialisation. ) titlertype _timestamp_colour_footer_image _thumbnail_video _provider_author_fields descriptionNrich) colourcolorrerfrrp timestampfieldsauthorfooterimage thumbnailc |r|n||_||_||_||_||_|jrt |j|_|jrt |j|_|jrt |j|_|r||_||ng|_| |_| |_ | |_ | |_ yr) rrrerfrrpr(rtrorvrwrxry) rrrrsrerfrrprtrurvrwrxrys rrzEmbed.__init___s !'fE   & ::TZZDJ   "4#3#34D  88488}DH &DN393E2    "rcP|j|}|jdd|_|jdd|_|jdd|_|jdd|_|jrt |j|_|jrt |j|_|j rt |j |_ t|d|_ tj|d|_ d D]\}|d k(r?|j|g}|r#|Dcgc]}tj|c}ng|_G ||}t!|d ||^|S#t$rYwxYw#t$rY}wxYwcc}w#t$rYwxYw) a!Converts 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 `official Discord documentation`__. .. _DiscordDocs: https://discord.com/developers/docs/resources/channel#embed-object __ DiscordDocs_ Parameters ---------- data: :class:`dict` The dictionary to convert into an embed. Returns ------- :class:`Embed` The converted embed object. reNrfrprrsr^rt)ryvideoproviderrvrurxrwru_)r!r"rerfrprr(r rhKeyErrorr parse_timergr r&rosetattr)r$r%rattrr^r*s rr&zEmbed.from_dicts,++c"XXgt, HHVT* 88M4888E4( ::TZZDJ   "4#3#34D  88488}DH !W 6DL #..tK/@ADO  5Dxr*KPGA 4 4Q 7GVX 5 JEDAdV*e4% 5( 9        H s<!E66F5FF6 FF FF F%$F%cT|jj|jS)zCreates a shallow copy of the :class:`Embed` object. Returns ------- :class:`Embed` The copied embed object. ) __class__r&r+r.s rcopyz Embed.copys~~'' 77rcd}|jr|t|jz }|jr|t|jz }t|dgD]0}|t|jt|j zz }2 |j d}|t|z } |j}|t|dz }|S#ttf$rY1wxYw#t$rY|SwxYw)NrrorFr) rer-rpgetattrrr^riAttributeErrorrrn)rtotalfield footer_textrvs rr/z Embed.__len__s :: S_ $E    S))* *ET9b1 8E S_s5;;'77 7E 8 &,,v.K S% %E )\\F S( (E )       s$ C * C CC C+*C+c t|j|j|j|j|j |j |j|j|j|j|j|jf Sr) anyrerrprrrurtrvryrwrxr~r}r.s r__bool__zEmbed.__bool__sj             rct|ddS)Nrhrr.s rrrz Embed.colourstY--rc|t|tr||_yt|trt||_yt d|j j d)Nr|z3Expected discord.Colour, int, or None but received instead.) isinstancer rhr; TypeErrorrr>rr^s rrrz Embed.colour sV =Juf5 DL s #!.DLOO,,-Y8 rct|ddS)Nrgrr.s rrtzEmbed.timestampst\400rct|tjr$|j|j}||_y|||_yt d|j jd)Nz-Expected datetime.datetime or None. Received  instead)rdatetimetzinfo astimezonergrrr>rs rrtzEmbed.timestampsf eX.. /||#((*#DO ]#DOOO,,-X7 rcLt|dd}|sytj|S)zReturns an :class:`EmbedFooter` denoting the footer contents. See :meth:`set_footer` for possible values you can access. If the footer is not set then `None` is returned. riN)rrr&)rfoots rrwz Embed.footer+)tY-$$T**rc||jyt|tr|j|_yt d|j jd)Nz'Expected EmbedFooter or None. Received r) remove_footerrrr+rirrr>rs rrwz Embed.footer8sS =    { + ==?DLOO,,-X7 rrLc|i|_|rt||jd<|rt||jd<|S)a|Sets 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. Must be 2048 characters or fewer. icon_url: :class:`str` The URL of the footer icon. Only HTTP(S) is supported. rFr)rir(rGs r set_footerzEmbed.set_footerDs:( #&t9DLL '*8}DLL $ rc, |`|S#t$rY|SwxYw)zClears embed's footer information. This function returns the class instance to allow for fluent-style chaining. .. versionadded:: 2.0 )rirr.s rrzEmbed.remove_footera,         cLt|dd}|sytj|S)zReturns an :class:`EmbedMedia` denoting the image contents. Attributes you can access are: - ``url`` - ``proxy_url`` - ``width`` - ``height`` If the image is not set then `None` is returned. rjNrrr&)rimgs rrxz Embed.imageps)dHd+##C((rc||jyt|tr|j|yt|tr|j|j yt d|jjdN)rz2Expected discord.EmbedMedia, or None but received r) remove_imagerr( set_imagerrrrr>rs rrxz Embed.imagesp =     s # NNuN % z * NNuyyN )OO,,-Y8 rcX| |`|Sdt|i|_|S#t$rY|SwxYw)aaSets the image for the embed content. This function returns the class instance to allow for fluent-style chaining. .. versionchanged:: 1.4 Passing `None` removes the image. Parameters ---------- url: :class:`str` The source URL for the image. Only HTTP(S) is supported. r)rjrr(rSs rrzEmbed.set_imagesP ; K s3xDK "      ))c, |`|S#t$rY|SwxYw)zRemoves the embed's image. This function returns the class instance to allow for fluent-style chaining. .. versionadded:: 2.0 )rjrr.s rrzEmbed.remove_images,       rcLt|dd}|sytj|S)aReturns an :class:`EmbedMedia` denoting the thumbnail contents. Attributes you can access are: - ``url`` - ``proxy_url`` - ``width`` - ``height`` If the thumbnail is not set then `None` is returned. rkNr)rthumbs rryzEmbed.thumbnails)lD1##E**rc||jyt|tr|j|yt|tr|j|j yt d|jjdr) remove_thumbnailrr( set_thumbnailrrrrr>rs rryzEmbed.thumbnailsv =  ! ! # s #   5  ) z *   599  -OO,,-Y8 rcX| |`|Sdt|i|_|S#t$rY|SwxYw)amSets the thumbnail for the embed content. This function returns the class instance to allow for fluent-style chaining. .. versionchanged:: 1.4 Passing `None` removes the thumbnail. Parameters ---------- url: :class:`str` The source URL for the thumbnail. Only HTTP(S) is supported. r)rkrr(rSs rrzEmbed.set_thumbnailsP ; O s3xDO "    rc, |`|S#t$rY|SwxYw)zRemoves the embed's thumbnail. This function returns the class instance to allow for fluent-style chaining. .. versionadded:: 2.0 )rkrr.s rrzEmbed.remove_thumbnails,      rcLt|dd}|sytj|S)aReturns an :class:`EmbedMedia` denoting the video contents. Attributes include: - ``url`` for the video URL. - ``height`` for the video height. - ``width`` for the video width. If the video is not set then `None` is returned. rlNr)rvids rr}z Embed.videos)dHd+##C((rcLt|dd}|sytj|S)zReturns an :class:`EmbedProvider` denoting the provider contents. The only attributes that might be accessed are ``name`` and ``url``. If the provider is not set then `None` is returned. rmN)rrr&)rprovs rr~zEmbed.providers)t[$/&&t,,rcLt|dd}|sytj|S)zReturns an :class:`EmbedAuthor` denoting the author contents. See :meth:`set_author` for possible values you can access. If the author is not set then `None` is returned. rnN)rr r&)rauths rrvz Embed.author"rrc||jyt|tr|j|_yt d|j jd)Nz3Expected discord.EmbedAuthor, or None but received r) remove_authorrr r+rnrrr>rs rrvz Embed.author/sS =    { + ==?DLOO,,-Y8 r)rrcdt|i|_|rt||jd<|rt||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. Must be 256 characters or fewer. url: :class:`str` The URL for the author. icon_url: :class:`str` The URL of the author icon. Only HTTP(S) is supported. rrr)r(rnrs r set_authorzEmbed.set_author;sG0 CI   "%c(DLL  '*8}DLL $ rc, |`|S#t$rY|SwxYw)zClears embed's author information. This function returns the class instance to allow for fluent-style chaining. .. versionadded:: 1.4 )rnrr.s rrzEmbed.remove_author^rrc|jS)zReturns a :class:`list` of :class:`EmbedField` objects denoting the field contents. See :meth:`add_field` for possible values you can access. If the attribute has no value then ``None`` is returned. )ror.s rruz Embed.fieldsms||rcLtd|Ds td||_y)zSets the fields for the embed. This overwrites any existing fields. Parameters ---------- value: List[:class:`EmbedField`] The list of :class:`EmbedField` objects to include in the embed. c3<K|]}t|tywr)rr ).0xs r zEmbed.fields..s<:a, |j|=y#t$rYywxYw)aRemoves a field at a specified index. If the index is invalid or out of bounds then the error is silently swallowed. .. note:: When deleting a field by index, the index of the other fields shift to fill the gap just like a regular list. Parameters ---------- index: :class:`int` The index of the field to remove. N)ro IndexError)rrs r remove_fieldzEmbed.remove_fields%   U#   s  c |j|}t||_t||_||_|S#ttf$r tdwxYw)aModifies a field to the embed object. The index must point to a valid pre-existing field. There must be 25 fields or fewer. 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. Must be 256 characters or fewer. value: :class:`str` The value of the field. Must be 1024 characters or fewer. inline: :class:`bool` Whether the field should be displayed inline. Raises ------ IndexError An invalid index was provided. zfield index out of range)rorrr(rr^r_rs r set_field_atzEmbed.set_field_ats[: 9LL'EY %j   :& 978 8 9s :Ac~|jDcic]+}|dk7r$|ddk(rt||r|ddt||-}}|jDcgc]}|j c}|d< |j d}|r|j |d< |j d }|r|jr<|jtjj j|d <n<|jtjj j|d < |jr|j|d <|j r|j |d <|j"r|j"|d<|j$r|j$|d<|Scc}wcc}w#t$rYwxYw#t$rYwxYw)zConverts this embed object into a dict. Returns ------- Dict[:class:`str`, Union[:class:`str`, :class:`int`, :class:`bool`]] A dictionary of :class:`str` embed keys bound to the respective value. rorrrNrurrrsrt)tz)rrfrprre) __slots__hasattrrror+popr^rrrrtimezoneutc isoformatreplacerfrprre)rkeyresultrrrrts rr+z Embed.to_dicts~~ iCFcMgdC6H GWT3' '  :>FEMMOFx /ZZ)F"(,,w " ;/I##*3*>*>#,,00+?+ik;'+4*;*;'0044+<+ik;' 99!YYF6N   $($4$4F= ! 88 HHF5M ::"jjF7O _ G       s/0FF-F F0 F-,F-0 F<;F<)rrint | Colour | Nonersrre Any | Nonerfrrrrprrtdatetime.datetime | Noneruzlist[EmbedField] | NonervEmbedAuthor | NonerwEmbedFooter | Nonerxstr | EmbedMedia | Noneryr)r$ztype[E]r%zMapping[str, Any]r7r)rrr7rr:)r7bool)r7z Colour | None)r^r)r7r)r^r)r7r)r^r)rrrFrrrr7r)r7zEmbedMedia | None)r^r)rrrrr7r)r7zEmbedProvider | None)r7r)r^r) rrrrrrrrr7r)r7list[EmbedField])r^rr7r8)rr r7r8) rrrr(r^r(r_rr7r) rrrr;rrr^rr_rr7r)r7r8)rr;r7r8)r7 EmbedData)&r>r?r@rArrrBr&rr/rpropertyrrsetterrsrtrwrrrxrrryrrr}r~rvrrrurrrrrrr+rCrrr r !sf+ZI&'+%)  "&.2*.%)%))--1'#$'## '#  '#  '#'# '#,'#('##'##'#''#+'#RGGR82 $.. ]]   E 11   + + ]]   #   : ))" \\  6 ++"  6 ))  - - + + ]]  # !!! !  ! !F  ]]   #EI,GK&)25?C <,GK%%%&)%25%?C% %N9r)rA __future__rrtypingrrrrr rrr __all__rdiscord.types.embedr rrr rrrr rCrrrs2#77  Cw6-5_5_p.N.Nb)z)zXFF6;^;^|_ _ r