feat: Add full support for prune endpoints (#1062)

* feat: Add `begin_guild_prune`

* Update guild.py

* Update guild.py

* Update guild.py

* Remove weird 7 formatting thing

* ci: correct from checks.

* Add min max counts

* Update guild.py

* ci: correct from checks.

* Add min max to helpers

* Fix numbers (sorry ed)

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: Nanrech

interactions/api/http/guild.py

@@ -601,14 +601,40 @@ async def remove_guild_member(
             Route("DELETE", f"/guilds/{guild_id}/members/{user_id}"), reason=reason
         )
 
+    async def begin_guild_prune(
+        self,
+        guild_id: int,
+        days: int = 7,
+        compute_prune_count: bool = True,
+        include_roles: Optional[List[int]] = None,
+    ) -> dict:
+        """
+        Begins a prune operation.
+
+        :param guild_id: Guild ID snowflake
+        :param days: Number of days to count, minimum 1, maximum 30. Defaults to 7.
+        :param compute_prune_count: Whether the returned "pruned" dict contains the computed prune count or None.
+        :param include_roles: Role IDs to include, if given.
+        :return: A dict containing `{"pruned": int}` or `{"pruned": None}`
+        """
+
+        payload = {
+            "days": days,
+            "compute_prune_count": compute_prune_count,
+        }
+        if include_roles:
+            payload["include_roles"] = ", ".join(str(x) for x in include_roles)
+
+        return await self._req.request(Route("POST", f"/guilds/{guild_id}/prune"), json=payload)
+
     async def get_guild_prune_count(
         self, guild_id: int, days: int = 7, include_roles: Optional[List[int]] = None
     ) -> dict:
         """
         Retrieves a dict from an API that results in how many members would be pruned given the amount of days.
 
         :param guild_id: Guild ID snowflake.
-        :param days:  Number of days to count. Defaults to ``7``.
+        :param days: Number of days to count, minimum 1, maximum 30. Defaults to 7.
         :param include_roles: Role IDs to include, if given.
         :return: A dict denoting `{"pruned": int}`
         """

interactions/api/models/guild.py

@@ -2030,6 +2030,71 @@ async def get_all_bans(self) -> List[Dict[str, User]]:
 
         return res
 
+    async def prune(
+        self,
+        days: int = 7,
+        compute_prune_count: bool = True,
+        include_roles: Optional[Union[List[Role], List[int], List[Snowflake], List[str]]] = MISSING,
+    ) -> Optional[int]:
+        """
+        Begins a prune operation.
+
+        :param days: Number of days to count, minimum 1, maximum 30. Defaults to 7.
+        :param compute_prune_count: Whether the returned "pruned" dict contains the computed prune count or None.
+        :param include_roles: Role IDs to include, if given.
+        :return: The number of pruned members, if compute_prune_count is not false. Otherwise returns None.
+        :rtype: Optional[int]
+        """
+        if not self._client:
+            raise LibraryException(code=13)
+
+        if include_roles is not MISSING:
+            _roles = [
+                int(role.id) if isinstance(role, Role) else int(role) for role in include_roles
+            ]
+        else:
+            _roles = None
+
+        res: dict = await self._client.begin_guild_prune(
+            guild_id=int(self.id),
+            days=days,
+            compute_prune_count=compute_prune_count,
+            include_roles=_roles,
+        )
+
+        return res.get("pruned")
+
+    async def get_prune_count(
+        self,
+        days: int = 7,
+        include_roles: Optional[Union[List[Role], List[int], List[Snowflake], List[str]]] = MISSING,
+    ) -> int:
+        """
+        Returns the number of members that would be removed in a prune operation.
+
+        :param days: Number of days to count, minimum 1, maximum 30. Defaults to 7.
+        :param include_roles: Role IDs to include, if given.
+        :return: The number of members that would be pruned.
+        :rtype: int
+        """
+        if not self._client:
+            raise LibraryException(code=13)
+
+        if include_roles is not MISSING:
+            _roles = [
+                int(role.id) if isinstance(role, Role) else int(role) for role in include_roles
+            ]
+        else:
+            _roles = None
+
+        res: dict = await self._client.get_guild_prune_count(
+            guild_id=int(self.id),
+            days=days,
+            include_roles=_roles,
+        )
+
+        return res.get("pruned")
+
     async def get_emoji(
         self,
         emoji_id: int,