cjhTdZddlmZddlmZmZmZddlZddl m Z ddl m Z ddl mZdd lmZdd lmZdd lmZmZmZer8dd lmZdd lmZmZddlmZddlmZddlm Z ddl!m"Z"ddl#mZ$ddl%m&Z'ddl%m(Z)dZ*eddZ+GddZ,Gdde,Z-Gdde-Z.Gdde-ej0j^Z(y)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. ) annotations) TYPE_CHECKINGAnyTypeVarN)Asset)Colour)PublicUserFlags)EntitlementIterator) Entitlement)MISSING_bytes_to_base64_datasnowflake_time)datetime) Snowflake SnowflakeTime) DMChannel)Guild)Message)ConnectionState) PartialUser)User)r ClientUserBUBaseUser)boundceZdZUdZded<y)_UserTagintidN)__name__ __module__ __qualname__ __slots____annotations__r?/var/www/html/venv/lib/python3.12/site-packages/discord/user.pyrr<s I Gr'rceZdZUdZer name= discriminator=) is_migratedr,r!r*r0r1r+r<s r(__repr__zBaseUser.__repr__es   +77):dii]-HXHXG[DHH:Xdkk]!= wwiz$))z$++a9   77)6$))od>P>P=SDHH:Xdkk]! 5 r'c|js|jd|jS|j|jd|jdS|jS)N#z ())rGr*r+r,rHs r(__str__zBaseUser.__str__xsk##yyk4--. / ##/99+R 0 013  YY  r'cXt|txr|j|jk(Sr:) isinstancerr!)r<others r(__eq__zBaseUser.__eq__s!%*Buxx477/BBr'c |jdz S)Nr!rHs r(__hash__zBaseUser.__hash__sww"}r'c|d|_t|d|_|d|_|j ddxsd|_|d|_|j dd|_|j dd|_|j dd|_ |j d d |_ |j d d |_ |j d d |_ y)Nusernamer!r+r,avatarbanner accent_coloravatar_decoration_data public_flagsrr0Fr1) r*r r!r+getr,r-r.r/r3r2r0r1)r<r>s r(r;zBaseUser._updates$ d4j/!/288M48@DH~ xx$/ "hh~t<"&((+CT"J!XXna888E5)hhx/ r'c|j|}|j|_|j|_|j|_|j|_|j |_|j |_|j|_|j|_|j|_ |j|_ |j|_ |Sr:) __new__r*r!r+r,r-r.r/r3r0r4r2)clsuserr<s r(_copyzBaseUser._copys{{3II ''!//++|| || "11"&"9"988kk !// r'c|j|j|j|j|j|j dS)N)rWr!rXr+r,r0)r*r!r-r+r,r0rHs r(_to_minimal_user_jsonzBaseUser._to_minimal_user_jsons: ''ll!//++88   r'c d|jS)zaReturns a URL that allows the client to jump to the user. .. versionadded:: 2.0 zhttps://discord.com/users/rTrHs r(jump_urlzBaseUser.jump_urls ,DGG955r'c@tj|jS)z*The publicly available flags the user has.)r _from_valuer2rHs r(r\zBaseUser.public_flagss**4+=+=>>r'c|j5tj|j|j|jSy)zReturns an :class:`Asset` for the avatar the user has. If the user does not have a traditional avatar, ``None`` is returned. If you want the avatar that a user has displayed, consider :attr:`display_avatar`. N)r-r _from_avatarr4r!rHs r(rXzBaseUser.avatars2 << #%%dkk477DLLI Ir'c|jr|jdz nt|j}|jrdnd}t j |j ||zS)zReturns the default avatar for a given user. This is calculated by the user's ID if they're on the new username system, otherwise their discriminator. rS)rGr!r r+r_from_default_avatarr4)r<eqpercs r(default_avatarzBaseUser.default_avatarsP !% 0 0dggmc$:L:L6M$$q!))$++rDyAAr'c6|jxs |jS)zReturns the user's display avatar. For regular users this is just their default avatar or uploaded avatar. .. versionadded:: 2.0 )rXrqrHs r(display_avatarzBaseUser.display_avatars{{1d111r'c|jytj|j|j|jS)zReturns the user's banner asset, if available. .. versionadded:: 2.0 .. note:: This information is only available via :meth:`Client.fetch_user`. N)r.r_from_user_bannerr4r!rHs r(rYzBaseUser.banners2 << &&t{{DGGT\\JJr'c|jytj|j|j|jj dS)z[Returns the user's avatar decoration, if available. .. versionadded:: 2.5 Nasset)r3r_from_avatar_decorationr4r!r]rHs r(avatar_decorationzBaseUser.avatar_decorationsF  " " *,, KK$"9"9"="=g"F  r'cF|jyt|jS)zReturns the user's accent colour, if applicable. There is an alias for this named :attr:`accent_color`. .. versionadded:: 2.0 .. note:: This information is only available via :meth:`Client.fetch_user`. N)r/r rHs r( accent_colourzBaseUser.accent_colours$    &d))**r'c|jS)zReturns the user's accent color, if applicable. There is an alias for this named :attr:`accent_colour`. .. versionadded:: 2.0 .. note:: This information is only available via :meth:`Client.fetch_user`. )r{rHs r(rZzBaseUser.accent_colors!!!r'c*tjS)zA property that returns a colour denoting the rendered colour for the user. This always returns :meth:`Colour.default`. There is an alias for this named :attr:`color`. )r defaultrHs r(colourzBaseUser.colours~~r'c|jS)zA property that returns a color denoting the rendered color for the user. This always returns :meth:`Colour.default`. There is an alias for this named :attr:`colour`. )rrHs r(colorzBaseUser.colors{{r'c"d|jdS)z;Returns a string that allows you to mention the given user.z<@rDrTrHs r(mentionzBaseUser.mention&sDGG9Ar'c,t|jS)zoReturns the user's creation time in UTC. This is when the user's Discord account was created. )rr!rHs r( created_atzBaseUser.created_at+s dgg&&r'c6|jxs |jS)zrReturns the user's display name. This will be their global name if set, otherwise their username. )r,r*rHs r( display_namezBaseUser.display_name3s ,499,r'cZ|jrytfd|jDS)a:Checks if the user is mentioned in the specified message. Parameters ---------- message: :class:`Message` The message to check if you're mentioned in. Returns ------- :class:`bool` Indicates if the user is mentioned in the message. Tc3PK|]}|jjk(ywr:rT).0rar<s r( z(BaseUser.mentioned_in..KsC$477dgg%Cs#&)mention_everyoneanymentions)r<messages` r( mentioned_inzBaseUser.mentioned_in:s(  # #C'2B2BCCCr'c |jdk(S)z;Checks whether the user is already migrated to global name.0)r+rHs r(rGzBaseUser.is_migratedMs!!S((r'N)r=rr>z UserPayload | PartialUserPayloadreturnNonerr5)rPrrr7)rr r> UserPayloadrr)r`ztype[BU]rarrr)rzdict[str, Any])rr )rz Asset | None)rr)rz Colour | None)rr )rr)rrrr7)rr7) r"r#r$r%rr&r?rIrMrQrUr; classmethodrbrdpropertyrfr\rXrqrsrYryr{rZrrrrrrrGrr'r(rrAs I    ""'''/O   &  C 0" 66??BB22 K K     + + " "  ''-- D&))r'ceZdZUdZdZerded<ded<ded<ded <dfd Zdd Zdfd Z e e e d  ddZ xZ S)ra5Represents your Discord user. .. container:: operations .. describe:: x == y Checks if two users are equal. .. describe:: x != y Checks if two users are not equal. .. describe:: hash(x) Return the user's hash. .. describe:: str(x) Returns the user's name with discriminator or global_name. Attributes ---------- name: :class:`str` The user's username. id: :class:`int` The user's unique ID. discriminator: :class:`str` The user's discriminator. This is given when the username has conflicts. .. note:: If the user has migrated to the new username system, this will always be 0. global_name: :class:`str` The user's global name. .. versionadded:: 2.5 bot: :class:`bool` Specifies if the user is a bot account. system: :class:`bool` Specifies if the user is a system user (i.e. represents Discord officially). .. versionadded:: 1.3 verified: :class:`bool` Specifies if the user's email is verified. locale: Optional[:class:`str`] The IETF language tag used to identify the language the user is using. mfa_enabled: :class:`bool` Specifies if the user has MFA turned on and working. )locale_flagsverified mfa_enabled __weakref__r7rr6rrr rc(t|||y)Nr=r>)superr?r<r=r> __class__s r(r?zClientUser.__init__s u40r'c |jr|jQd|jd|jd|jd|jd|j d|j d Sd|jd|jd|jd|j d|j d Sd|jd|jd |jd|jd|j d|j d S) NzP>P=SDHH:Z mDDTDTCUUV X r'ct|||jdd|_|jd|_|jdd|_|jdd|_y)NrFrflagsrr)rr;r]rrrr)r<r>rs r(r;zClientUser._updatesV U3 hhx( hhw* 88M59r')rWrXrYc,Ki}|tur||d<|d|d<n|turt||d<|d|d<n|turt||d<|jjj |d{}t |j|S7w)a|coro| Edits the current profile of the client. .. note:: To upload an avatar or banner, a :term:`py:bytes-like object` must be passed in that represents the image being uploaded. If this is done through a file then the file must be opened via ``open('some_filename', 'rb')`` and the :term:`py:bytes-like object` is given through the use of ``fp.read()``. The only image formats supported for uploading are JPEG, PNG, and GIF. .. versionchanged:: 2.0 The edit is no longer in-place, instead the newly edited client user is returned. .. versionchanged:: 2.6 The ``banner`` keyword-only parameter was added. Parameters ---------- username: :class:`str` The new username you wish to change to. avatar: :class:`bytes` A :term:`py:bytes-like object` representing the image to upload. Could be ``None`` to denote no avatar. banner: :class:`bytes` A :term:`py:bytes-like object` representing the image to upload. Could be ``None`` to denote no banner. Returns ------- :class:`ClientUser` The newly edited client user. Raises ------ HTTPException Editing your profile failed. InvalidArgument Wrong image format passed for ``avatar`` or ``banner``. rWNrXrYr)r rr4http edit_profiler)r<rWrXrYpayloadr>s r(editzClientUser.editsb#% 7 ""*GJ  > $GH  7 " 5f =GH  > $GH  7 " 5f =GH "&++"2"2"?"?"HH $77IsA4B6B7Br=rr>rrrrr)rWr5rXbytesrYrrr) r"r#r$__doc__r%rr&r?rIr;r r __classcell__rs@r(rrSsv0dOI 1 &:  @8@8 @8  @8  @8r'rceZdZdZdZd fd ZddZddZedfd Z ddZ e ddZ e dd Z dd Zdd Z d dd ZxZS)raRepresents a Discord user. .. container:: operations .. describe:: x == y Checks if two users are equal. .. describe:: x != y Checks if two users are not equal. .. describe:: hash(x) Return the user's hash. .. describe:: str(x) Returns the user's name with discriminator or global_name. Attributes ---------- name: :class:`str` The user's username. id: :class:`int` The user's unique ID. discriminator: :class:`str` The user's discriminator. This is given when the username has conflicts. .. note:: If the user has migrated to the new username system, this will always be "0". global_name: :class:`str` The user's global name. .. versionadded:: 2.5 bot: :class:`bool` Specifies if the user is a bot account. system: :class:`bool` Specifies if the user is a system user (i.e. represents Discord officially). )_storedc6t|||d|_y)NrF)rr?rrs r(r?z User.__init__s u40" r'c b|jrm|j7d|jd|jd|jd|jd Sd|jd|jd|jdSd|jd|jd|j d|jd S)Nz P>P=SSXY]YaYaXbbc e r'c |jr&|jj|jyy#t$rYywxYwr:)rr4 deref_userr! ExceptionrHs r(__del__z User.__del__.s; || &&tww/   s15 AAc4t||}d|_|S)NF)rrbr)r`rar<rs r(rbz User._copy5sw}T"  r'cBK|jd{}|S7wr:) create_dm)r<chs r( _get_channelzUser._get_channel;s>># # $s cL|jj|jS)zReturns the channel associated with this user if it exists. If this returns ``None``, you can create a DM channel by calling the :meth:`create_dm` coroutine function. )r4_get_private_channel_by_userr!rHs r( dm_channelzUser.dm_channel?s{{77@@r'c|jjjDcgc] }|j|js|"c}Scc}w)zThe guilds that the user shares with the client. .. note:: This will only return mutual guilds within the client's internal cache. .. versionadded:: 1.7 )r4_guildsvalues get_memberr!)r<guilds r( mutual_guildszUser.mutual_guildsHsH ${{2299; u?O?OPTPWPW?XE   s AAcK|j}||S|j}|jj|jd{}|j |S7w)a |coro| Creates a :class:`DMChannel` with this user. This should be rarely called, as this is done transparently for most people. Returns ------- :class:`.DMChannel` The channel that was created. N)rr4rstart_private_messager!add_dm_channel)r<foundr=r>s r(rzUser.create_dmVsW  L ',zz'G'G'P!P##D))"QsAAAAcK|j|jdd}|jjj|j|d{}t ||jS7w)a!|coro| Creates a test entitlement for the user. Parameters ---------- sku: :class:`Snowflake` The SKU to create a test entitlement for. Returns ------- :class:`Entitlement` The created entitlement. )sku_idowner_id owner_typeN)r>r=)r!r4rcreate_test_entitlementr )r<skurr>s r(rzUser.create_test_entitlementks\ ff  [[%%==dggwOODKK88PsAA.A,A.c t|j|r|Dcgc]}|jc}nd||||j|Scc}w)aReturns an :class:`.AsyncIterator` that enables fetching the user's entitlements. This is identical to :meth:`Client.entitlements` with the ``user`` parameter. .. versionadded:: 2.6 Parameters ---------- skus: list[:class:`.abc.Snowflake`] | None Limit the fetched entitlements to entitlements that are for these SKUs. before: :class:`.abc.Snowflake` | :class:`datetime.datetime` | None Retrieves guilds before this date or object. If a datetime is provided, it is recommended to use a UTC-aware datetime. If the datetime is naive, it is assumed to be local time. after: :class:`.abc.Snowflake` | :class:`datetime.datetime` | None Retrieve guilds after this date or object. If a datetime is provided, it is recommended to use a UTC-aware datetime. If the datetime is naive, it is assumed to be local time. limit: Optional[:class:`int`] The number of entitlements to retrieve. If ``None``, retrieves every entitlement, which may be slow. Defaults to ``100``. exclude_ended: :class:`bool` Whether to limit the fetched entitlements to those that have not ended. Defaults to ``False``. Yields ------ :class:`.Entitlement` The application's entitlements. Raises ------ :exc:`HTTPException` Retrieving the entitlements failed. N)sku_idsbeforeafterlimituser_id exclude_ended)r r4r!)r<skusrrrrrs r( entitlementszUser.entitlementssEX# KK04t,SVV,$GG'  ,sA rr)rr)rar)rr)rzDMChannel | None)rz list[Guild])rzdiscord.abc.Snowflakerr )NNNdF) rzlist[Snowflake] | NonerSnowflakeTime | Nonerrrr8rr7rr )r"r#r$rr%r?rIrrrbrrrrrrrrrs@r(rrs(TI#   AA    **92(,'+&*# 4 $4 %4 $ 4  4  4  4 r'r)0r __future__rtypingrrr discord.abcdiscordrwrrr rr iteratorsr monetizationr utilsr rrrabcrrchannelrrrrrr=r types.channelDMChannelPayload types.userrPartialUserPayloadrr__all__rrrr Messageablerr'r(rs2#.."*%AA!-" &<=/   T$  O)xO)dZ8Z8zF 8W[[,,F r'