A mirror package for discord.py. Please install that instead.
Last release 3 years ago
no release in 18 months
Release timing varies
gaps range from 2 weeks to 2.2 years
Most releases are documented
notes for 10 of 13 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
13 releases · first in 2017
Release timeline
13 releases since 2017One column per quarter.
Releases
- 2.3.210 Aug 2023
Release notes
Open source →Bug Fixes
Fix the name parameter not being respected when sending a CustomActivity.
Fix Intents.emoji and Intents.emojis_and_stickers having swapped alias values (9471).
Fix NameError when using abc.GuildChannel.create_invite (9505).
Fix crash when disconnecting during the middle of a HELLO packet when using AutoShardedClient.
Fix voice websocket not being closed before being replaced by a new one (9518).
|commands| Fix the wrong ~ext.commands.HelpCommand.on_help_command_error being called when ejected from a cog.
|commands| Fix =None being displayed in ~ext.commands.Command.signature.
- 2.3.126 Jun 2023
Release notes
Open source →Bug Fixes
Fix username lookup in Guild.get_member_named (9451).
- Use cache data first for Interaction.channel instead of API data.
This bug usually manifested in incomplete channel objects (e.g. no overwrites) because Discord does not provide this data.
Fix false positives in PartialEmoji.from_str inappropriately setting animated to True (9456, 9457).
Fix certain select types not appearing in Message.components (9462).
|commands| Change lookup order for ~ext.commands.MemberConverter and ~ext.commands.UserConverter to prioritise usernames instead of nicknames.
- 2.3.012 Jun 2023
Release notes
Open source →New Features
- Add support for the new username system (also known as "pomelo").
Add User.global_name to get their global nickname or "display name".
Update User.display_name and Member.display_name to understand global nicknames.
Update __str__ for User to drop discriminators if the user has been migrated.
Update Guild.get_member_named to work with migrated users.
Update User.default_avatar to work with migrated users.
|commands| Update user and member converters to understand migrated users.
Add DefaultAvatar.pink for new pink default avatars.
Add Colour.pink to get the pink default avatar colour.
- Add support for voice messages (9358)
Add MessageFlags.voice
Add Attachment.duration and Attachment.waveform
Add Attachment.is_voice_message
This does not support sending voice messages because this is currently unsupported by the API.
Add support for new Interaction.channel attribute from the API update (9339).
Add support for TextChannel.default_thread_slowmode_delay (9291).
Add support for ForumChannel.default_sort_order (9290).
Add support for default_reaction_emoji and default_forum_layout in Guild.create_forum (9300).
Add support for widget_channel, widget_enabled, and mfa_level in Guild.edit (9302, 9303).
- Add various new Permissions and changes (9312, 9325, 9358, 9378)
Add new ~Permissions.manage_expressions, ~Permissions.use_external_sounds, ~Permissions.use_soundboard, ~Permissions.send_voice_messages, ~Permissions.create_expressions permissions.
Change Permissions.manage_emojis to be an alias of ~Permissions.manage_expressions.
Add various new properties to PartialAppInfo and AppInfo (9298).
Add support for with_counts parameter to Client.fetch_guilds (9369).
Add new Guild.get_emoji helper (9296).
Add ApplicationFlags.auto_mod_badge (9313).
Add Guild.max_stage_video_users and Guild.safety_alerts_channel (9318).
Add support for raid_alerts_disabled and safety_alerts_channel in Guild.edit (9318).
|commands| Add BadLiteralArgument.argument to get the failed argument's value (9283).
|commands| Add Context.filesize_limit property (9416).
|commands| Add support for Parameter.displayed_name (9427).
Bug Fixes
- Fix FileHandler handlers being written ANSI characters when the bot is executed inside PyCharm.
This has the side effect of removing coloured logs from the PyCharm terminal due an upstream bug involving TTY detection. This issue is tracked under PY-43798.
Fix channel edits with Webhook.edit sending two requests instead of one.
Fix StageChannel.last_message_id always being None (9422).
Fix piped audio input ending prematurely (9001, 9380).
Fix persistent detection for ui.TextInput being incorrect if the custom_id is set later (9438).
Fix custom attributes not being copied over when inheriting from app_commands.Group (9383).
Fix AutoMod audit log entry error due to empty channel_id (9384).
Fix handling of around parameter in abc.Messageable.history (9388).
Fix occasional AttributeError when accessing the ClientUser.mutual_guilds property (9387).
Fix utils.escape_markdown not escaping the new markdown (9361).
Fix webhook targets not being converted in audit logs (9332).
Fix error when not passing enabled in Guild.create_automod_rule (9292).
Fix how various parameters are handled in Guild.create_scheduled_event (9275).
Fix not sending the ssrc parameter when sending the SPEAKING payload (9301).
Fix Message.guild being None sometimes when received via an interaction.
Fix Message.system_content for MessageType.channel_icon_change (9410).
Miscellaneous
Update the base Guild.filesize_limit to 25MiB (9353).
Allow Interaction webhook URLs to be used in Webhook.from_url.
Set the socket family of internal connector to AF_INET to prevent IPv6 connections (9442, 9443).
- 2.2.31 May 2023
Release notes
Open source →Bug Fixes
Fix crash from Discord sending null channel_id for automod audit logs.
Fix channel edits when using Webhook.edit sending two requests.
Fix AuditLogEntry.target being None for invites (9336).
Fix KeyError when accessing data for GuildSticker (9324).
- 2.2.22 Mar 2023
Release notes
Open source →Bug Fixes
Fix UDP discovery in voice not using new 74 byte layout which caused voice to break (9277, 9278)
- 2.2.12 Mar 2023
Nothing published for this version
- 2.2.02 Mar 2023
Release notes
Open source →New Features
Add support for new on_audit_log_entry_create event
- Add support for silent messages via silent parameter in abc.Messageable.send
This is queryable via MessageFlags.suppress_notifications
Implement abc.Messageable for StageChannel (9248)
Add setter for discord.ui.ChannelSelect.channel_types (9068)
Add support for custom messages in automod via AutoModRuleAction.custom_message (9267)
Add ForumChannel.get_thread (9106)
Add StageChannel.slowmode_delay and VoiceChannel.slowmode_delay (9111)
Add support for editing the slowmode for StageChannel and VoiceChannel (9111)
Add Locale.indonesian
Add delete_after keyword argument to Interaction.edit_message (9415)
Add delete_after keyword argument to InteractionMessage.edit (9206)
- Add support for member flags (9204)
Accessible via Member.flags and has a type of MemberFlags
Support bypass_verification within Member.edit
- Add support for passing a client to Webhook.from_url and Webhook.partial
This allows them to use views (assuming they are "bot owned" webhooks)
Add Colour.dark_embed and Colour.light_embed (9219)
Add support for many more parameters within Guild.create_stage_channel (9245)
Add AppInfo.role_connections_verification_url
Add support for ForumChannel.default_layout
Add various new MessageType values such as ones related to stage channel and role subscriptions
- Add support for role subscription related attributes
RoleSubscriptionInfo within Message.role_subscription
MessageType.role_subscription_purchase
SystemChannelFlags.role_subscription_purchase_notifications
SystemChannelFlags.role_subscription_purchase_notification_replies
RoleTags.subscription_listing_id
RoleTags.is_available_for_purchase
Add support for checking if a role is a linked role under RoleTags.is_guild_connection
Add support for GIF sticker type
Add support for Message.application_id and Message.position
Add utils.maybe_coroutine helper
Add ScheduledEvent.creator_id attribute
|commands| Add support for ~ext.commands.Cog.interaction_check for ~ext.commands.GroupCog (9189)
Bug Fixes
Fix views not being removed from message store backing leading to a memory leak when used from an application command context
Fix async iterators requesting past their bounds when using oldest_first and after or before (9093)
Fix Guild.audit_logs pagination logic being buggy when using after (9269)
Fix Message.channel sometimes being Object instead of PartialMessageable
Fix ui.View not properly calling super().__init_subclass__ (9231)
Fix available_tags and default_thread_slowmode_delay not being respected in Guild.create_forum
Fix AutoModTrigger ignoring allow_list with type keyword (9107)
Fix implicit permission resolution for Thread (9153)
Fix AutoModRule.edit to work with actual snowflake types such as Object (9159)
Fix Webhook.send returning ForumChannel for WebhookMessage.channel
When a lookup for AuditLogEntry.target fails, it will fallback to Object with the appropriate Object.type (9171)
Fix AuditLogDiff.type for integrations returning ChannelType instead of str (9200)
Fix AuditLogDiff.type for webhooks returning ChannelType instead of WebhookType (9251)
Fix webhooks and interactions not properly closing files after the request has completed
Fix NameError in audit log target for app commands
Fix ScheduledEvent.edit requiring some arguments to be passed in when unnecessary (9261, 9268)
|commands| Explicit set a traceback for hybrid command invocations (9205)
Miscellaneous
Add colour preview for the colours predefined in Colour
Finished views are no longer stored by the library when sending them (9235)
Force enable colour logging for the default logging handler when run under Docker.
Add various overloads for Client.wait_for to aid in static analysis (9184)
Interaction can now optionally take a generic parameter, ClientT to represent the type for Interaction.client
|commands| Respect ~ext.commands.Command.ignore_extra for ~discord.ext.commands.FlagConverter keyword-only parameters
|commands| Change Paginator.pages to not prematurely close (9257)
- 2.1.012 Nov 2022
Release notes
Open source →New Features
Add support for delete_message_seconds in Guild.ban (8391)
Add support for automod related audit log actions (8389)
Add support for ForumChannel annotations in app commands
Add support for ForumChannel.default_thread_slowmode_delay.
Add support for ForumChannel.default_reaction_emoji.
- Add support for forum tags under ForumTag.
Tags can be obtained using ForumChannel.available_tags or ForumChannel.get_tag.
See Thread.edit and ForumChannel.edit for modifying tags and their usage.
- Add support for new select types (9013, 9003).
These are split into separate classes, ~discord.ui.ChannelSelect, ~discord.ui.RoleSelect, ~discord.ui.UserSelect, ~discord.ui.MentionableSelect.
The decorator still uses a single function, ~discord.ui.select. Changing the select type is done by the cls keyword parameter.
Add support for toggling discoverable and invites_disabled features in Guild.edit (8390).
Add Interaction.translate helper method (8425).
Add Forum.archived_threads (8476).
Add ApplicationFlags.active, UserFlags.active_developer, and PublicUserFlags.active_developer.
Add delete_after to InteractionResponse.send_message (9022).
Add support for AutoModTrigger.regex_patterns.
|commands| Add GroupCog.group_extras to set app_commands.Group.extras (8405).
|commands| Add support for NumPy style docstrings for regular commands to set parameter descriptions.
|commands| Allow ~discord.ext.commands.Greedy to potentially maintain state between calls.
|commands| Add Cog.has_app_command_error_handler (8991).
|commands| Allow delete_after in Context.send on ephemeral messages (9021).
Bug Fixes
Fix an KeyError being raised when constructing app_commands.Group with no module (8411).
Fix unescaped period in webhook URL regex (8443).
Fix app_commands.CommandSyncFailure raising for other 400 status code errors.
Fix potential formatting issues showing _errors in app_commands.CommandSyncFailure.
Fix Guild.stage_instances and Guild.schedule_events clearing on GUILD_UPDATE.
Fix detection of overriden app_commands.Group.on_error
Fix app_commands.CommandTree.on_error still being called when a bound error handler is set.
Fix thread permissions being set to True in DMChannel.permissions_for (8965).
Fix on_scheduled_event_delete occasionally dispatching with too many parameters (9019).
|commands| Fix Context.from_interaction ignoring ~discord.ext.commands.Context.command_failed.
|commands| Fix ~discord.ext.commands.Range to allow 3.10 Union syntax (8446).
|commands| Fix before_invoke not triggering for fallback commands in a hybrid group command (8461, 8462).
Miscellaneous
Change error message for unbound callbacks in app_commands.ContextMenu to make it clearer that bound methods are not allowed.
Normalize type formatting in TypeError exceptions (8453).
Change VoiceProtocol.on_voice_state_update and VoiceProtocol.on_voice_server_update parameters to be positional only (8463).
Add support for PyCharm when using the default coloured logger (9015).
- 2.0.020 Aug 2022
Release notes
Open source →The changeset for this version are too big to be listed here, for more information please see the migrating page.
- 1.7.322 Jun 2021
Release notes
Open source →Bug Fixes
Fix a crash involving guild uploaded stickers
Fix DMChannel.permissions_for not having Permissions.read_messages set.
- 1.0.114 Apr 2019
Release notes
Open source →Bug Fixes
Fix issue with speaking state being cast to int when it was invalid.
Fix some issues with loop cleanup that some users experienced on Linux machines.
Fix voice handshake race condition (2056, 2063)
- 0.16.1224 Jan 2019
Nothing published for this version
- 0.0.218 Aug 2017
Nothing published for this version