Support GIF stickers

changes/1464.feature.md

@@ -0,0 +1 @@
+Support GIF sticker image format

hikari/api/rest.py

@@ -3945,7 +3945,7 @@ async def create_sticker(
             The tag for the sticker.
         image : hikari.files.Resourceish
             The 320x320 image for the sticker. Maximum upload size is 500kb.
-            This can be a still or an animated PNG or a Lottie.
+            This can be a still PNG, an animated PNG, a Lottie, or a GIF.
 
             .. note::
                 Lottie support is only available for verified and partnered

hikari/guilds.py

@@ -1907,7 +1907,7 @@ async def create_sticker(
             The tag for the sticker.
         image : hikari.files.Resourceish
             The 320x320 image for the sticker. Maximum upload size is 500kb.
-            This can be a still or an animated PNG or a Lottie.
+            This can be a still PNG, an animated PNG, a Lottie, or a GIF.
 
         Other Parameters
         ----------------

hikari/internal/routes.py

@@ -591,7 +591,7 @@ def compile_to_file(
 # undocumented on the Discord docs.
 CDN_CHANNEL_ICON: typing.Final[CDNRoute] = CDNRoute("/channel-icons/{channel_id}/{hash}", {PNG, *JPEG_JPG, WEBP})
 
-CDN_STICKER: typing.Final[CDNRoute] = CDNRoute("/stickers/{sticker_id}", {PNG, LOTTIE}, is_sizable=False)
+CDN_STICKER: typing.Final[CDNRoute] = CDNRoute("/stickers/{sticker_id}", {PNG, LOTTIE, GIF}, is_sizable=False)
 CDN_STICKER_PACK_BANNER: typing.Final[CDNRoute] = CDNRoute(
     "/app-assets/710982414301790216/store/{hash}", {PNG, *JPEG_JPG, WEBP}
 )

hikari/stickers.py

@@ -75,6 +75,9 @@ class StickerFormatType(int, enums.Enum):
     More information can be found here: <https://airbnb.io/lottie/>
     """
 
+    GIF = 4
+    """A GIF sticker."""
+
 
 @attr.define(hash=True, kw_only=True, weakref_slot=False)
 class StickerPack(snowflakes.Unique):

tests/hikari/impl/test_rest.py

@@ -3973,9 +3973,28 @@ async def test_fetch_guild_sticker(self, rest_client):
         rest_client._request.assert_awaited_once_with(expected_route)
         rest_client._entity_factory.deserialize_guild_sticker.assert_called_once_with({"id": "123"})
 
-    @pytest.mark.skip("TODO")
     async def test_create_sticker(self, rest_client):
-        ...
+        rest_client.create_sticker = mock.AsyncMock()
+        file = object()
+
+        sticker = await rest_client.create_sticker(
+            90210,
+            "NewSticker",
+            "funny",
+            file,
+            description="A sticker",
+            reason="blah blah blah",
+        )
+        assert sticker is rest_client.create_sticker.return_value
+
+        rest_client.create_sticker.assert_awaited_once_with(
+            90210,
+            "NewSticker",
+            "funny",
+            file,
+            description="A sticker",
+            reason="blah blah blah",
+        )
 
     async def test_edit_sticker(self, rest_client):
         expected_route = routes.PATCH_GUILD_STICKER.compile(guild=123, sticker=456)

tests/hikari/test_guilds.py

@@ -742,19 +742,24 @@ async def test_create_sticker(self, model):
         model.app.rest.create_sticker = mock.AsyncMock()
         file = object()
 
-        sticker = await model.create_sticker("NewSticker", "funny", file)
+        sticker = await model.create_sticker(
+            "NewSticker",
+            "funny",
+            file,
+            description="A sticker",
+            reason="blah blah blah",
+        )
+        assert sticker is model.app.rest.create_sticker.return_value
 
         model.app.rest.create_sticker.assert_awaited_once_with(
             90210,
             "NewSticker",
             "funny",
             file,
-            description=undefined.UNDEFINED,
-            reason=undefined.UNDEFINED,
+            description="A sticker",
+            reason="blah blah blah",
         )
 
-        assert sticker is model.app.rest.create_sticker.return_value
-
     @pytest.mark.asyncio()
     async def test_edit_sticker(self, model):
         model.app.rest.edit_sticker = mock.AsyncMock()