iNtdZddlmZddlZddlmZmZmZmZm Z m Z m Z ddl m Z ddlmZmZmZddlmZdd lmZdd lmZd Z e rdd lmZmZmZmZdd lm Z GddZ!Gdde!ZGdde!Z"Gdde!Z#GddZ$Gdde!Z%e ee"e%e#e$fZ&e d&d Z'e d'd"Z'd(d%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)AnyDictListOptional TYPE_CHECKINGUnionoverload)Asset) ActivityTypeStatusDisplayTypetry_enumColour) PartialEmoji)_get_as_snowflake) BaseActivityActivity StreamingGameSpotifyCustomActivity)rActivityTimestamps ActivityPartyActivityAssets)ConnectionStatec>eZdZdZdZd dZedd Zdd Zd S)raThe base activity that all user-settable activities inherit from. A user-settable activity is one that can be used in :meth:`Client.change_presence`. The following types currently count as user-settable: - :class:`Activity` - :class:`Game` - :class:`Streaming` - :class:`CustomActivity` Note that although these types are considered user-settable by the library, Discord typically ignores certain combinations of activity depending on what is currently set. This behaviour may change in the future so there are no guarantees on whether Discord will actually let you set these types. .. versionadded:: 1.3 ) _created_atkwargsrreturnNonec <|dd|_dS)N created_at)popr)selfr s W/home/ubuntu/.hermes/hermes-agent/venv/lib/python3.11/site-packages/discord/activity.py__init__zBaseActivity.__init__{s,2JJ|T,J,JOptional[datetime.datetime]c|j8tj|jdz tjjSdS)zOptional[:class:`datetime.datetime`]: When the user started doing this activity in UTC. .. versionadded:: 1.3 Ntzrdatetime fromtimestamptimezoneutcr&s r'r$zBaseActivity.created_at~?   '$2243Cd3JxO`Od2ee e ( 'r)ActivityPayloadctN)NotImplementedErrorr4s r'to_dictzBaseActivity.to_dicts!!r)Nr rr!r"r!r*)r!r6) __name__ __module__ __qualname____doc__ __slots__r(propertyr$r:r)r'rrfsu$!IKKKKfffXf""""""r)rceZdZdZdZdfd Zdd Zdd Zedd Z eddZ eddZ eddZ ddZ eddZeddZxZS)ra Represents an activity in Discord. This could be an activity such as streaming, playing, listening or watching. For memory optimisation purposes, some activities are offered in slimmed down versions: - :class:`Game` - :class:`Streaming` Attributes ------------ application_id: Optional[:class:`int`] The application ID of the game. name: Optional[:class:`str`] The name of the activity. url: Optional[:class:`str`] A stream URL that the activity could be doing. type: :class:`ActivityType` The type of activity currently being done. state: Optional[:class:`str`] The user's current state. For example, "In Game". details: Optional[:class:`str`] The detail of the user's current activity. platform: Optional[:class:`str`] The user's current platform. .. versionadded:: 2.4 timestamps: :class:`dict` A dictionary of timestamps. It contains the following optional keys: - ``start``: Corresponds to when the user started doing the activity in milliseconds since Unix epoch. - ``end``: Corresponds to when the user will finish doing the activity in milliseconds since Unix epoch. assets: :class:`dict` A dictionary representing the images and their hover text of an activity. It contains the following optional keys: - ``large_image``: A string representing the ID for the large image asset. - ``large_text``: A string representing the text when hovering over the large image asset. - ``large_url``: A string representing the URL of the large image asset. - ``small_image``: A string representing the ID for the small image asset. - ``small_text``: A string representing the text when hovering over the small image asset. - ``small_url``: A string representing the URL of the small image asset. party: :class:`dict` A dictionary representing the activity party. It contains the following optional keys: - ``id``: A string representing the party ID. - ``size``: A list of up to two integer elements denoting (current_size, maximum_size). buttons: List[:class:`str`] A list of strings representing the labels of custom buttons shown in a rich presence. .. versionadded:: 2.0 emoji: Optional[:class:`PartialEmoji`] The emoji that belongs to this activity. details_url: Optional[:class:`str`] A URL that is linked to when clicking on the details text of the activity. .. versionadded:: 2.6 state_url: Optional[:class:`str`] A URL that is linked to when clicking on the state text of the activity. .. versionadded:: 2.6 status_display_type: Optional[:class:`StatusDisplayType`] Determines which field from the user's status text is displayed in the members list. .. versionadded:: 2.6 )statedetails timestampsplatformassetspartyflagssync_id session_idtypenameurlapplication_idemojibuttons state_url details_urlstatus_display_typer rr!r"c tjdi||dd|_|dd|_|di|_|dd|_|di|_|di|_t|d|_ |dd|_ |d d|_ |d d |_ |d d|_|d d|_|dg|_|dd}t#|t$r|nt't$||_|dd}|t+j|nd|_|dd|_|dd|_|dd}t#|t4r|n|t't4|nd|_dS)NrErFrGrHrIrJrQrOrPrKrrLrMrSrNrRrTrUrVrC)superr(r%rErFrGrHrIrJrrQrOrPrKrLrMrS isinstancer rrNr from_dictrRrTrUrrV)r&r activity_typerRrV __class__s r'r(zActivity.__init__s&""6"""$*JJw$=$= &,jjD&A&A .4jjr.J.J'-zz*d'C'C &,jj2&>&> $*JJw$;$; ->vGW-X-X#)::fd#;#; "(**UD"9"9 **Wa00 &,jjD&A&A )/L$)G)G"(**Y";";  62.. ' |DD oMM(S_anJoJo  7D))NSN_\-CE-J-J-Jei (. ;(E(E*0**]D*I*I$jj)>EE-/@AA   #.+-@AAA    r)strc d|jfd|jfd|jfd|jfd|jfd|jfd|jfd|jff}d d |D}d |d S) NrNrOrPrHrFrQrMrR c3 K|] }d|zV dS)z%s=%rNrC).0ts r' z$Activity.__repr__..s&441444444r)z ) rNrOrPrHrFrQrMrRjoin)r&attrsinners r'__repr__zActivity.__repr__s TY  TY  DH   '  % t2 3 4? + dj !  44e44444$E$$$$r)Dict[str, Any]c\i}|jD]D}t||d}|t|trt |dkr?|||<Et |j|d<|jr|j|d<|j rt |j j |d<|S)NrrNrRrV) rAgetattrrZdictlenintrNrRr:rVvalue)r&retattrrps r'r:zActivity.to_dicts N  DD$--E}%&& 3u::??CII$)nnF : 0:--//CL  # M),T-E-K)L)LC% & r)r*c |jddz }tj|tjjS#t $rYdSwxYw)zfOptional[:class:`datetime.datetime`]: When the user started doing this activity in UTC, if applicable.startr,r-NrGr0r1r2r3KeyErrorr& timestamps r'rtzActivity.start0sa X047I$229ARAV2WW W   44 A AAc |jddz }tj|tjjS#t $rYdSwxYw)zhOptional[:class:`datetime.datetime`]: When the user will stop doing this activity in UTC, if applicable.endr,r-Nrurws r'r{z Activity.end:sa X.5I$229ARAV2WW W   44 ry Optional[str]cj |jd}||S#t$rYdSwxYw)zhOptional[:class:`str`]: Returns a URL pointing to the large image asset of this activity, if applicable. large_imageNrI _image_urlrv)r&r~s r'large_image_urlzActivity.large_image_urlDK 0+m4K??;// /   44  $ 22cj |jd}||S#t$rYdSwxYw)zhOptional[:class:`str`]: Returns a URL pointing to the small image asset of this activity, if applicable. small_imageNr)r&rs r'small_image_urlzActivity.small_image_urlNrrimagec|dr d|ddS|jtjd|jd|dzSdS)Nzmp:zhttps://media.discordapp.net/z /app-assets//z.png) startswithrQr BASE)r&rs r'rzActivity._image_urlXsd   E " " Q>59>> >  ,: Pt/B P PU P P PP P- ,r)c8|jddS)zaOptional[:class:`str`]: Returns the large image asset hover text of this activity, if applicable. large_textNrIgetr4s r'large_image_textzActivity.large_image_text^{|T222r)c8|jddS)zaOptional[:class:`str`]: Returns the small image asset hover text of this activity, if applicable. small_textNrr4s r'small_image_textzActivity.small_image_textcrr)r;r!r^r!rjr<r!r|)rr^r!r|)r=r>r?r@rAr(rir:rBrtr{rrrrr __classcell__r]s@r'rrsZIIVI*" " " " " " H % % % %$XXXXXXXXXX000X0000X0QQQQ 333X3333X33333r)rceZdZdZdZdfd Zedd Zedd ZeddZ ddZ ddZ ddZ ddZ ddZd dZxZS)!ra"A slimmed down version of :class:`Activity` that represents a Discord game. This is typically displayed via **Playing** on the official Discord client. .. container:: operations .. describe:: x == y Checks if two games are equal. .. describe:: x != y Checks if two games are not equal. .. describe:: hash(x) Returns the game's hash. .. describe:: str(x) Returns the game's name. Parameters ----------- name: :class:`str` The game's name. Attributes ----------- name: :class:`str` The game's name. platform: Optional[:class:`str`] Where the user is playing from (ie. PS5, Xbox). .. versionadded:: 2.4 assets: :class:`dict` A dictionary representing the images and their hover text of a game. It contains the following optional keys: - ``large_image``: A string representing the ID for the large image asset. - ``large_text``: A string representing the text when hovering over the large image asset. - ``small_image``: A string representing the ID for the small image asset. - ``small_text``: A string representing the text when hovering over the small image asset. .. versionadded:: 2.4 )rO_end_startrHrIrOr^extrarr!r"c rtjdi|||_|d|_|dipi|_ |d}|dd|_|dd|_dS#t$rd|_d|_YdSwxYw)NrHrIrGrtrr{rC) rYr(rOrrHrIrrrv)r&rOrrGr]s r'r(z Game.__init__s!!5!!! ',yy'<'< &+ii"&=&=&C  1-2<-@J %..!44DK"ua00DIII    DKDIIII sBB65B6r ctjS)z:class:`ActivityType`: Returns the game's type. This is for compatibility with :class:`Activity`. It always returns :attr:`ActivityType.playing`. )r playingr4s r'rNz Game.types ##r)r*c|jr8tj|jdz tjjSdS)zdOptional[:class:`datetime.datetime`]: When the user started playing this game in UTC, if applicable.r,r-N)rr0r1r2r3r4s r'rtz Game.starts= ; a$224;3E(J[J_2`` `tr)c|jr8tj|jdz tjjSdS)zfOptional[:class:`datetime.datetime`]: When the user will stop playing this game in UTC, if applicable.r,r-N)rr0r1r2r3r4s r'r{zGame.ends= 9 _$2249t3CHYH]2^^ ^tr)c*t|jSr8r^rOr4s r'__str__z Game.__str__49~~r)c(d|jd|jdS)Nz r?r@rAr(rBrNrtr{rrir:rrrrrs@r'rris0..`AI 1 1 1 1 1 1$$$X$X X GGGG    CCCC&&&&r)rceZdZdZdZdfd Zedd ZddZddZ eddZ ddZ ddZ ddZ d dZxZS)!ra!A slimmed down version of :class:`Activity` that represents a Discord streaming status. This is typically displayed via **Streaming** on the official Discord client. .. container:: operations .. describe:: x == y Checks if two streams are equal. .. describe:: x != y Checks if two streams are not equal. .. describe:: hash(x) Returns the stream's hash. .. describe:: str(x) Returns the stream's name. Attributes ----------- platform: Optional[:class:`str`] Where the user is streaming from (ie. YouTube, Twitch). .. versionadded:: 1.3 name: Optional[:class:`str`] The stream's name. details: Optional[:class:`str`] An alias for :attr:`name` game: Optional[:class:`str`] The game being streamed. .. versionadded:: 1.3 url: :class:`str` The stream's URL. assets: :class:`dict` A dictionary comprising of similar keys than those in :attr:`Activity.assets`. )rHrOgamerPrFrIrOr|rPr^rrr!r"c 8tjdi|||_|d||_|dd|_||_|d|j|_|di|_dS)NrFrErIrC) rYr(rHr%rOrrPrFrI)r&rOrPrr]s r'r(zStreaming.__init__s!!5!!!'+ #(99Y#=#= #(99Wd#;#; &+ii 49&E&E &+ii"&=&= r)r ctjS)z:class:`ActivityType`: Returns the game's type. This is for compatibility with :class:`Activity`. It always returns :attr:`ActivityType.streaming`. )r streamingr4s r'rNzStreaming.type %%r)c*t|jSr8rr4s r'rzStreaming.__str__!rr)c(d|jd|jdS)Nz   44 s ) 77rjctjjt|jt|j|jd}|jr |j|d<|S)N)rNrOrPrIrF)r rrpr^rOrPrIrF)r&rqs r'r:zStreaming.to_dict6sN *0 NNtx==k    < *!\C N r)rrrclt|to|j|jko|j|jkSr8)rZrrOrPrs r'rzStreaming.__eq__As0%++a di0GaEIY]YaLaar)c.|| Sr8rrs r'rzStreaming.__ne__Drr)roc*t|jSr8rr4s r'rzStreaming.__hash__Grr))rOr|rPr^rrr!r"rrrrrr)r=r>r?r@rAr(rBrNrrirr:rrrrrs@r'rrs**XII>>>>>>&&&X&LLLL ? ? ?X ?    bbbb&&&&r)rceZdZdZdZd+dZed,d Zed-d Zed.d Z ed.dZ d/dZ ed0dZ d1dZ d1dZd2dZd0dZd0dZed0dZed3dZed0dZed0d Zed0d!Zed0d"Zed0d#Zed4d%Zed4d&Zed5d(Zed0d)Zd*S)6raRepresents a Spotify listening activity from Discord. This is a special case of :class:`Activity` that makes it easier to work with the Spotify integration. .. container:: operations .. describe:: x == y Checks if two activities are equal. .. describe:: x != y Checks if two activities are not equal. .. describe:: hash(x) Returns the activity's hash. .. describe:: str(x) Returns the string 'Spotify'. )_state_details _timestamps_assets_party_sync_id _session_idrdatarr!r"c |dd|_|dd|_|di|_|di|_|di|_|dd|_|d|_|d d|_dS) NrErFrGrIrJrLrMr$) r%rrrrrrrr)r&rs r'r(zSpotify.__init__ds88GR00 !XXi44 /3xx b/I/I'+xx"'='= %)XXgr%:%: !XXi44 *.((<*@*@,0HH\4,H,Hr)r ctjS)z:class:`ActivityType`: Returns the activity's type. This is for compatibility with :class:`Activity`. It always returns :attr:`ActivityType.listening`. )r listeningr4s r'rNz Spotify.typenrr)r*c|j8tj|jdz tjjSdS)zuOptional[:class:`datetime.datetime`]: When the user started listening in UTC. .. versionadded:: 1.3 Nr,r-r/r4s r'r$zSpotify.created_atvr5r)rc tdS)z:class:`Colour`: Returns the Spotify integration colour, as a :class:`Colour`. There is an alias for this named :attr:`color`iTrr4s r'colourzSpotify.colours hr)c|jS)z:class:`Colour`: Returns the Spotify integration colour, as a :class:`Colour`. There is an alias for this named :attr:`colour`)rr4s r'colorz Spotify.colors {r)rjc `dd|j|j|j|j|j|j|jd S)N0r) rKrOrIrJrLrMrGrFrE)rrrrrrrr4s r'r:zSpotify.to_dicts<l[}**}[   r)r^cdS)zE:class:`str`: The activity's name. This will always return "Spotify".rrCr4s r'rOz Spotify.names yr)rrrct|to/|j|jko|j|jko|j|jkSr8)rZrrrrtrs r'rzSpotify.__eq__sK ug & & *!T%55 *$-/ * tz)  r)c.|| Sr8rrs r'rzSpotify.__ne__rr)roc*t|jSr8)rrr4s r'rzSpotify.__hash__sD$%%%r)cdS)NrrCr4s r'rzSpotify.__str__syr)c8d|jd|jd|jdS)Nz:class:`str`: The album that the song being played belongs to.rrrrr4s r'albumz Spotify.albums| b111r)cv|jdd}|dddkrdS|dd}d|zS)z;:class:`str`: The album cover image URL from Spotify's CDN.r~rNzspotify:zhttps://i.scdn.co/image/r)r&r~album_image_ids r'album_cover_urlzSpotify.album_cover_urlsKl&&}b99 rr?j ( (2$QRR)N::r)c|jS)zA:class:`str`: The track ID used by Spotify to identify this song.)rr4s r'rzSpotify.track_idrr)cd|jS)zY:class:`str`: The track URL to listen on Spotify. .. versionadded:: 2.0 zhttps://open.spotify.com/track/)rr4s r' track_urlzSpotify.track_urls A@@@r)datetime.datetimec~tj|jddz tjjS)zK:class:`datetime.datetime`: When the user started playing this song in UTC.rtr,r-r0r1rr2r3r4s r'rtz Spotify.starts4 ..t/?/H4/OT\TeTi.jjjr)c~tj|jddz tjjS)zM:class:`datetime.datetime`: When the user will stop playing this song in UTC.r{r,r-rr4s r'r{z Spotify.ends4 ..t/?/F/MRZRcRg.hhhr)datetime.timedeltac |j|jz S)zC:class:`datetime.timedelta`: The duration of the song being played.)r{rtr4s r'durationzSpotify.durationsx$*$$r)c8|jddS)z2:class:`str`: The party ID of the listening party.idr)rrr4s r'party_idzSpotify.party_ids{tR(((r)N)rrr!r"rr<)r!rrrrr)r!r)r!r)r!r)r=r>r?r@rAr(rBrNr$rrr:rOrrrrrirrrrrrrrtr{rrrCr)r'rrKs,uIIIII&&&X&fffXf   X X     X    &&&&&&&&ccccX'''X'X222X2;;;X;XAAAXAkkkXk iiiXi %%%X%)))X)))r)rcveZdZdZdZdddfd ZeddZddZddZ ddZ d dZ d!dZ d!dZ xZS)"rabRepresents a custom activity from Discord. .. container:: operations .. describe:: x == y Checks if two activities are equal. .. describe:: x != y Checks if two activities are not equal. .. describe:: hash(x) Returns the activity's hash. .. describe:: str(x) Returns the custom status text. .. versionadded:: 1.3 Attributes ----------- name: Optional[:class:`str`] The custom activity's name. emoji: Optional[:class:`PartialEmoji`] The emoji to pass to the activity, if any. )rOrRrEN)rRrOr|rR2Optional[Union[PartialEmoji, Dict[str, Any], str]]rrr!r"c tjdi|||_|d||_|jdkr |j|_|| ||_dSt |trtj ||_dSt |trt||_dSt |tr ||_dStdt|d)NrE Custom Status)rOz.Expected str, PartialEmoji, or None, received z instead.rC) rYr(rOr%rErRrZrmrr[r^ TypeErrorrN)r&rOrRrr]s r'r(zCustomActivity.__init__s !!5!!!#' $)IIgt$<$< 9 ' ' DI * =DJJJ t $ $ g%/66DJJJ s # # g%5111DJJJ | , , gDJJJeTRW[[eeeff fr)r ctjS)z:class:`ActivityType`: Returns the activity's type. This is for compatibility with :class:`Activity`. It always returns :attr:`ActivityType.custom`. )r customr4s r'rNzCustomActivity.type.s ""r)rjc|j|jkrtjj|jdd}ntjj|jd}|jr|j|d<|S)Nr)rNrErO)rNrOrR)rOrEr r rprRr:)r&os r'r:zCustomActivity.to_dict6st 9 " "$+1'AA%+1 A : .++--AgJr)rrrclt|to|j|jko|j|jkSr8)rZrrOrRrs r'rzCustomActivity.__eq__Gs2%00jUZ495LjQVQ\`d`jQjjr)c.|| Sr8rrs r'rzCustomActivity.__ne__Jrr)rocRt|jt|jfSr8)rrOr^rRr4s r'rzCustomActivity.__hash__MsTYDJ0111r)r^c|jr,|jr|jd|jSt|jSt|jS)Nr`)rRrOr^r4s r'rzCustomActivity.__str__PsJ : "y 3*22ty222tz?? "ty>> !r)c(d|jd|jdS)Nzr?r@rAr(rBrNr:rrrrrirrs@r'rrs <+Icggggggggg*###X#"kkkk&&&&2222""""KKKKKKKKr)rrr6rErr! ActivityTypescdSr8rCrrEs r'create_activityr_sUXUXr)r"cdSr8rCrs r'rrcsADr)Optional[ActivityPayload]Optional[ActivityTypes]cV|sdStt|dd}|tjur d|vsd|vr t di|St di|S|tjurA |d}tdd|i|}nt#t$rt di|}Yn\wxYw|tj urd|vr tdi|St di|S|tj urd|vrd|vr tdi|St di|}t|jt r ||j_|S) NrNrXrQrMrOrPrLrC)rr rrrrr r%rrvrrrrrZrRrr)rrE game_typerOrqs r'rrgs ttxx';';<r$s0#"""""LLLLLLLLLLLLLLLLLL<<<<<<<<<<''''''$$$$$$ ,\''&&&&&""""""""""""""""J[3[3[3[3[3|[3[3[3|uuuuu<uuupggggg gggTj)j)j)j)j)j)j)j)ZaKaKaKaKaK\aKaKaKHhniHI  XXX X DDD Dr)