feat(GuildMember): new kick() method

melisa/__init__.py

@@ -5,7 +5,7 @@ from .client import Client, Bot
 from .models import *
 from .exceptions import *
 from .rest import RESTApp
-from .cache import (CacheManager, AutoCacheModels)
+from .cache import CacheManager, AutoCacheModels
 
 __package__ = "melisa"
 __title__ = "Melisa"

melisa/models/guild/member.py

@@ -122,8 +122,12 @@ class GuildMember(APIModelBase):
 
         return self
 
-    async def timeout(self, *, duration: Optional[float] = None,
-                      until: Optional[datetime.datetime] = None):
+    async def timeout(
+        self,
+        *,
+        duration: Optional[float] = None,
+        until: Optional[datetime.datetime] = None,
+    ):
         """|coro|
 
         Times out the member from the guild;
@@ -137,23 +141,64 @@ class GuildMember(APIModelBase):
         until: Optional[:class:`datetime.datetime`]
             The expiry date/time of the member's timeout. Set to ``None`` to remove the timeout.
             Supports up to 28 days in the future.
+
+        Raises
+        -------
+        HTTPException
+            The request to perform the action failed with other http exception.
+        ForbiddenError
+            You do not have proper permissions to do the actions required.
+        BadRequestError
+            You provided a wrong type of argument/
+
+        Returns
+        -------
+        :class:`~melisa.models.guild.member.GuildMember`
+            This member object.
         """
 
         if duration is None and until is None:
             await self._client.rest.modify_guild_member(
-                self.guild_id,
-                self.user.id,
-                communication_disabled_until=None
+                self.guild_id, self.user.id, communication_disabled_until=None
             )
         elif duration is not None:
             await self._client.rest.modify_guild_member(
                 self.guild_id,
                 self.user.id,
-                communication_disabled_until=datetime.datetime.utcnow() + datetime.timedelta(seconds=duration)
+                communication_disabled_until=datetime.datetime.utcnow()
+                + datetime.timedelta(seconds=duration),
             )
         else:
             await self._client.rest.modify_guild_member(
-                self.guild_id,
-                self.user.id,
-                communication_disabled_until=until
+                self.guild_id, self.user.id, communication_disabled_until=until
+            )
+
+        return self
+
+    async def kick(
+        self,
+        *,
+        reason: Optional[str] = None,
+    ):
+        """|coro|
+
+        Kicks member from a guild.
+
+        **Required permissions:** ``KICK_MEMBERS``
+
+        Parameters
+        ----------
+        reason: Optional[:class:`str`]
+            The reason of the action.
+
+        Raises
+        -------
+        HTTPException
+            The request to perform the action failed with other http exception.
+        ForbiddenError
+            You do not have proper permissions to do the actions required.
+        """
+
+        await self._client.rest.remove_guild_member(
+            self.guild_id, self.user.id, reason=reason
         )

melisa/rest.py

@@ -420,7 +420,7 @@ class RESTApp:
 
             **Required permissions:** ``MODERATE_MEMBERS``
         reason: Optional[:class:`str`]
-            The reason of the message delete operation.
+            The reason of the action.
 
         Raises
         -------
@@ -446,10 +446,49 @@ class RESTApp:
         if voice_channel_id is not UNDEFINED:
             data["channel_id"] = voice_channel_id
         if communication_disabled_until is not UNDEFINED:
-            data["communication_disabled_until"] = communication_disabled_until.isoformat()
+            data[
+                "communication_disabled_until"
+            ] = communication_disabled_until.isoformat()
 
         await self._http.patch(
             f"guilds/{guild_id}/members/{user_id}",
             data=data,
             headers={"X-Audit-Log-Reason": reason},
         )
+
+    async def remove_guild_member(
+        self,
+        guild_id: Union[Snowflake, str, int],
+        user_id: Union[Snowflake, str, int],
+        *,
+        reason: Optional[str] = None,
+    ):
+        """|coro|
+
+        [**REST API**] Remove a member from a guild.
+
+        **Required permissions:** ``KICK_MEMBERS``
+
+        Parameters
+        ----------
+        guild_id: Union[:class:`int`, :class:`str`, :class:`~.melisa.utils.snowflake.Snowflake`]
+            Id of guild where we will remove member
+        user_id: Union[:class:`int`, :class:`str`, :class:`~.melisa.utils.snowflake.Snowflake`]
+            Id of user to operate with.
+        reason: Optional[:class:`str`]
+            The reason of the action.
+
+        Raises
+        -------
+        HTTPException
+            The request to perform the action failed with other http exception.
+        ForbiddenError
+            You do not have proper permissions to do the actions required.
+        BadRequestError
+            You provided a wrong guild, user or something else.
+        """
+
+        await self._http.delete(
+            f"guilds/{guild_id}/members/{user_id}",
+            headers={"X-Audit-Log-Reason": reason},
+        )

packages/dev.txt

@@ -1,2 +1,3 @@
 flake8==4.0.1
 pytest==7.1.2
+black==22.3.0