feat: implement avatar decorations

changelog/889.feature.rst

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

disnake/asset.py

@@ -306,6 +306,16 @@ def _from_guild_scheduled_event_image(cls, state, event_id: int, image_hash: str
             animated=False,
         )
 
+    @classmethod
+    def _from_avatar_decoration(cls, state, user_id: int, avatar_decoration: str) -> Asset:
+        animated = avatar_decoration.startswith("a_")
+        return cls(
+            state,
+            url=f"{cls.BASE}/avatar-decorations/{user_id}/{avatar_decoration}.png?size=1024",
+            key=avatar_decoration,
+            animated=animated,
+        )
+
     def __str__(self) -> str:
         return self._url
 

disnake/member.py

@@ -288,6 +288,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__(

disnake/types/user.py

@@ -19,9 +19,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: Optional[str]

disnake/user.py

@@ -42,11 +42,12 @@ class BaseUser(_UserTag):
         "name",
         "id",
         "discriminator",
+        "bot",
+        "system",
         "_avatar",
         "_banner",
+        "_avatar_decoration",
         "_accent_colour",
-        "bot",
-        "system",
         "_public_flags",
         "_state",
     )
@@ -60,7 +61,8 @@ class BaseUser(_UserTag):
         _state: ConnectionState
         _avatar: Optional[str]
         _banner: Optional[str]
-        _accent_colour: Optional[str]
+        _avatar_decoration: Optional[str]
+        _accent_colour: Optional[int]
         _public_flags: int
 
     def __init__(
@@ -93,6 +95,7 @@ def _update(self, data: Union[UserPayload, PartialUserPayload]) -> None:
         self.discriminator = data["discriminator"]
         self._avatar = data["avatar"]
         self._banner = data.get("banner", None)
+        self._avatar_decoration = data.get("avatar_decoration", None)
         self._accent_colour = data.get("accent_color", None)
         self._public_flags = data.get("public_flags", 0)
         self.bot = data.get("bot", False)
@@ -107,6 +110,7 @@ def _copy(cls, user: BaseUser) -> Self:
         self.discriminator = user.discriminator
         self._avatar = user._avatar
         self._banner = user._banner
+        self._avatar_decoration = user._avatar_decoration
         self._accent_colour = user._accent_colour
         self.bot = user.bot
         self._state = user._state
@@ -162,12 +166,27 @@ 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.8
+
+        .. note::
+
+            This information is only available via :meth:`Client.fetch_user`.
+        """
+        if self._avatar_decoration is None:
+            return None
+        return Asset._from_avatar_decoration(self._state, self.id, self._avatar_decoration)
+
     @property
     def accent_colour(self) -> Optional[Colour]:
         """Optional[:class:`Colour`]: Returns the user's accent colour, if applicable.