✨ Get Invite & Delete invite (#393)

* ✨ Added get_invite endpoint

* ✨ Added delete_invite endpoint

* ✨ Added invite.delete

* Update pincer/objects/guild/guild.py

Co-authored-by: Lunarmagpie <[email protected]>

* 🎨 black

* Update pincer/objects/guild/guild.py

Co-authored-by: trag1c <[email protected]>

* Update pincer/objects/guild/guild.py

Co-authored-by: trag1c <[email protected]>

* 📝 Adding core param

* 🐛 Fixing async/await

Co-authored-by: Lunarmagpie <[email protected]>
Co-authored-by: trag1c <[email protected]>

Author: 3 people

pincer/objects/guild/guild.py

@@ -1279,6 +1279,23 @@ async def get_invites(self) -> AsyncGenerator[Invite, None]:
         for invite_data in data:
             yield Invite.from_dict(invite_data)
 
+    async def get_invite(self, code: str) -> Invite:
+        """|coro|
+        Returns an Invite object for the given invite code.
+
+        Parameters
+        ----------
+        code : :class:`str`
+            The invite code to get the invite for.
+
+        Returns
+        -------
+        :class:`~pincer.objects.guild.invite.Invite`
+            The invite object.
+        """
+        data = await self._http.get(f"invite/{code}")
+        return Invite.from_dict(data)
+
     async def get_integrations(self) -> AsyncIterator[Integration]:
         """|coro|
         Returns an async generator of integrations for the guild.
@@ -1312,6 +1329,18 @@ async def delete_integration(
             headers={"X-Audit-Log-Reason": reason},
         )
 
+    async def delete_invite(self, code: str):
+        """|coro|
+        Deletes an invite.
+        Requires the ``MANAGE_GUILD`` intent.
+
+        Parameters
+        ----------
+        code : :class:`str`
+            The code of the invite to delete.
+        """
+        await self._http.delete(f"guilds/{self.id}/invites/{code}")
+
     async def get_widget_settings(self) -> GuildWidget:
         """|coro|
         Returns the guild widget settings.

pincer/objects/guild/invite.py

@@ -32,6 +32,7 @@ class InviteTargetType(IntEnum):
     EMBEDDED_APPLICATION:
         An embedded application invite, e.g. poker-night etc.
     """
+
     STREAM = 1
     EMBEDDED_APPLICATION = 2
 
@@ -51,6 +52,7 @@ class InviteStageInstance(APIObject):
     topic: :class:`str`
         the topic of the Stage instance (1-120 characters)
     """
+
     members: List[GuildMember]
     participant_count: int
     speaker_count: int
@@ -101,6 +103,7 @@ class Invite(APIObject):
     created_at: APINullable[:class:`~pincer.utils.timestamp.Timestamp`]
         When this invite was created
     """
+
     # noqa: E501
 
     channel: Channel
@@ -130,3 +133,17 @@ def __str__(self) -> str:
     @property
     def link(self):
         return f"https://discord.gg/{self.code}"
+
+    async def delete(self):
+        """Delete this invite.
+
+        Raises
+        ------
+        Forbidden
+            You do not have permission to delete this invite
+        NotFound
+            This invite does not exist
+        HTTPException
+            Deleting the invite failed
+        """
+        await self._http.delete(f"guilds/{self.guild.id}/invites/{self.code}")