feat: allow editing for guild role icons (#1558)

* chore: Version bump

Signed-off-by: LordOfPolls <dev@lordofpolls.com>

* Implemented role icon edit

* added role icon editing to the edit method

* Update misc_utils.py

* ci: correct from checks.

* fixed formatting, added return formatting indicator

* Noticed that interactions.client.utils.serializer

already had the functions I added to misc_utils. Undid those changes and tidied up the code in role.py to reflect the already existing converter.  Added an error raise if both icon and unicode emojis are used in one edit (the api requires only one is provided.)

* Cleaned up the docstring and moved the icon serialization

cleaned up the docstring to better align with requirements, moved the icon serialization so the payload's code is a bit easier to follow at a glance.

* Added UPLOADABLE_TYPE per comment

---------

Signed-off-by: LordOfPolls <dev@lordofpolls.com>
Co-authored-by: Katelyn Gigante <clockwork.singularity@gmail.com>
Co-authored-by: LordOfPolls <dev@lordofpolls.com>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: 4 people

interactions/client/utils/misc_utils.py

@@ -2,12 +2,12 @@
 from typing import Any, TYPE_CHECKING
 
 import attrs
-
 from interactions.client.const import MISSING, T, Missing
 from interactions.client.utils import nulled_boolean_get
 from interactions.client.utils.attr_converters import optional as optional_c
-from interactions.client.utils.serializer import dict_filter
+from interactions.client.utils.serializer import dict_filter, to_image_data
 from interactions.models.discord.asset import Asset
+from interactions.models.discord.file import UPLOADABLE_TYPE
 from interactions.models.discord.color import COLOR_TYPES, Color, process_color
 from interactions.models.discord.emoji import PartialEmoji
 from interactions.models.discord.enums import Permissions
@@ -187,6 +187,8 @@ async def edit(
         color: Color | COLOR_TYPES | None = None,
         hoist: bool | None = None,
         mentionable: bool | None = None,
+        icon: bytes | UPLOADABLE_TYPE | None = None,
+        unicode_emoji: str | None = None,
     ) -> "Role":
         """
         Edit this role, all arguments are optional.
@@ -197,20 +199,29 @@ async def edit(
             color: The color of the role
             hoist: whether the role should be displayed separately in the sidebar
             mentionable: whether the role should be mentionable
+            icon: (Guild Level 2+) Bytes-like object representing the icon; supports PNG, JPEG and WebP
+            unicode_emoji: (Guild Level 2+) Unicode emoji for the role; can't be used with icon
 
         Returns:
             Role with updated information
 
         """
         color = process_color(color)
 
+        if icon and unicode_emoji:
+            raise ValueError("Cannot pass both icon and unicode_emoji")
+        if icon:
+            icon = to_image_data(icon)
+
         payload = dict_filter(
             {
                 "name": name,
                 "permissions": permissions,
                 "color": color,
                 "hoist": hoist,
                 "mentionable": mentionable,
+                "icon": icon,
+                "unicode_emoji": unicode_emoji,
             }
         )
 

interactions/models/discord/role.py

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "interactions.py"
-version = "5.9.2"
+version = "5.10.0"
 description = "Easy, simple, scalable and modular: a Python API wrapper for interactions."
 authors = [
     "LordOfPolls <dev@lordofpolls.com>",