Implement role icons

discord/guild.py

@@ -207,6 +207,7 @@ class Guild(Hashable):
         - ``PARTNERED``: Guild is a partnered server.
         - ``PREVIEW_ENABLED``: Guild can be viewed before being accepted via Membership Screening.
         - ``PRIVATE_THREADS``: Guild has access to create private threads.
+        - ``ROLE_ICONS``: Guild has access to set icon for roles.
         - ``SEVEN_DAY_THREAD_ARCHIVE``: Guild has access to the seven day archive time for threads.
         - ``THREE_DAY_THREAD_ARCHIVE``: Guild has access to the three day archive time for threads.
         - ``TICKETED_EVENTS_ENABLED``: Guild has enabled ticketed events.
@@ -2397,6 +2398,7 @@ async def create_role(
         name: str = ...,
         permissions: Permissions = ...,
         colour: Union[Colour, int] = ...,
+        icon: Optional[bytes] = ...,
         hoist: bool = ...,
         mentionable: bool = ...,
     ) -> Role:
@@ -2410,6 +2412,7 @@ async def create_role(
         name: str = ...,
         permissions: Permissions = ...,
         color: Union[Colour, int] = ...,
+        icon: Optional[bytes] = ...,
         hoist: bool = ...,
         mentionable: bool = ...,
     ) -> Role:
@@ -2422,6 +2425,7 @@ async def create_role(
         permissions: Permissions = MISSING,
         color: Union[Colour, int] = MISSING,
         colour: Union[Colour, int] = MISSING,
+        icon: Optional[bytes] = MISSING,
         hoist: bool = MISSING,
         mentionable: bool = MISSING,
         reason: Optional[str] = None,
@@ -2438,6 +2442,9 @@ async def create_role(
         .. versionchanged:: 1.6
             Can now pass ``int`` to ``colour`` keyword-only parameter.
 
+        .. versionchanged:: 2.0
+            Added ``icon`` parameter.
+
         Parameters
         -----------
         name: :class:`str`
@@ -2447,6 +2454,8 @@ async def create_role(
         colour: Union[:class:`Colour`, :class:`int`]
             The colour for the role. Defaults to :meth:`Colour.default`.
             This is aliased to ``color`` as well.
+        icon: Optional[:class:`bytes`]
+            The raw bytes for the role icon.
         hoist: :class:`bool`
             Indicates if the role should be shown separately in the member list.
             Defaults to ``False``.
@@ -2482,6 +2491,12 @@ async def create_role(
         else:
             fields["color"] = actual_colour.value
 
+        if icon is not MISSING:
+            if icon is None:
+                fields["icon"] = icon
+            else:
+                fields["icon"] = utils._bytes_to_base64_data(icon)
+
         if hoist is not MISSING:
             fields["hoist"] = hoist
 

discord/message.py

@@ -153,7 +153,7 @@ class Attachment(Hashable):
         .. versionadded:: 2.0
     """
 
-    __slots__ = ("id", "size", "height", "width", "filename", "url", "proxy_url", "_http", "content_type")
+    __slots__ = ("id", "size", "height", "width", "filename", "url", "proxy_url", "_http", "content_type", "ephemeral")
 
     def __init__(self, *, data: AttachmentPayload, state: ConnectionState):
         self.id: int = int(data["id"])

discord/role.py

@@ -26,11 +26,12 @@
 
 from typing import TYPE_CHECKING, Any, Dict, List, Optional, TypeVar, Union
 
+from .asset import Asset
 from .colour import Colour
 from .errors import InvalidArgument
 from .mixins import Hashable
 from .permissions import Permissions
-from .utils import MISSING, _get_as_snowflake, snowflake_time
+from .utils import MISSING, _bytes_to_base64_data, _get_as_snowflake, snowflake_time
 
 __all__ = (
     "RoleTags",
@@ -176,6 +177,7 @@ class Role(Hashable):
         "id",
         "name",
         "_permissions",
+        "_icon",
         "_colour",
         "position",
         "managed",
@@ -242,6 +244,7 @@ def _update(self, data: RolePayload):
         self.hoist: bool = data.get("hoist", False)
         self.managed: bool = data.get("managed", False)
         self.mentionable: bool = data.get("mentionable", False)
+        self._icon: str = data.get("icon", None)
         self.tags: Optional[RoleTags]
 
         try:
@@ -317,6 +320,20 @@ def members(self) -> List[Member]:
         role_id = self.id
         return [member for member in all_members if member._roles.has(role_id)]
 
+    @property
+    def icon(self) -> Optional[Asset]:
+        """Optional[:class:`Asset`]: Returns the icon asset associated with this role, can be ``None``.
+
+        .. versionadded: 2.0
+
+        .. note::
+
+            The guild needs to have the ``ROLE_ICONS`` features to have this enabled.
+        """
+        if not self._icon:
+            return None
+        return Asset._from_icon(self._state, self.id, self._icon, "role")
+
     async def _move(self, position: int, reason: Optional[str]) -> None:
         if position <= 0:
             raise InvalidArgument("Cannot move role to position 0 or below")
@@ -347,6 +364,7 @@ async def edit(
         permissions: Permissions = MISSING,
         colour: Union[Colour, int] = MISSING,
         color: Union[Colour, int] = MISSING,
+        icon: Optional[bytes] = MISSING,
         hoist: bool = MISSING,
         mentionable: bool = MISSING,
         position: int = MISSING,
@@ -366,6 +384,7 @@ async def edit(
 
         .. versionchanged:: 2.0
             Edits are no longer in-place, the newly edited role is returned instead.
+            Also added a new ``icon`` parameter to change role icons.
 
         Parameters
         -----------
@@ -375,6 +394,8 @@ async def edit(
             The new permissions to change to.
         colour: Union[:class:`Colour`, :class:`int`]
             The new colour to change to. (aliased to color as well)
+        icon: :class:`bytes`
+            A bytes object representing the role icon.
         hoist: :class:`bool`
             Indicates if the role should be shown separately in the member list.
         mentionable: :class:`bool`
@@ -419,6 +440,12 @@ async def edit(
         if permissions is not MISSING:
             payload["permissions"] = permissions.value
 
+        if icon is not MISSING:
+            if icon is None:
+                payload["icon"] = icon
+            else:
+                payload["icon"] = _bytes_to_base64_data(icon)
+
         if hoist is not MISSING:
             payload["hoist"] = hoist
 

discord/types/guild.py

@@ -91,6 +91,7 @@ class _GuildOptional(TypedDict, total=False):
     "PARTNERED",
     "PREVIEW_ENABLED",
     "PRIVATE_THREADS",
+    "ROLE_ICONS",
     "SEVEN_DAY_THREAD_ARCHIVE",
     "THREE_DAY_THREAD_ARCHIVE",
     "TICKETED_EVENTS_ENABLED",

discord/types/message.py

@@ -55,6 +55,7 @@ class _AttachmentOptional(TypedDict, total=False):
     width: Optional[int]
     content_type: str
     spoiler: bool
+    ephemeral: bool
 
 
 class Attachment(_AttachmentOptional):

discord/types/role.py

@@ -31,6 +31,7 @@
 
 class _RoleOptional(TypedDict, total=False):
     tags: RoleTags
+    icon: str
 
 
 class Role(_RoleOptional):