feat: implement avatar decorations

changelog/889.feature.rst

@@ -0,0 +1 @@
+Add support for avatar decorations using :attr:`User.avatar_decoration` and :attr:`Member.avatar_decoration`.

disnake/asset.py

@@ -314,6 +314,18 @@ def _from_guild_scheduled_event_image(
             animated=False,
         )
 
+    @classmethod
+    def _from_avatar_decoration(
+        cls, state: AnyState, user_id: int, avatar_decoration_asset: str
+    ) -> Self:
+        animated = avatar_decoration_asset.startswith("a_")
+        return cls(
+            state,
+            url=f"{cls.BASE}/avatar-decorations/{user_id}/{avatar_decoration_asset}.png?size=1024",
+            key=avatar_decoration_asset,
+            animated=animated,
+        )
+
     def __str__(self) -> str:
         return self._url
 

disnake/member.py

@@ -293,6 +293,7 @@ class Member(disnake.abc.Messageable, _UserTag):
         banner: Optional[Asset]
         accent_color: Optional[Colour]
         accent_colour: Optional[Colour]
+        avatar_decoration: Optional[Asset]
 
     @overload
     def __init__(
@@ -452,18 +453,33 @@ def _presence_update(
 
     def _update_inner_user(self, user: UserPayload) -> Optional[Tuple[User, User]]:
         u = self._user
-        original = (u.name, u._avatar, u.discriminator, u.global_name, u._public_flags)
+        original = (
+            u.name,
+            u._avatar,
+            u.discriminator,
+            u.global_name,
+            u._public_flags,
+            u._avatar_decoration_data,
+        )
         # These keys seem to always be available
         modified = (
             user["username"],
             user["avatar"],
             user["discriminator"],
             user.get("global_name"),
             user.get("public_flags", 0),
+            user.get("avatar_decoration_data", None),
         )
         if original != modified:
             to_return = User._copy(self._user)
-            u.name, u._avatar, u.discriminator, u.global_name, u._public_flags = modified
+            (
+                u.name,
+                u._avatar,
+                u.discriminator,
+                u.global_name,
+                u._public_flags,
+                u._avatar_decoration_data,
+            ) = modified
             # Signal to dispatch on_user_update
             return to_return, u
 

disnake/types/user.py

@@ -7,6 +7,11 @@
 from .snowflake import Snowflake
 
 
+class AvatarDecorationData(TypedDict):
+    asset: str
+    sku_id: Snowflake
+
+
 class PartialUser(TypedDict):
     id: Snowflake
     username: str
@@ -22,9 +27,12 @@ class User(PartialUser, total=False):
     bot: bool
     system: bool
     mfa_enabled: bool
-    local: str
+    banner: Optional[str]
+    accent_color: Optional[int]
+    locale: str
     verified: bool
     email: Optional[str]
     flags: int
     premium_type: PremiumType
     public_flags: int
+    avatar_decoration_data: Optional[AvatarDecorationData]

disnake/user.py

@@ -23,7 +23,11 @@
     from .message import Message
     from .state import ConnectionState
     from .types.channel import DMChannel as DMChannelPayload
-    from .types.user import PartialUser as PartialUserPayload, User as UserPayload
+    from .types.user import (
+        AvatarDecorationData as AvatarDecorationDataPayload,
+        PartialUser as PartialUserPayload,
+        User as UserPayload,
+    )
 
 
 __all__ = (
@@ -43,11 +47,12 @@ class BaseUser(_UserTag):
         "id",
         "discriminator",
         "global_name",
+        "bot",
+        "system",
         "_avatar",
         "_banner",
+        "_avatar_decoration_data",
         "_accent_colour",
-        "bot",
-        "system",
         "_public_flags",
         "_state",
     )
@@ -62,7 +67,8 @@ class BaseUser(_UserTag):
         _state: ConnectionState
         _avatar: Optional[str]
         _banner: Optional[str]
-        _accent_colour: Optional[str]
+        _avatar_decoration_data: Optional[AvatarDecorationDataPayload]
+        _accent_colour: Optional[int]
         _public_flags: int
 
     def __init__(
@@ -100,6 +106,7 @@ def _update(self, data: Union[UserPayload, PartialUserPayload]) -> None:
         self.global_name = data.get("global_name")
         self._avatar = data["avatar"]
         self._banner = data.get("banner", None)
+        self._avatar_decoration_data = data.get("avatar_decoration_data", None)
         self._accent_colour = data.get("accent_color", None)
         self._public_flags = data.get("public_flags", 0)
         self.bot = data.get("bot", False)
@@ -115,6 +122,7 @@ def _copy(cls, user: BaseUser) -> Self:
         self.global_name = user.global_name
         self._avatar = user._avatar
         self._banner = user._banner
+        self._avatar_decoration_data = user._avatar_decoration_data
         self._accent_colour = user._accent_colour
         self.bot = user.bot
         self._state = user._state
@@ -131,6 +139,7 @@ def _to_minimal_user_json(self) -> UserPayload:
             "global_name": self.global_name,
             "bot": self.bot,
             "public_flags": self._public_flags,
+            "avatar_decoration_data": self._avatar_decoration_data,
         }
 
     @property
@@ -180,12 +189,35 @@ def banner(self) -> Optional[Asset]:
         .. versionadded:: 2.0
 
         .. note::
+
             This information is only available via :meth:`Client.fetch_user`.
         """
         if self._banner is None:
             return None
         return Asset._from_banner(self._state, self.id, self._banner)
 
+    @property
+    def avatar_decoration(self) -> Optional[Asset]:
+        """Optional[:class:`Asset`]: Returns the user's avatar decoration asset, if available.
+
+        .. versionadded:: 2.10
+
+        .. note::
+
+            Since Discord always sends an animated PNG for animated avatar decorations,
+            the following methods will not work as expected:
+
+            - :meth:`Asset.replace`
+            - :meth:`Asset.with_size`
+            - :meth:`Asset.with_format`
+            - :meth:`Asset.with_static_format`
+        """
+        if self._avatar_decoration_data is None:
+            return None
+        return Asset._from_avatar_decoration(
+            self._state, self.id, self._avatar_decoration_data["asset"]
+        )
+
     @property
     def accent_colour(self) -> Optional[Colour]:
         """Optional[:class:`Colour`]: Returns the user's accent colour, if applicable.

docs/api/widgets.rst

@@ -44,7 +44,7 @@ WidgetMember
 .. autoclass:: WidgetMember()
     :members:
     :inherited-members:
-    :exclude-members: global_name, public_flags, default_avatar, banner, accent_colour, accent_color, colour, color, mention, created_at, mentioned_in
+    :exclude-members: global_name, public_flags, default_avatar, banner, accent_colour, accent_color, colour, color, mention, created_at, mentioned_in, avatar_decoration
 
 Enumerations
 ------------