feat: Expand "modify" helper methods into single-argument helper methods to make editing of only one field easier (#479)

* channel.modify

* refactor: add `*`

* some guild stuff

* feat: expand guild.modify

* feat: expand guild.modify

Author: EepyElvyra

interactions/api/models/channel.py

@@ -302,7 +302,7 @@ 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 reason: The reason for the edit
+        :param reason?: The reason for the edit
         :type reason: Optional[str]
         :return: The modified channel as new object
         :rtype: Channel
@@ -339,6 +339,164 @@ async def modify(
         )
         return Channel(**res, _client=self._client)
 
+    async def set_name(
+        self,
+        name: str,
+        *,
+        reason: Optional[str] = None,
+    ) -> "Channel":
+        """
+        Sets the name of the channel.
+
+        :param name: The new name of the channel
+        :type name: str
+        :param reason?: The reason of the edit
+        :type reason: Optional[str]
+        :return: The edited channel
+        :rtype: Channel
+        """
+
+        return await self.modify(name=name, reason=reason)
+
+    async def set_topic(
+        self,
+        topic: str,
+        *,
+        reason: Optional[str] = None,
+    ) -> "Channel":
+        """
+        Sets the topic of the channel.
+
+        :param topic: The new topic of the channel
+        :type topic: str
+        :param reason?: The reason of the edit
+        :type reason: Optional[str]
+        :return: The edited channel
+        :rtype: Channel
+        """
+
+        return await self.modify(topic=topic, reason=reason)
+
+    async def set_bitrate(
+        self,
+        bitrate: int,
+        *,
+        reason: Optional[str] = None,
+    ) -> "Channel":
+        """
+        Sets the bitrate of the channel.
+
+        :param bitrate: The new bitrate of the channel
+        :type bitrate: int
+        :param reason?: The reason of the edit
+        :type reason: Optional[str]
+        :return: The edited channel
+        :rtype: Channel
+        """
+
+        if self.type != ChannelType.GUILD_VOICE:
+            raise TypeError("Bitrate is only available for VoiceChannels")
+
+        return await self.modify(bitrate=bitrate, reason=reason)
+
+    async def set_user_limit(
+        self,
+        user_limit: int,
+        *,
+        reason: Optional[str] = None,
+    ) -> "Channel":
+        """
+        Sets the user_limit of the channel.
+
+        :param user_limit: The new user limit of the channel
+        :type user_limit: int
+        :param reason?: The reason of the edit
+        :type reason: Optional[str]
+        :return: The edited channel
+        :rtype: Channel
+        """
+
+        if self.type != ChannelType.GUILD_VOICE:
+            raise TypeError("user_limit is only available for VoiceChannels")
+
+        return await self.modify(user_limit=user_limit, reason=reason)
+
+    async def set_rate_limit_per_user(
+        self,
+        rate_limit_per_user: int,
+        *,
+        reason: Optional[str] = None,
+    ) -> "Channel":
+        """
+        Sets the position of the channel.
+
+        :param rate_limit_per_user: The new rate_limit_per_user of the channel (0-21600)
+        :type rate_limit_per_user: int
+        :param reason?: The reason of the edit
+        :type reason: Optional[str]
+        :return: The edited channel
+        :rtype: Channel
+        """
+
+        return await self.modify(rate_limit_per_user=rate_limit_per_user, reason=reason)
+
+    async def set_position(
+        self,
+        position: int,
+        *,
+        reason: Optional[str] = None,
+    ) -> "Channel":
+        """
+        Sets the position of the channel.
+
+        :param position: The new position of the channel
+        :type position: int
+        :param reason?: The reason of the edit
+        :type reason: Optional[str]
+        :return: The edited channel
+        :rtype: Channel
+        """
+
+        return await self.modify(position=position, reason=reason)
+
+    async def set_parent_id(
+        self,
+        parent_id: int,
+        *,
+        reason: Optional[str] = None,
+    ) -> "Channel":
+        """
+        Sets the parent_id of the channel.
+
+        :param parent_id: The new parent_id of the channel
+        :type parent_id: int
+        :param reason?: The reason of the edit
+        :type reason: Optional[str]
+        :return: The edited channel
+        :rtype: Channel
+        """
+
+        return await self.modify(parent_id=parent_id, reason=reason)
+
+    async def set_nsfw(
+        self,
+        nsfw: bool,
+        *,
+        reason: Optional[str] = None,
+    ) -> "Channel":
+        """
+        Sets the nsfw-flag of the channel.
+
+        :param nsfw: The new nsfw-flag of the channel
+        :type nsfw: bool
+        :param reason?: The reason of the edit
+        :type reason: Optional[str]
+        :return: The edited channel
+        :rtype: Channel
+        """
+
+        return await self.modify(nsfw=nsfw, reason=reason)
+
     async def add_member(
         self,
         member_id: int,

interactions/api/models/channel.pyi

@@ -103,13 +103,61 @@ class Channel(DictSerializerMixin):
         nsfw: Optional[bool] = MISSING,
         reason: Optional[str] = None,
     ) -> "Channel": ...
+    async def set_name(
+        self,
+        name: str,
+        *,
+        reason: Optional[str] = None
+    ) -> "Channel": ...
+    async def set_topic(
+        self,
+        topic: str,
+        *,
+        reason: Optional[str] = None
+    ) -> "Channel": ...
+    async def set_bitrate(
+        self,
+        bitrate: int,
+        *,
+        reason: Optional[str] = None
+    ) -> "Channel": ...
+    async def set_user_limit(
+        self,
+        user_limit: int,
+        *,
+        reason: Optional[str] = None
+    ) -> "Channel": ...
+    async def set_rate_limit_per_user(
+        self,
+        rate_limit_per_user: int,
+        *,
+        reason: Optional[str] = None
+    ) -> "Channel": ...
+    async def set_position(
+        self,
+        position: int,
+        *,
+        reason: Optional[str] = None
+    ) -> "Channel": ...
+    async def set_parent_id(
+        self,
+        parent_id: int,
+        *,
+        reason: Optional[str] = None
+    ) -> "Channel": ...
+    async def set_nsfw(
+        self,
+        nsfw: bool,
+        *,
+        reason: Optional[str] = None
+    ) -> "Channel": ...
     async def add_member(
         self,
         member_id: int,
     ) -> None: ...
     async def pin_message(
-            self,
-            message_id: int,
+        self,
+        message_id: int,
     ) -> None: ...
     async def unpin_message(
         self,
@@ -121,8 +169,8 @@ class Channel(DictSerializerMixin):
     ) -> Message: ...
     async def get_pinned_messages(self) -> List[Message]: ...
     async def get_message(
-            self,
-            message_id: int,
+        self,
+        message_id: int,
     ) -> Message: ...
     async def purge(
         self,