Add the rest of the new role icons implementation (#9)

Related #4

Author: noaione

discord/audit_logs.py

@@ -118,6 +118,9 @@ def _transform_overwrites(
 def _transform_icon(entry: AuditLogEntry, data: Optional[str]) -> Optional[Asset]:
     if data is None:
         return None
+    # Check if role got changed, instead of guild icon.
+    if entry.action.name.startswith("role"):
+        return Asset._from_icon(entry._state, entry.id, data, "role")
     return Asset._from_guild_icon(entry._state, entry.guild.id, data)
 
 

discord/guild.py

@@ -2399,6 +2399,7 @@ async def create_role(
         permissions: Permissions = ...,
         colour: Union[Colour, int] = ...,
         icon: Optional[bytes] = ...,
+        emoji_unicode: Optional[str] = ...,
         hoist: bool = ...,
         mentionable: bool = ...,
     ) -> Role:
@@ -2413,6 +2414,7 @@ async def create_role(
         permissions: Permissions = ...,
         color: Union[Colour, int] = ...,
         icon: Optional[bytes] = ...,
+        emoji_unicode: Optional[str] = ...,
         hoist: bool = ...,
         mentionable: bool = ...,
     ) -> Role:
@@ -2426,6 +2428,7 @@ async def create_role(
         color: Union[Colour, int] = MISSING,
         colour: Union[Colour, int] = MISSING,
         icon: Optional[bytes] = MISSING,
+        emoji_unicode: Optional[str] = MISSING,
         hoist: bool = MISSING,
         mentionable: bool = MISSING,
         reason: Optional[str] = None,
@@ -2443,7 +2446,7 @@ async def create_role(
             Can now pass ``int`` to ``colour`` keyword-only parameter.
 
         .. versionchanged:: 2.0
-            Added ``icon`` parameter.
+            Added ``icon`` and ``emoji_unicode`` parameter.
 
         Parameters
         -----------
@@ -2455,7 +2458,14 @@ async def create_role(
             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.
+            A bytes object representing the role icon.
+
+            .. versionadded:: 2.0
+
+        emoji_unicode: Optional[:class:`str`]
+            The unicode value of the new role to change to.
+
+            .. versionadded:: 2.0
         hoist: :class:`bool`
             Indicates if the role should be shown separately in the member list.
             Defaults to ``False``.
@@ -2506,6 +2516,9 @@ async def create_role(
         if name is not MISSING:
             fields["name"] = name
 
+        if emoji_unicode is not MISSING:
+            fields["unicode_emoji"] = emoji_unicode
+
         data = await self._state.http.create_role(self.id, reason=reason, **fields)
         role = Role(guild=self, data=data, state=self._state)
 

discord/role.py

@@ -30,6 +30,7 @@
 from .colour import Colour
 from .errors import InvalidArgument
 from .mixins import Hashable
+from .partial_emoji import PartialEmoji
 from .permissions import Permissions
 from .utils import MISSING, _bytes_to_base64_data, _get_as_snowflake, snowflake_time
 
@@ -245,6 +246,7 @@ def _update(self, data: RolePayload):
         self.managed: bool = data.get("managed", False)
         self.mentionable: bool = data.get("mentionable", False)
         self._icon: str = data.get("icon", None)
+        self._emoji_unicode: str = data.get("unicode_emoji", None)
         self.tags: Optional[RoleTags]
 
         try:
@@ -324,7 +326,7 @@ def members(self) -> List[Member]:
     def icon(self) -> Optional[Asset]:
         """Optional[:class:`Asset`]: Returns the icon asset associated with this role, can be ``None``.
 
-        .. versionadded: 2.0
+        .. versionadded:: 2.0
 
         .. note::
 
@@ -334,6 +336,21 @@ def icon(self) -> Optional[Asset]:
             return None
         return Asset._from_icon(self._state, self.id, self._icon, "role")
 
+    @property
+    def emoji(self) -> Optional[PartialEmoji]:
+        """Optional[:class:`PartialEmoji`]: Returns the emoji that 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._emoji_unicode:
+            return None
+        return PartialEmoji.from_str(self._emoji_unicode)
+
     async def _move(self, position: int, reason: Optional[str]) -> None:
         if position <= 0:
             raise InvalidArgument("Cannot move role to position 0 or below")
@@ -365,6 +382,7 @@ async def edit(
         colour: Union[Colour, int] = MISSING,
         color: Union[Colour, int] = MISSING,
         icon: Optional[bytes] = MISSING,
+        emoji_unicode: Optional[str] = MISSING,
         hoist: bool = MISSING,
         mentionable: bool = MISSING,
         position: int = MISSING,
@@ -384,7 +402,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.
+            Also added a new ``icon`` and ``emoji_unicode`` parameter to change role icons.
 
         Parameters
         -----------
@@ -396,6 +414,13 @@ async def edit(
             The new colour to change to. (aliased to color as well)
         icon: :class:`bytes`
             A bytes object representing the role icon.
+
+            .. versionadded:: 2.0
+
+        emoji_unicode: :class:`str`
+            The unicode value of the new role to change to.
+
+            .. versionadded:: 2.0
         hoist: :class:`bool`
             Indicates if the role should be shown separately in the member list.
         mentionable: :class:`bool`
@@ -446,6 +471,9 @@ async def edit(
             else:
                 payload["icon"] = _bytes_to_base64_data(icon)
 
+        if emoji_unicode is not MISSING:
+            payload["unicode_emoji"] = emoji_unicode
+
         if hoist is not MISSING:
             payload["hoist"] = hoist
 

discord/types/role.py

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

docs/api.rst

@@ -2101,13 +2101,18 @@ of :class:`enum.Enum`.
         When this is the action, the type of :attr:`~AuditLogEntry.target` is
         the :class:`Role` or a :class:`Object` with the ID.
 
+        .. versionchanged:: 2.0
+            Added :attr:`~AuditLogDiff.icon` and :attr:`~AuditLogDiff.unicode_emoji`.
+
         Possible attributes for :class:`AuditLogDiff`:
 
         - :attr:`~AuditLogDiff.colour`
         - :attr:`~AuditLogDiff.mentionable`
         - :attr:`~AuditLogDiff.hoist`
         - :attr:`~AuditLogDiff.name`
         - :attr:`~AuditLogDiff.permissions`
+        - :attr:`~AuditLogDiff.icon`
+        - :attr:`~AuditLogDiff.unicode_emoji`
 
     .. attribute:: role_update
 
@@ -2121,13 +2126,18 @@ of :class:`enum.Enum`.
         When this is the action, the type of :attr:`~AuditLogEntry.target` is
         the :class:`Role` or a :class:`Object` with the ID.
 
+        .. versionchanged:: 2.0
+            Added :attr:`~AuditLogDiff.icon` and :attr:`~AuditLogDiff.unicode_emoji`.
+
         Possible attributes for :class:`AuditLogDiff`:
 
         - :attr:`~AuditLogDiff.colour`
         - :attr:`~AuditLogDiff.mentionable`
         - :attr:`~AuditLogDiff.hoist`
         - :attr:`~AuditLogDiff.name`
         - :attr:`~AuditLogDiff.permissions`
+        - :attr:`~AuditLogDiff.icon`
+        - :attr:`~AuditLogDiff.unicode_emoji`
 
     .. attribute:: role_delete
 
@@ -2136,13 +2146,18 @@ of :class:`enum.Enum`.
         When this is the action, the type of :attr:`~AuditLogEntry.target` is
         the :class:`Role` or a :class:`Object` with the ID.
 
+        .. versionchanged:: 2.0
+            Added :attr:`~AuditLogDiff.icon` and :attr:`~AuditLogDiff.unicode_emoji`.
+
         Possible attributes for :class:`AuditLogDiff`:
 
         - :attr:`~AuditLogDiff.colour`
         - :attr:`~AuditLogDiff.mentionable`
         - :attr:`~AuditLogDiff.hoist`
         - :attr:`~AuditLogDiff.name`
         - :attr:`~AuditLogDiff.permissions`
+        - :attr:`~AuditLogDiff.icon`
+        - :attr:`~AuditLogDiff.unicode_emoji`
 
     .. attribute:: invite_create
 
@@ -2940,7 +2955,9 @@ AuditLogDiff
 
     .. attribute:: icon
 
-        A guild's icon. See also :attr:`Guild.icon`.
+        Depending on the action type, this may be a guild's icon or a role's icon.
+
+        See also :attr:`Guild.icon` or :attr:`Role.icon`.
 
         :type: :class:`Asset`
 
@@ -3360,6 +3377,12 @@ AuditLogDiff
 
         :type: :class:`int`
 
+    .. attribute:: unicode_emoji
+
+        The unicode emoji that represents when role got changed.
+
+        :type: :class:`str`
+
 .. this is currently missing the following keys: reason and application_id
    I'm not sure how to about porting these