feat(invite): implement community invites by Snipy7374 · Pull Request #1511 · DisnakeDev/disnake

Snipy7374 · 2026-03-08T10:44:40Z

Summary

Closes implement community invites #1510

Checklist

If code changes were made, then they have been tested
- I have updated the documentation to reflect the changes
- I have formatted the code properly by running uv run nox -s lint
- I have type-checked the code by running uv run nox -s pyright
This PR fixes an issue
This PR adds something new (e.g. new method or parameters)
This PR is a breaking change (e.g. methods or parameters removed/renamed)
This PR is not a code change (e.g. documentation, README, ...)

read-the-docs-community · 2026-03-08T10:46:16Z

Documentation build overview

📚 disnake | 🛠️ Build #31713062 | 📁 Comparing dffc5e9 against latest (664d0a7)

🔍 Preview build

Show files changed (50 files in total): 📝 50 modified | ➕ 0 added | ➖ 0 deleted

File	Status
faq.html	📝 modified
genindex.html	📝 modified
index.html	📝 modified
whats_new.html	📝 modified
api/abc.html	📝 modified
api/activities.html	📝 modified
api/app_commands.html	📝 modified
api/app_info.html	📝 modified
api/audit_logs.html	📝 modified
api/automod.html	📝 modified
api/channels.html	📝 modified
api/clients.html	📝 modified
api/components.html	📝 modified
api/emoji.html	📝 modified
api/entitlements.html	📝 modified
api/events.html	📝 modified
api/exceptions.html	📝 modified
api/guild_scheduled_events.html	📝 modified
api/guilds.html	📝 modified
api/integrations.html	📝 modified
api/interactions.html	📝 modified
api/invites.html	📝 modified
api/localization.html	📝 modified
api/members.html	📝 modified
api/messages.html	📝 modified
api/misc.html	📝 modified
api/permissions.html	📝 modified
api/roles.html	📝 modified
api/skus.html	📝 modified
api/soundboard.html	📝 modified
api/stage_instances.html	📝 modified
api/stickers.html	📝 modified
api/subscriptions.html	📝 modified
api/ui.html	📝 modified
api/users.html	📝 modified
api/utilities.html	📝 modified
api/voice.html	📝 modified
api/webhooks.html	📝 modified
api/widgets.html	📝 modified
ext/tasks/index.html	📝 modified
ext/commands/api/app_commands.html	📝 modified
ext/commands/api/bots.html	📝 modified
ext/commands/api/checks.html	📝 modified
ext/commands/api/cogs.html	📝 modified
ext/commands/api/context.html	📝 modified
ext/commands/api/converters.html	📝 modified
ext/commands/api/exceptions.html	📝 modified
ext/commands/api/help_commands.html	📝 modified
ext/commands/api/misc.html	📝 modified
ext/commands/api/prefix_commands.html	📝 modified

Enegg

review NOW

Enegg · 2026-03-08T15:42:57Z

+    created_at: datetime
+    completed_at: datetime | None


Hmm, do we use datetime in TypedDicts anywhere else?
What's the reason some of those are str and some datetime?

The reason is that the ones with str are to annotate the payload returned by the dAPI, the ones with datetime are for our users because I thought this endpoint didn't need its whole class to represent the model, a dict is sufficient IMO, so that's why I defined another typed dict, so our users will know the types and the keys in code too

Enegg · 2026-03-08T15:45:13Z

+        self.flags = GuildInviteFlags._from_value(data.get("flags", 0))
+        self.roles = [
+            Role(
+                guild=self.guild,


There's a type error on this line

I know but idk what to do, when could guild even be none, only if not cached in theory, Role needs it tho

Enegg · 2026-03-08T15:49:29Z

+        return {
+            "status": data["status"],
+            "total_users": data["total_users"],
+            "processed_users": data["processed_users"],
+            "created_at": parse_time(data["created_at"]),
+            "completed_at": parse_time(data["completed_at"]),
+            "error_message": data["error_message"],
+        }


This should be a small NamedTuple or a dataclass, I think it's unprecedented to return a dict from a public method

For an endpoint it's unprecedented yes, I did it because for this specific endpoint it doesn't make sense to me to have a whole class, so yeah I'll switch to a NamedTuple

Co-authored-by: Eneg <42005170+Enegg@users.noreply.github.com> Signed-off-by: Snipy7374 <100313469+Snipy7374@users.noreply.github.com>

… into feat/community_invites

Enegg · 2026-03-08T20:37:31Z


            .. versionadded:: 2.3

+        roles: :class:`list`\[:class:`.Role`] | :data:`None`


Suggested change

roles: :class:`list`\[:class:`.Role`] | :data:`None`

roles: :class:`~collections.abc.Collection`\[:class:`.Role`] | :data:`None`

Enegg · 2026-03-08T20:42:46Z

            self.guild_scheduled_event: GuildScheduledEvent | None = None

+        self.flags = GuildInviteFlags._from_value(data.get("flags", 0))
+        self.roles = [


Since invites are Hashable, .roles should probably be an immutable sequence (tuple)

Enegg · 2026-03-08T20:43:16Z

+
+        Fetch the csv file with the target users for this invite.
+        You must have the :attr:`~Permissions.manage_guild` or :attr:`~Permissions.view_audit_log`
+        permissions or to be the inviter to do this.


Suggested change

permissions or to be the inviter to do this.

permissions or be the inviter to do this.

Enegg · 2026-03-08T20:43:33Z

+        """|coro|
+
+        Update the target users for this invite.
+        You must have the :attr:`~Permissions.manage_guild` permission or to be the inviter to do this.


Suggested change

You must have the :attr:`~Permissions.manage_guild` permission or to be the inviter to do this.

You must have the :attr:`~Permissions.manage_guild` permission or be the inviter to do this.

implement community invites

909d1f6

Snipy7374 requested review from onerandomusername and shiftinv March 8, 2026 10:44

Snipy7374 added t: enhancement New feature t: api support Support of Discord API features s: needs review Issue/PR is awaiting reviews labels Mar 8, 2026

Enegg reviewed Mar 8, 2026

View reviewed changes

Snipy7374 and others added 15 commits March 8, 2026 16:57

Update disnake/abc.py

b6a288f

Co-authored-by: Eneg <42005170+Enegg@users.noreply.github.com> Signed-off-by: Snipy7374 <100313469+Snipy7374@users.noreply.github.com>

Update disnake/abc.py

4eecb98

Co-authored-by: Eneg <42005170+Enegg@users.noreply.github.com> Signed-off-by: Snipy7374 <100313469+Snipy7374@users.noreply.github.com>

Update disnake/abc.py

79da010

Co-authored-by: Eneg <42005170+Enegg@users.noreply.github.com> Signed-off-by: Snipy7374 <100313469+Snipy7374@users.noreply.github.com>

Update disnake/flags.py

e4f5271

Co-authored-by: Eneg <42005170+Enegg@users.noreply.github.com> Signed-off-by: Snipy7374 <100313469+Snipy7374@users.noreply.github.com>

Update disnake/invite.py

bd7dd08

Co-authored-by: Eneg <42005170+Enegg@users.noreply.github.com> Signed-off-by: Snipy7374 <100313469+Snipy7374@users.noreply.github.com>

Update disnake/invite.py

891a66b

Co-authored-by: Eneg <42005170+Enegg@users.noreply.github.com> Signed-off-by: Snipy7374 <100313469+Snipy7374@users.noreply.github.com>

Update disnake/invite.py

c9e0f3e

Co-authored-by: Eneg <42005170+Enegg@users.noreply.github.com> Signed-off-by: Snipy7374 <100313469+Snipy7374@users.noreply.github.com>

Update disnake/invite.py

58573ff

Co-authored-by: Eneg <42005170+Enegg@users.noreply.github.com> Signed-off-by: Snipy7374 <100313469+Snipy7374@users.noreply.github.com>

Update disnake/invite.py

155d94a

Co-authored-by: Eneg <42005170+Enegg@users.noreply.github.com> Signed-off-by: Snipy7374 <100313469+Snipy7374@users.noreply.github.com>

Update disnake/abc.py

caf03f6

Co-authored-by: Eneg <42005170+Enegg@users.noreply.github.com> Signed-off-by: Snipy7374 <100313469+Snipy7374@users.noreply.github.com>

Update disnake/invite.py

5d4d920

Co-authored-by: Eneg <42005170+Enegg@users.noreply.github.com> Signed-off-by: Snipy7374 <100313469+Snipy7374@users.noreply.github.com>

apply changes to to_multipart

2970aa4

Merge branch 'feat/community_invites' of github.com:Snipy7374/disnake…

136da6f

… into feat/community_invites

make roles a Collection

4a635be

change codeblocks

dffc5e9

Enegg reviewed Mar 8, 2026

View reviewed changes


		.. versionadded:: 2.3

		roles: :class:`list`\[:class:`.Role`] \| :data:`None`

	roles: :class:`list`\[:class:`.Role`] \| :data:`None`
	roles: :class:`~collections.abc.Collection`\[:class:`.Role`] \| :data:`None`

	permissions or to be the inviter to do this.
	permissions or be the inviter to do this.

	You must have the :attr:`~Permissions.manage_guild` permission or to be the inviter to do this.
	You must have the :attr:`~Permissions.manage_guild` permission or be the inviter to do this.

Conversation

Snipy7374 commented Mar 8, 2026

Summary

Checklist

Uh oh!

read-the-docs-community bot commented Mar 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Documentation build overview

Uh oh!

Enegg left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Snipy7374 Mar 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

read-the-docs-community bot commented Mar 8, 2026 •

edited

Loading

Snipy7374 Mar 8, 2026 •

edited

Loading