fix(channel): implement permission overwrites (#625)

Author: EepyElvyra

docs/api.models.flags.rst

@@ -0,0 +1,8 @@
+.. currentmodule:: interactions
+
+Flag Bitshift Models
+====================
+
+.. automodule:: interactions.api.models.flags
+    :members:
+    :noindex:

docs/api.models.intents.rst

@@ -9,7 +9,7 @@ Model Objects
     api.models.channel.rst
     api.models.guild.rst
     api.models.gw.rst
-    api.models.intents.rst
+    api.models.flags.rst
     api.models.member.rst
     api.models.message.rst
     api.models.misc.rst

docs/api.models.rst

@@ -2,7 +2,7 @@
 from enum import IntEnum
 from typing import Callable, List, Optional, Union
 
-from .misc import MISSING, DictSerializerMixin, Snowflake
+from .misc import MISSING, DictSerializerMixin, Overwrite, Snowflake
 
 
 class ChannelType(IntEnum):
@@ -278,7 +278,7 @@ async def modify(
         user_limit: Optional[int] = MISSING,
         rate_limit_per_user: Optional[int] = MISSING,
         position: Optional[int] = MISSING,
-        # permission_overwrites,
+        permission_overwrites: Optional[List[Overwrite]] = MISSING,
         parent_id: Optional[int] = MISSING,
         nsfw: Optional[bool] = MISSING,
         reason: Optional[str] = None,
@@ -302,6 +302,8 @@ async def modify(
         :type parent_id: Optional[int]
         :param nsfw?: Whether the channel is nsfw or not, defaults to the current value of the channel
         :type nsfw: Optional[bool]
+        :param permission_overwrites?: The permission overwrites, if any
+        :type permission_overwrites: Optional[List[Overwrite]]
         :param reason?: The reason for the edit
         :type reason: Optional[str]
         :return: The modified channel as new object
@@ -317,8 +319,13 @@ async def modify(
             self.rate_limit_per_user if rate_limit_per_user is MISSING else rate_limit_per_user
         )
         _position = self.position if position is MISSING else position
-        _parent_id = self.parent_id if parent_id is MISSING else parent_id
+        _parent_id = int(self.parent_id) if parent_id is MISSING else int(parent_id)
         _nsfw = self.nsfw if nsfw is MISSING else nsfw
+        _permission_overwrites = (
+            self.permission_overwrites
+            if permission_overwrites is MISSING
+            else [overwrite._json for overwrite in permission_overwrites]
+        )
         _type = self.type
 
         payload = Channel(
@@ -331,6 +338,7 @@ async def modify(
             position=_position,
             parent_id=_parent_id,
             nsfw=_nsfw,
+            permission_overwrites=_permission_overwrites,
         )
         res = await self._client.modify_channel(
             channel_id=int(self.id),

interactions/api/models/channel.py

@@ -98,7 +98,7 @@ class Channel(DictSerializerMixin):
         user_limit: Optional[int] = MISSING,
         rate_limit_per_user: Optional[int] = MISSING,
         position: Optional[int] = MISSING,
-        # permission_overwrites,
+        permission_overwrites: Optional[List[Overwrite]] = MISSING,
         parent_id: Optional[int] = MISSING,
         nsfw: Optional[bool] = MISSING,
         reason: Optional[str] = None,

interactions/api/models/channel.pyi

@@ -5,7 +5,7 @@
 from .channel import Channel, ChannelType
 from .member import Member
 from .message import Emoji, Sticker
-from .misc import MISSING, DictSerializerMixin, Snowflake
+from .misc import MISSING, DictSerializerMixin, Overwrite, Snowflake
 from .presence import PresenceActivity
 from .role import Role
 from .team import Application
@@ -674,7 +674,7 @@ async def create_channel(
         user_limit: Optional[int] = MISSING,
         rate_limit_per_user: Optional[int] = MISSING,
         position: Optional[int] = MISSING,
-        # permission_overwrites,
+        permission_overwrites: Optional[List[Overwrite]] = MISSING,
         parent_id: Optional[int] = MISSING,
         nsfw: Optional[bool] = MISSING,
         reason: Optional[str] = None,
@@ -698,6 +698,8 @@ async def create_channel(
         :type position: Optional[int]
         :param parent_id?: The id of the parent category for a channel
         :type parent_id: Optional[int]
+        :param permission_overwrites?: The permission overwrites, if any
+        :type permission_overwrites: Optional[Overwrite]
         :param nsfw?: Whether the channel is nsfw or not, default ``False``
         :type nsfw: Optional[bool]
         :param reason: The reason for the creation
@@ -742,6 +744,10 @@ async def create_channel(
             payload["parent_id"] = parent_id
         if nsfw is not MISSING:
             payload["nsfw"] = nsfw
+        if permission_overwrites is not MISSING:
+            payload["permission_overwrites"] = [
+                overwrite._json for overwrite in permission_overwrites
+            ]
 
         res = await self._client.create_channel(
             guild_id=int(self.id),
@@ -760,7 +766,7 @@ async def modify_channel(
         user_limit: Optional[int] = MISSING,
         rate_limit_per_user: Optional[int] = MISSING,
         position: Optional[int] = MISSING,
-        # permission_overwrites,
+        permission_overwrites: Optional[List[Overwrite]] = MISSING,
         parent_id: Optional[int] = MISSING,
         nsfw: Optional[bool] = MISSING,
         reason: Optional[str] = None,
@@ -784,6 +790,8 @@ async def modify_channel(
         :type position: Optional[int]
         :param parent_id?: The id of the parent category for a channel, defaults to the current value of the channel
         :type parent_id: Optional[int]
+        :param permission_overwrites?: The permission overwrites, if any
+        :type permission_overwrites: Optional[Overwrite]
         :param nsfw?: Whether the channel is nsfw or not, defaults to the current value of the channel
         :type nsfw: Optional[bool]
         :param reason: The reason for the edit
@@ -805,6 +813,11 @@ async def modify_channel(
         _position = ch.position if position is MISSING else position
         _parent_id = ch.parent_id if parent_id is MISSING else parent_id
         _nsfw = ch.nsfw if nsfw is MISSING else nsfw
+        _permission_overwrites = (
+            ch.permission_overwrites
+            if permission_overwrites is MISSING
+            else [overwrite._json for overwrite in permission_overwrites]
+        )
         _type = ch.type
 
         payload = Channel(
@@ -814,6 +827,7 @@ async def modify_channel(
             bitrate=_bitrate,
             user_limit=_user_limit,
             rate_limit_per_user=_rate_limit_per_user,
+            permission_overwrites=_permission_overwrites,
             position=_position,
             parent_id=_parent_id,
             nsfw=_nsfw,

interactions/api/models/guild.py

@@ -5,7 +5,7 @@ from enum import IntEnum
 from .channel import Channel, ChannelType, Thread
 from .member import Member
 from .message import Emoji, Sticker
-from .misc import DictSerializerMixin, MISSING, Snowflake
+from .misc import DictSerializerMixin, MISSING, Snowflake, Overwrite
 from .presence import PresenceActivity
 from .role import Role
 from .user import User
@@ -214,7 +214,7 @@ class Guild(DictSerializerMixin):
         user_limit: Optional[int] = MISSING,
         rate_limit_per_user: Optional[int] = MISSING,
         position: Optional[int] = MISSING,
-        # permission_overwrites,
+        permission_overwrites: Optional[List[Overwrite]] = MISSING,
         parent_id: Optional[int] = MISSING,
         nsfw: Optional[bool] = MISSING,
         reason: Optional[str] = None,
@@ -228,7 +228,7 @@ class Guild(DictSerializerMixin):
         user_limit: Optional[int] = MISSING,
         rate_limit_per_user: Optional[int] = MISSING,
         position: Optional[int] = MISSING,
-        # permission_overwrites,
+        permission_overwrites: Optional[List[Overwrite]] = MISSING,
         parent_id: Optional[int] = MISSING,
         nsfw: Optional[bool] = MISSING,
         reason: Optional[str] = None,