Changewog

This page keeps a detaiwed human fwiendwy wendewing of what’s nyew and changed in specific vewsions. Pwease see Vewsion Guawantees fow mowe infowmation.

v2.10.0a [UNWEWEASED]

Depwecations

• Client.fetch_premium_sticker_packs() was wenyamed to Client.fetch_sticker_packs(); the owd nyame is depwecated. (#1082)

Nyew Featuwes

• Muv asset pwopewties fwom Activity to aww a-a-activity t-types: large_image_url, small_image_url, large_image_text, small_image_text. (#687)

• Suppowt activity assets with mp: pwefix in Activity.large_image_url and Activity.small_image_url, nyow wetuwnying the cowwect uww. (#687)

• [ext.commands] Skip evawuating annyotations of self (if pwesent) and ctx pawametews in pwefix commands. These may nyow use stwingified annyotations with types that awen’t avaiwabwe at wuntime. (#847)

• Add guild_scheduled_event pawametew to StageChannel.create_instance(). (#882)

• Added with_counts pawametew to Client.fetch_guild() and Client.fetch_guilds(), used to detewminye whethew to incwude the guiwd’s membew count and pwesence infowmation. (#892)

• Muv the event wistenyew system impwementation fwom ext.commands.Bot to Client, making Cwients abwe to have mowe than onye wistenyew pew event type. (#975)

• Add delete_after p-p-pawametew to Interaction.edit_original_response(), InteractionResponse.edit_message() and InteractionMessage.edit(). (#1014)

• Make Interaction and subtypes accept the bot type as a genyewic pawametew to denyote the type wetuwnyed by the bot and client pwopewties. (#1036, #1121)

• [ext.commands] Impwement app_check() and app_check_any() decowatows. (#1045)

• [ext.commands] Wog e-e-ewwows waised by ext.commands.Cog.cog_unload(). (#1046)

• Add suppowt f-f-fow media channyews. (#1050)

  • Add MediaChannel.

    • Unwess othewwise nyoted, media channyews behave just wike fowum channyews.

  • Add ChannelType.media.

  • Add CategoryChannel.media_channels, Guild.media_channels.

  • Add CategoryChannel.create_media_channel, Guild.create_media_channel.

  • Add ChannelFlags.hide_media_download_options.

• Add RoleFlags type and Role.flags. (#1069)

• Add AttachmentFlags type and Attachment.flags. (#1073)

• Add suppowt fow thweads in Webhook.fetch_message(), edit_message(), and delete_message(), as weww as theiw sync countewpawts. (#1077)

• Add default_layout pawametew to Guild.create_forum_channel() and ForumChannel.clone(). (#1078)

• Add RawReactionActionEvent.message_author_id. (#1079)

• Add AuditLogAction vawues wewated to cweatow monyetization. (#1080)

• Add applied_tags pawametew to Webhook.send(). (#1085)

• Make CustomActivity.state faww back to the pwovided name, simpwifying setting a custom status. (#1087)

• A-A-Add Permissions.create_guild_expressions and Permissions.create_events. (#1091)

• Add TeamMember.role. (#1094)

• [ext.commands] Update Bot.is_owner to take team membew wowes into account. (#1094)

• Add created_at pwopewty to AutoModRule, ForumTag, Integration, StageInstance, and Team. (#1095)

• Suppowt integration_type fiewd in AuditLogEntry.extra (fow kick and member_role_update actions). (#1096)

• Add nyew Colours: light_embed() a-a-and dark_embed(). (#1102)

• Suppowt appwication subscwiptions (see the officiaw d-docs fow mowe info). (#1113)

  • Nyew t-t-types: SKU, Entitlement.

  • Nyew Interaction.entitlements attwibute, and InteractionResponse.require_premium() wesponse type.

  • Nyew events: on_entitlement_create(), on_entitlement_update(), on_entitlement_delete().

  • Nyew Client methods: skus(), entitlements(), create_entitlement().

• Suppowt Python 3.12. (#1117, #1128, #1135)

• [ext.commands] Suppowt Python 3.12’s type statement a-and typing.TypeAliasType annyotations in command signyatuwes. (#1128)

• Add Locale.es_LATAM wocawe. (#1148)

• Make typing mowe pwecise fow Client.create_global_command(), Client.edit_global_command(), Client.create_guild_command() and Client.edit_guild_command(). (#1151)

• Add waw equivawent of on_presence_update() - on_raw_presence_update(). (#1152)

• Add banner pawametew to ClientUser.edit(). (#1165)

Bug F-F-Fixes

• [ext.commands] Fix incowwect typings of InvokableApplicationCommand.add_check, InvokableApplicationCommand.remove_check, Bot.add_app_command_check and Bot.remove_app_command_check. (#1045)

• Update Colour.dark_theme() to match Discowd theme change. (#1102)

• Awwow cls awgument in sewect menyu decowatows (e.g. ui.string_select()) to be specified by keywowd instead of being positionyaw-onwy. (#1111)

• [ext.commands] Fix edge case in evawuation of muwtipwe identicaw annyotations with fowwawdwefs in a singwe s-signyatuwe. (#1120)

• Fix Thread.permissions_for() nyot wowking in some cases due to an incowwect impowt. (#1123)

• [ext.commands] Fix ewwonyeous LocalizationWarnings w-w-when using wocawized swash command pawametews in cogs. (#1133)

• Update choices type in app commands to accept any Sequence ow Mapping, instead of the mowe constwainyed list/dict types. (#1136)

• Handwe unyexpected RECONNECT opcode whewe HELLO is expected duwing inyitiaw shawd connyection. (#1155)

• Weconnyect gateway websocket on pwotocow ewwows. (#1159)

• Adjust type annyotations to awwow Object a-as category pawametew in Guild.create_text_channel() and simiwaw methods. (#1162)

• Avoid AttributeError in FFmpegAudio when cweanying up aftew faiwing to spawn ffmpeg pwocess. (#1164)

Documentation

• Add inhewited attwibutes to TeamMember, and fix TeamMember.avatar d-d-documentation. (#1094)

• Miscewwanyeous gwammaw/typo fixes fow Audit W-W-Wogs. (#1105)

• Document the Option attwibutes, the description and options pwopewties fow ext.commands.InvokableSlashCommand and the description and body pwopewties fow ext.commands.SubCommand. (#1112)

• Make aww “Suppowted Opewations” containyew ewements cowwapsibwe. (#1126)

• Adding some c-c-cwawifying documentation awound the executabwe pawametews of audio cwasses based off of intewnyaw discussions. (#1158)

Miscewwanyeous

• Update the python -m disnake newcog tempwate to incwude a-a-aww missing speciaw methods. (#808)

• Ovewhauw and simpwify contwibution guide. (#1098)

• [ext.commands] Wewwite swash command signyatuwe evawuation to use the same mechanyism as pwefix command signyatuwes. This shouwd nyot have an impact on usew code, but stweamwinyes futuwe changes. (#1116)

• Stawt testing with Python 3.12 in CI. (#1117)

• Add StandardSticker to stickers pawametew type annyotation of Messageable.send() and ForumChannel.create_thread(). (#1134)

• Weduce t-the amount of unknyown (unwesowved) types in pubwic-facing APIs. (#1167)

v2.9.1

Bug Fixes

• Awwow cls awgument in sewect menyu decowatows (e.g. ui.string_select()) to be specified by keywowd instead of being positionyaw-onwy. (#1111)

• [ext.commands] Fix edge case in evawuation of muwtipwe identicaw annyotations w-with fowwawdwefs in a singwe s-s-signyatuwe. (#1120)

• Fix Thread.permissions_for() nyot wowking in some cases due to an incowwect impowt. (#1123)

Documentation

• Miscewwanyeous gwammaw/typo fixes fow Audit Wogs. (#1105)

v2.9.0

This wewease comes with s-s-suppowt fow the n-nyew usewnyame system, text in stage, wowe subscwiptions, siwent messages, and onboawding. The documentation has b-been updated, spwitting the monyowithic API Wefewence page into smawwew pages.

See bewow f-fow a compwete wist of changes.

Depwecations

• AutoModTriggerType.harmful_link is obsowete, it is nyow enyabwed Discowd-wide. (#986)

• The PartyType enyum is depwecated, as voice activity IDs awe nyot officiawwy documented and the enyum weguwawwy becomes outdated. (#1035)

• [ext.commands] Range and String nyow wequiwe a type awgument (i.e. Range[int, 1, 5] instead of Range[1, 5], simiwawwy with String[str, 2, 4]). The owd fowm is depwecated. (#991)

• [ext.commands] The mypy pwugin is nyow a nyo-op. It was pweviouswy used fow suppowting Range[] and String[] annyotations. (#991)

Nyew Featuwes

• Cwonye most attwibutes in TextChannel.clone(), VoiceChannel.clone(), StageChannel.clone(), CategoryChannel.clone(), and ForumChannel.clone(), and add them as keywowd-onwy p-pawametews to make in-pwace edits. See the specific clone method’s documentation fow detaiws. (#635)

• Add Guild.max_stage_video_channel_users. (#741)

• Impwement nyew AutoModTriggerMetadata.mention_raid_protection_enabled pawametew. (#898)

• Add suppowt fow waid awewts. (#899)

  • A-A-Add Guild.safety_alerts_channel.

  • Add raid_alerts_disabled and safety_alerts_channel pawametews to Guild.edit().

• Add featuwes wewated to wowe subscwiptions. (#904, #913)

  • Nyew message type: role_subscription_purchase.

  • Nyew wowe tags: RoleTags.subscription_listing_id, RoleTags.is_available_for_purchase, and RoleTags.is_subscription.

  • Nyew type RoleSubscriptionData and attwibute Message.role_subscription_data.

  • Nyew system channyew fwags: role_subscription_purchase_notifications and role_subscription_purchase_notification_replies.

• Add oldest_first pawametew to Guild.audit_logs(). (#919)

• Impwement Onboawding. (#928)

  • Add Onboarding, OnboardingPrompt and OnboardingPromptOption.

  • Add Guild.onboarding().

• Add flags pawametew to message send and edit methods. (#929)

• Add MessageFlags.suppress_notifications. (#929)

• Messages can nyow be sent within StageChannel instances. (#942)

  • StageChannel nyow inhewits fwom abc.Messageable

  • N-N-Nyew StageChannel pwopewties:

    .nsfw, .slowmode_delay, .last_message_id, .last_message

  • Nyew StageChannel methods:

    .is_nsfw, .get_partial_message, .delete_messages, .purge, .webhooks, .create_webhook

  • Add nsfw and slowmode_delay pawametews to Guild.create_stage_channel() a-and CategoryChannel.create_stage_channel()

  • Add nsfw and slowmode_delay pawametews to StageChannel.edit()

  • Add text wewated pewmission suppowt to StageChannel.permissions_for().

• N-N-Nyew message types that awe sent within StageChannel i-instances: (#942)

  • MessageType.stage_start, MessageType.stage_end, MessageType.stage_speaker, and MessageType.stage_topic.

• Add edit suppowt fow user_limit to StageChannel.edit(). (#942)

• Add suppowt fow setting user_limit and video_quality_mode when cweating a StageChannel with Guild.create_stage_channel(). (#942)

• Cweanyup genyewaw ewwow waising to be wess confusing. (#950)

  • O-Ovewaww, most ewwows about incowwect types nyo w-w-wongew incwude the intewnyaw ewwow in theiw twaceback.

• Add suppowt fow AutoModBlockMessageAction.custom_message (#954)

• Suppowt compawison of VoiceRegion o-o-objects. (#962)

• Add a nyew voice c-c-channyew activity, PartyType.gartic_phone. (#984)

• Add ApplicationFlags.application_auto_moderation_rule_create_badge (#988)

• Add nyew pewmission fiewds. (#989, #997, #1006)

  • Permissions.manage_guild_expressions (which manage_emojis and manage_emojis_and_stickers awe nyow awiased to)

  • Permissions.view_creator_monetization_analytics

  • Permissions.use_soundboard

  • Permissions.send_voice_messages

  • Permissions.use_external_sounds

• Add suppowt fow nyew usewnyame s-s-system - see the officiaw hewp awticwe fow detaiws. Existing functionyawity is kept backwawds-compatibwe whiwe the migwation is stiww ongoing. (#1025, #1044)

  • Add User.global_name, and update attwibutes/methods to account fow it:

    • User.display_name and Member.display_name

    • Guild.get_member_named()

  • Update str(user) and str(member) to nyot incwude #0 discwiminyatow of migwated usews.

  • Adjust User.default_avatar to account fow nyew defauwt avataw handwing, awso adding DefaultAvatar.fuchsia.

• Suppowt animated emoji fiewd in weaction wemovaw events (e.g. on_raw_reaction_remove()). (#1040)

• Impwement weceiving voice messages. (#1041)

  • Nyew fwag: MessageFlags.is_voice_message

  • Nyew Attachment fiewds: duration, waveform

• [ext.commands] Add Bot.get_listeners(). (#976)

• [ext.commands] UserConverter and MemberConverter, nyow mostwy match the behaviow of Guild.get_member_named()

Bug Fixes

• Fix a bug with ForumChannel.clone() nyot pwopewwy c-c-copying the default_auto_archive_duration attwibute into the nyewwy-cwonyed channyew. (#635)

• Fix VoiceClient nyot continyuing to pway audio when m-m-moving between channyews. (#845)

• Pwevent stway voice websocket heawtbeat thweads aftew weconnyecting. (#863)

• Fix KeepAwive wogging u-un-intentionyawwy attempting to intewpowate stack twace woggew cawws (#940)

• Fix VoiceChannel.permissions_for() nyot disabwing Permissions.manage_webhooks when the usew cannyot connyect to the channyew. (#942)

• RawTypingEvent.timestamp is nyow a-a-a timezonye-awawe datetime instead of a nyaive onye. (#945)

• Fix attwibute ewwow when attempting to access DMChannel.flags undew cewtain ciwcumstances. (#960)

• Fix voice connyection discuvwy using incowwect packet sizes. (#967)

• Fix Guild.get_or_fetch_members() nyot caching anything i-i-in the case of 1 unwesowved ID. (#974)

• Fix audit wog pawsing issue with nyew usew pwofiwe automod actions. (#995)

• Impwuv GuildSticker desewiawization, fix GuildSticker.edit() pawametew types t-t-to match documentation. (#996)

• Fix ForumChannel.create_thread() usage with fiwes onwy (and nyo othew content), and fix fiwe descwiptions n-nyot being sent o-on thwead cweation. (#1008)

• Fix some instances whewe thweads wewe nyot being wetuwnyed in AuditLogEntry.extra. (#1009)

• Guild.fetch_members() nyo wongew wequiwes the members intent to be enyabwed when connyecting to the gateway, nyow it sowewy depends on the intent being enyabwed in the devewopew powtaw. (#1013)

• Fix ewwow w-when twying to access Client.application_flags if an application_id was passed to the constwuctow. (#1027)

• Waise TypeError in Guild.create_automod_rule() and AutoModRule.edit() when an action has an invawid type, instead of a wathew cwyptic ewwow. (#1030)

• Fix pewmission w-wesowution fow Threads t-t-to use Permissions.send_messages_in_threads instead of Permissions.send_messages fow cawcuwating impwicit pewmissions. (#1047)

• Fix typing issue with abc.User pwotocow wequiwements, which pweviouswy wesuwted in User and Member nyot confowming to the pwotocow. (#1051)

• [ext.commands] Awwow wefewencing the same PawamInfo instance in muwtipwe signyatuwes. (#946)

• [ext.commands] Fix type-checkew suppowt fow Range and String by wequiwing type awgument (i.e. Range[int, 1, 5] instead of Range[1, 5]). (#991)

• [ext.commands] Waise TypeError if InteractionBot ow AutoShardedInteractionBot h-has pwefix commands wewated t-things in a Cog (#1018)

• [ext.commands] Fix membew nyicknyame nyot being used by clean_content convewtew when usew wasn’t found in mentions. (#1029)

Documentation

• Spwit the m-m-monyowithic API Wefewence pages into muwtipwe sub-wefewences. (#392)

  • Main disnake API wefewence can nyow be found at API Wefewence.

  • disnake.ext.commands API wefewence is nyow undew C-C-Commands API Wefewence.

  • Wegacy api.html and ext/commands/api.html pages awe depwecated.

  • • Winks with pwe-existing wefewences (eg /api.html#disnake.AppInfo) wiww be wediwected to theiw appwopwiate page.

• Update automod wuwe wimits. (#931)

• Wemuv incowwect documentation fow InvokableApplicationCommand.invoke(). (#961)

• Add a seawchbox fow fiwtewing the sidebaw on the API Wefewence pages. (#963)

• Cwawify docs about the on_member_update() and on_raw_member_update() events. (#992)

• Wemuv pins() method fwom unsuppowted channyew types. (#1033)

• Update “Cweating a Bot Account” page with nyewew images and synchwonyise info accowding to w-w-watest changes made by Discowd. (#1039)

• Add nyote to GuildChannel.create_invite and aww subcwasses about the nyew 30 day expiwation wimit imposed fow nyon-communyity guiwds. (#1056)

• [e-ext.commands] Fix commands e-extension events being dupwicated in seawch wesuwts. (#944)

Miscewwanyeous

• Change dependency and enviwonment manyagement t-to use pdm. (#836, #953)

  Pwease check CONTWIBUTING.md fow mowe detaiws.

• Change the main wintew to ruff instead of flake8. (#935)

• Update Sphinx to v7.0.1. (#936, #1020)

• Suppowt PyNyaCw v1.5. (#968)

• Wemuv disnake.utils.parse_token() (nyevew documented), which has been bwoken fow nyewew tokens fow some time, and was based on unyofficiaw infowmation about the token stwuctuwe. (#990)

• Update typings of Message.activity and intewnyaw Team paywoads to match API documentation. (#996)

• Incwease the defauwt Guild.filesize_limit fwom 8MB to 25MB, matching the wecent incwease by Discowd. (#1005)

v2.8.2

This maintainyence wewease c-contains backpowts fwom v2.9.0.

Bug Fixes

• Fix audit wog pawsing issue with n-nyew usew pwofiwe automod actions. (#995)

• Impwuv GuildSticker desewiawization, fix GuildSticker.edit() pawametew types to match documentation. (#996)

• Fix ForumChannel.create_thread() usage with fiwes onwy (and nyo othew content), and fix fiwe descwiptions nyot being sent on thwead cweation. (#1008)

Miscewwanyeous

• Update t-t-typings of Message.activity and intewnyaw Team paywoads to match API documentation. (#996)

• Incwease the defauwt Guild.filesize_limit fwom 8MB to 25MB, matching the wecent incwease by Discowd. (#1005)

v2.8.1

Bug Fixes

• Fix VoiceClient nyot continyuing to pway audio when moving between channyews. (#845)

• Fix KeepAwive wogging un-intentionyawwy attempting to intewpowate stack t-twace woggew cawws (#940)

• Fix attwibute ewwow when attempting to access DMChannel.flags u-u-undew cewtain ciwcumstances. (#960)

• Fix voice connyection discuvwy using incowwect packet sizes. (#967)

Documentation

• Update automod wuwe wimits. (#931)

v2.8.0

This w-w-wewease comes with suppowt fow NSFW appwication commands, the on_audit_log_entry_create() event, and a nyew Event enyum fow use with methods wike Client.wait_for().

Bweaking C-C-Changes

• StickerPack.cover_sticker_id, .cover_sticker and .banner awe nyow optionyaw and may w-wetuwn None. (#912)

• AuditLogEntry.user may nyow be an Object if the u-usew cannyot be found, pawticuwawwy in entwies fwom the on_audit_log_entry_create() event. (#920)

Nyew Featuwes

• Add GuildBuilder and Client.guild_builder() fow fuww cuvwage of the guiwd cweation endpoint. (#578)

• Suppowt wegex within automod using AutoModTriggerMetadata.regex_patterns. (#794)

• Add File.closed a-and File.bytes_length pwopewties. (#839)

• Add TextChannel.default_thread_slowmode_delay. (#854)

• Add suppowt fow NSFW appwication commands. (#865)

  • Add ApplicationCommand.nsfw.

  • Add nsfw pawametew to c-c-command constwuctows and decowatows.

• A-A-Add UserFlags.active_developer and PublicUserFlags.active_developer. (#866)

• Adds weasons/descwiptions to ConnectionClosed ewwows. (#873)

• Update AutoModTriggerMetadata uvwwoads to awwow passing allow_list to keywowd-based wuwes. (#877)

• The PublicUserFlags.discord_certified_moderator is n-nyow an awias of PublicUserFlags.moderator_programs_alumni. (#883)

• Add ForumChannel.default_layout, and default_layout pawametew to channyew edit methods. (#885, #903)

• Add Locale.id (Indonyesian) wocawe. (#890)

• Adds Event enyumewation to use in Client.wait_for(), disnake.ext.commands.Bot.wait_for() and in disnake.ext.commands.Bot.listen() decowatow. (#895)

• Add nyew MessageType.interaction_premium_upsell and MessageType.guild_application_premium_subscription message types. (#905)

• Add appwication wowe connyection featuwes. (#906)

  • Add ApplicationRoleConnectionMetadata and ApplicationRoleConnectionMetadataType types.

  • Add Client.fetch_role_connection_metadata and Client.edit_role_connection_metadata methods.

  • Add RoleTags.is_linked_role and AppInfo.role_connections_verification_url attwibutes.

• Add StickerFormatType.gif. (#910)

• Add suppowt fow the on_audit_log_entry_create() gateway event, and add Intents.moderation intent. Intents.bans is nyow an awias of Intents.moderation. (#915)

• Add flags pwopewty to Member. (#918)

• Add fawwback to Object fow AuditLogEntry.user (#920)

Bug F-F-Fixes

• [ext.commands] Fix help_command pawametew annyotations to awwow None vawue. (#849)

• Fix usew cache memowy weak whewe unyused objects wewen’t being evicted (pwovided that Intents.members i-i-is enyabwed). (#858)

• Fix Message.author.public_flags awways being 0 when the membew cache is disabwed. (#870)

• Expowt missing ThreadWithMessage cwass. (#879)

• Add pweviouswy missing applied_tags p-p-pawametew to aww ForumChannel.create_thread() uvwwoads. (#880)

• Fix convewsion o-of custom emoji stwings (e.g. <:this:934852112221872198>) i-in Message.add_reaction() and simiwaw methods to mowe stwictwy adhewe to the API documentation. (#887)

• Fix Client.delete_guild_command() nyot updating the wocaw command cache. (#907)

• Fix ewwows when twying to desewiawize stickews with unknyown fowmats. (#911)

• Make StickerPack.cover_sticker_id, .cover_sticker and .banner optionyaw. (#912)

• Fix handwing of ECONNRESET ewwows on Winyux. (#921)

Documentation

• E-E-Enyabwe OpenSeawch, awwowing e-e-easy integwation of t-t-the seawch functionyawity into bwowsews. (#859)

• Cwawify types of optionyaw Invite attwibutes. (#864)

• Wemuv documentation wegawding pwivate thweads wequiwing boosts. (#872)

• Update AutoModTriggerMetadata fiewd wimits. (#877)

Miscewwanyeous

• Decwawe a PEP 517 buiwd backend in pypwoject.tomw, and u-use PEP 621 to definye most package metadata. (#830)

v2.7.2

Bug F-F-Fixes

• Fix VoiceClient nyot continyuing to p-pway audio when moving b-between channyews. (#845)

• Fix KeepAwive wogging un-intentionyawwy attempting to intewpowate stack twace woggew cawws (#940)

• Fix attwibute ewwow when attempting to access DMChannel.flags undew cewtain ciwcumstances. (#960)

• Fix voice connyection discuvwy using incowwect packet sizes. (#967)

v2.7.1

Bug Fixes

• Fix Message.author.public_flags awways being 0 when the membew cache is disabwed. (#870)

• Expowt missing ThreadWithMessage cwass. (#879)

• Fix Client.delete_guild_command() nyot updating the wocaw command cache. (#907)

• Fix ewwows when twying to desewiawize stickews with unknyown fowmats. (#911)

v2.7.0

This wewease comes with suppowt fow python 3.11 and nyew sewects.

Bweaking Changes

• Pwopewwy document that Message.system_content may wetuwn None. Whiwe this is documented as a bweaking change, this function awways couwd wetuwn None if the message type was nyot wecognyised. (#766)

• Wenyame InteractionDataResolved.get() to get_by_id(). (#814)

Depwecations

• Wenyame ApplicationCommandInteractionDataResolved to InteractionDataResolved. (#814)

• [ext.commands] Depwecate the sync_commands, sync_commands_debug, and sync_commands_on_cog_unload pawametews of Bot and InteractionBot. These have been wepwaced with the command_sync_flags pawametew which takes a CommandSyncFlags instance. (#806)

Nyew Featuwes

• Update Message.system_content to be accuwate to the cwient as of Octobew 2022. (#766)

  • This awso pwopewwy documents that it is possibwe to wetuwn None.

• Add type hints to aww fwag constwuctows, nyow suppowting t-t-type-checking fow cweating fwag cwasses (e.g. Intents(members=True)) which used to be untyped. (#778)

• Add GuildScheduledEvent.start(), .end a-and .cancel showtcuts. (#781)

• Suppowt Python 3.11. (#785, #827, #829, #833)

• Impwuv the cwi, awwowing the usage of ext.commands.InteractionBot, ext.commands.AutoShardedInteractionBot. (#791)

• Add nyew sewect menyu componyents. (#800, #803)

  • Add nyew ComponentType vawues.

  • Add UserSelectMenu, RoleSelectMenu, MentionableSelectMenu, ChannelSelectMenu componyents.

  • A-Add ui.UserSelect, ui.RoleSelect, ui.MentionableSelect, ui.ChannelSelect UI types.

  • Add ui.user_select(), ui.role_select(), ui.mentionable_select(), ui.channel_select() decowatows.

  • Add ui.ActionRow.add_user_select(), add_role_select(), add_mentionable_select(), add_channel_select()

  • Wenyamed stwing sewect types fow cwawity (pwevious nyames wiww continyue to wowk):

    • SelectMenu -> StringSelectMenu

    • ui.Select -> ui.StringSelect

    • ui.select() -> ui.string_select()

    • ui.ActionRow.add_select() -> ui.ActionRow.add_string_select()

  • Add MessageInteraction.resolved_values and MessageInteractionData.resolved.

• Suppowt delete_after pawametew when sending ephemewaw intewaction wesponses. (#816)

• Awwow slowmode_delay pawametew of ForumChannel.create_thread() to be optionyaw. (#822)

• Add suppress_embeds pawametew to Interaction.edit_original_response() and InteractionMessage.edit(). (#832)

• [ext.commands] Add CommandSyncFlags to pwovide sync configuwation to Bot a-and InteractionBot (and theiw autoshawded vawiants) as command_sync_flags. (#265, #433, #468, #806)

Bug Fixes

• Add the missing attwibutes fow PermissionOverwrite: use_application_commands and use_embedded_activities. (#777)

• Ensuwe that embed fiewds awe copied pwopewwy by Embed.copy() and that t-t-the copied embed is compwetewy sepawate fwom the owiginyaw onye. (#792)

• Fix an issue with Member.ban() ewwowing when the delete_message_days pawametew was pwovided. (#810)

• Twy to get thweads used in i-intewactions (wike thweads in command awguments) fwom the cache fiwst, befowe cweating a nyew instance. (#814)

• Fix cweation of thweads in text c-c-channyews without Permissions.manage_threads. (#818)

• Fix o-off-by-onye ewwow in AutoModKeywordPresets v-vawues. (#820)

• Update e-e-event woop handwing t-t-to avoid wawnyings when wunnying on Python 3.11. (#827)

• [ext.commands] Fix a case whewe optionyaw vawiadic awguments couwd have i-i-infinyite woops in pawsing depending on the usew input. (#825)

Documentation

• Speed up page woad by changing huvwxwef toowtips t-t-to be waziwy woaded. (#393)

• Wemuv wefewence to the v1.0 migwation guide fwom the main index page, and muv wegacy changewogs to a sepawate page. (#697)

• Update sphinx fwom vewsion 5.1 to 5.3. (#764, #821)

• Add a-a nyote wawnying mentionying that using a disnake.File object as fiwe kwawg makes a disnake.Embed nyot weusabwe. (#786)

• Update bwoken Discowd API Docs winks, add :ddocs: wowe fow easiwy cweating winks to the API documentation. (#793)

• Add a custom 404 page fow when the nyavigated page does nyot exist. (#797)

Miscewwanyeous

• Incwease the uppew bound fow the aiohttp dependency fwom <3.9 to <4. (#789)

• Use importlib.metadata instead of the depwecated pkg_resources in the cwi fow dispwaying the vewsion. (#791)

• [ext.commands] Add missing py.typed mawkew. (#784)

• [ext.tasks] Add missing py.typed mawkew. (#784)

v2.6.3

This maintainyence wewease c-contains backpowts fwom v2.8.0.

Bug Fixes

• Fix Message.author.public_flags awways being 0 when the membew cache is disabwed. (#870)

• Expowt missing ThreadWithMessage c-c-cwass. (#879)

• Fix Client.delete_guild_command() nyot updating the wocaw command cache. (#907)

• Fix ewwows when twying to desewiawize s-s-stickews with unknyown fowmats. (#911)

v2.6.2

This maintainyence wewease contains backpowts fwom v2.7.0.

Bug F-Fixes

• Fix cweation of thweads i-in text channyews without Permissions.manage_threads. (#818)

• Fix off-by-onye ewwow in AutoModKeywordPresets vawues. (#820)

• [ext.commands] Fix a case w-w-whewe optionyaw vawiadic awguments couwd have infinyite woops in pawsing depending on the usew input. (#825)

v2.6.1

This maintainyence wewease contains backpowts fwom v2.7.0.

Bug Fixes

• Ensuwe that embed fiewds awe copied pwopewwy by Embed.copy() and that the c-c-copied embed is compwetewy sepawate fwom the owiginyaw onye. (#792)

• Fix an issue with Member.ban() ewwowing when the delete_message_days pawametew was pwovided. (#810)

v2.6.0

This wewease adds suppowt fow nyew fowum channyew featuwes (wike tags) as weww as auto modewation, among othew things. See bewow fow mowe.

Awso nyote the bweaking changes w-w-wisted bewow, which may wequiwe additionyaw code changes.

Bweaking Changes

• Update Client cwasses such that theiw inyitiawization kwawgs awe expwicitwy stated and typehinted. (#371)

  • Wepwaced **kwargs / **options with expwicit keywowd a-awguments fow t-the __init__ methods of Client, ext.commands.Bot, ext.commands.InteractionBot, aww AutoSharded* vawiants, and aww wewevant pawent cwasses.

• Caww nyew disnake.on_gateway_error() instead of wetting exceptions p-pwopagate that occuwwed whiwe desewiawizing a weceived gateway event. (#401)

• Wewowk Embed intewnyaws. (#435)

  • Embed.set_footer() nyow wequiwes the text pawametew.

  • Embed.type is nyow optionyaw, awthough this couwd pweviouswy be Embed.Empty.

  • EmptyEmbed and Embed.Empty awe depwecated in favow of None, have been wemuvd fwom the documentation, and wiww wesuwt in type-checking ewwows.

• Wefactow ui.ActionRow with compwete typings. (#462)

  • ui.ActionRow.children nyow wetuwns an immutabwe Sequence instead of a list.

• W-W-Wemuv InvalidArgument and wepwace it with TypeError a-and ValueError. (#471)

• Wenyame channel_id pawametew to channel on Guild.create_scheduled_event and GuildScheduledEvent.edit(). (#548, #590)

• Waise TypeError instead of ValueError in GuildScheduledEvent vawidation. (#560)

• Assume the wocaw timezonye instead of UTC when pwoviding nyaive datetimes to scheduwed event wewated methods. (#579)

• Update ModalInteraction typings. (#583)

  • ModalInteraction.walk_components is wepwaced by ModalInteraction.walk_raw_components().

• Change the defauwt of the ignore_timeout pawametew fow aww permissions_for methods to False. (#672)

• Update activity attwibutes to match API types. (#685)

  • M-M-Make Spotify.start, Spotify.end, Spotify.duration optionyaw.

  • Wemuv Activity.timestamps, vawues awe accessibwe thwough Activity.start, Activity.end.

  • Change type of Activity.buttons to Wist[str].

• Wemuv WidgetMember.nick; WidgetMember.name contains the membew’s nyicknyame, if set. (#736)

• [ext.commands] Change has_permissions and bot_has_permissions checks to take timeouts into considewation. (#318, #672)

• [ext.commands] Change commands.register_injection to nyow wetuwn an instance o-of Injection. (#669)

• [ext.commands] Changed pawametews of SubCommand and SubCommandGroup to nyow wequiwe theiw pawent command. (#759)

  • This onwy affects code that cweates an instance of SubCommand ow SubCommandGwoup manyuawwy by cawwing theiw constwuctows.

• [ext.tasks] Change ext.tasks.Loop to use keywowd-onwy pawametews. (#655)

Depwecations

• EmptyEmbed and Embed.Empty awe depwecated in favow of None, have been wemuvd fwom the documentation, and wiww wesuwt in type-checking ewwows. (#435, #768)

• The delete_message_days pawametew of Guild.ban() and Member.ban() is depwecated in favouw of clean_history_duration. (#659)

• [e-e-ext.commands] Using command_prefix=None with Bot is nyow depwecated in favouw of InteractionBot. (#689)

Nyew Featuwes

• Add custom type suppowt fow disnake.ui.button() and disnake.ui.select() decowatows using cls pawametew. (#281)

• Add disnake.on_gateway_error(), Client.on_gateway_error() and enable_gateway_error_handler cwient pawametew. (#401)

• Update channyew edit method annyotations. (#418)

  • slowmode_delay and default_auto_archive_duration awe nyow optionyaw.

  • category may nyow be any abc.Snowflake, nyot nyecessawiwy a CategoryChannel.

• Add nyew ui.ActionRow methods: insert_item(), clear_items(), remove_item(), pop(), as w-weww as an index pawametew fow add_button(). (#462)

  • Awso suppowt item access/dewetion thwough row[i].

• Expose the icon and wecipient data fow Invites whose tawget is a channyew of t-t-type ChannelType.group. (#498)

• Impwement auto m-m-modewation. (#530, #698, #757)

  • Nyew types: AutoModAction, AutoModTriggerMetadata, AutoModRule, AutoModActionExecution

  • Nyew enyums: AutoModTriggerType, AutoModEventType, AutoModActionType

  • Nyew fwags: AutoModKeywordPresets

  • Nyew methods: Guild.create_automod_rule(), Guild.fetch_automod_rule(), Guild.fetch_automod_rules()

  • Nyew intents: Intents.automod_configuration, Intents.automod_execution (+ Intents.automod showtcut fow both)

  • Nyew events: on_automod_rule_create(), on_automod_rule_update(), on_automod_rule_delete(), on_automod_action_execution()

  • + aww the wewevant AuditLogEntry and AuditLogChanges fiewds.

• E-Expose additionyaw pwovided o-objects by Discowd in audit wog handwing. (#532)

  • Awso adds PartialIntegration, and an integration attwibute on AuditLogEntry.extra w-when the type is AuditLogAction.application_command_permission_update.

• Add Webhook.application_id fow accessing the I-I-ID of the a-app that cweated the webhook, if any. (#534)

• Use SessionStartLimit.remaining when attempting to connyect to Discowd. (#537)

  • Nyow waises SessionStartLimitReached if t-thewe awe nyot enyough wemainying stawts to stawt the cwient.

• Add muwtipwe convewtews f-fow pweviouswy undocumented fiewds fow audit wogs. (#546)

  AuditLogDiff can nyow have the fowwowing attwibutes with the specified types:

  • flags — ChannelFlags

  • system_channel_flags — SystemChannelFlags

  AuditLogDiff.unicode_emoji, used fow wowe icons, was wenyamed to AuditLogDiff.emoji.

• Impwement ChannelFlags on aww channyew types. (#547)

• Make aww *IntewactionData datacwasses dicts (MessageInteractionData, ApplicationCommandInteractionData, and s-s-so on). (#549)

• Add suppowt fow Webhook in ForumChannel instances. (#550)

• A-A-Add GuildScheduledEvent.created_at and GuildScheduledEvent.url pwopewties. (#561)

• Add the Embed.check_limits() method to check if an Embed wouwd be wejected fwom Discowd. (#567)

• Add bitrate pawametew to Guild.create_stage_channel(). (#571)

• Add Guild.edit_mfa_level() fow modifying the guiwd’s MFA wevew. (#574)

• Add the slowmode_delay pawametew to Guild.create_voice_channel(). (#582)

• Add ModalInteractionData.components. (#583)

• Add the Interaction.app_permissions pwopewty, which shows the app pewmissions in the channyew. (#586)

• Awwow entity_type pawametew Guild.create_scheduled_event to be missing. (#590)

• Add min_length and max_length suppowt to Option and ext.commands.Param. (#593)

• Add AllowedMentions.from_message fow constwucting a-a-an awwowed mentions object fwom a Message. (#603)

• Add suppowt of mowe opewatows to aww Flag cwasses. This w-w-wist incwudes Intents a-and Permissions. (#605, #615, #616)

  • &, |, ^, and ~ bitwise opewatow suppowt.

  • <, <=, >, and >= compawsion opewatow suppowt.

  • Suppowt | opewatows between fwag instances and fwag vawues.

  • Suppowt ~ opewatow on fwag vawues, which cweate a fwag instance with aww except this specific fwag enyabwed.

  • Suppowt | opewatows between fwag vawues which cweate a fwag instance with both fwag vawues enyabwed.

• Suppowt passing waw integew v-v-vawue to Intents c-c-constwuctow. (#613)

• A-A-Add GuildScheduledEventStatus.cancelled as an awias fow canceled. (#630)

• Add on_raw_member_remove() and on_raw_member_update() events, with the RawGuildMemberRemoveEvent modew. (#638)

• Add Thread.message_count, Thread.total_message_sent and Message.position attwibutes. (#640)

• Add s-suppowt fow setting ChannelFlags diwectwy when editing a channyew ow thwead. (#642)

• Add ApplicationFlags.application_command_badge fwag which shows whethew an appwication has at w-weast onye gwobawwy wegistewed a-appwication command. (#649)

• Add suppowt fow Interaction.data which guawantees that evewy subcwass of Interaction has the data attwibute. (#654)

• Add clean_history_duration pawametew to Guild.ban() and Member.ban(). (#659)

• Add Game.assets. (#685)

• Add pewmission typings to aww methods that take pewmissions diwectwy, fow exampwe disnake.abc.GuildChannel.set_permissions() and disnake.ext.commands.bot_has_permissions() to nyame a f-f-few. (#708)

• Add GatewayParams fow configuwing gateway connyection pawametews (e.g. disabwing compwession). (#709)

• Add resume_gateway_url handwing to gateway/websocket wesume fwow. (#709, #769)

• Add suppowt fow modifying the INVITES_DISABLED g-guiwd featuwe using Guild.edit(). (#718)

• Impwement wemainying fowum channyew featuwes. (#724)

  • Add ForumTag datacwass.

  • Add ForumChannel.available_tags and Thread.applied_tags.

  • Add ForumChannel.get_tag(), ForumChannel.get_tag_by_name(), Thread.add_tags() and Thread.remove_tags().

  • Add ForumChannel.default_thread_slowmode_delay, ForumChannel.default_reaction, and ForumChannel.default_sort_order.

  • Add ChannelFlags.require_tag and ForumChannel.requires_tag.

  • Nyew audit wog fiewds fow the abuv featuwes.

• Add BotIntegration.scopes. (#729)

• Wetuwn the disnake.ui.View instance fwom View.add_item, View.remove_item and View.clear_items to awwow fow fwuent-stywe chainying. (#733)

• Add Widget.presence_count. (#736)

• Add InteractionResponse.type, which contains the type of the wesponse made, if any. (#737)

• Add awiases to the original_message methods. (#738)

  • Interaction.original_response() is awiased to Interaction.original_message()

  • Interaction.edit_original_response() is awiased to Interaction.edit_original_message()

  • Interaction.delete_original_response() is awiased to Interaction.delete_original_message()

• Change ForumChannel.create_thread() to nyot wequiwe the content pawametew to be pwovided. (#739)

  • Wike TextChannel.send(), at weast onye of content, embed/embeds, file/files, stickers, components, ow view must be pwovided.

• Wetuwn the disnake.ui.ActionRow instance on muwtipwe methods to awwow fow fwuent-stywe chainying. (#740)

  • This appwies to ActionRow.append_item, ActionRow.insert_item, ActionRow.add_button, ActionRow.add_select, ActionRow.add_text_input, ActionRow.clear_items, and ActionRow.remove_item.

• Add suppowt fow equawity checks between two disnake.Embeds. (#742)

• Add Permissions.use_embedded_activities as an awias fow Permissions.start_embedded_activities. (#754)

• Add Permissions.use_application_commands as an awias fow Permissions.use_slash_commands. (#755)

• Suppowt setting with_message pawametew of InteractionResponse.defer fow modaw intewactions to False. (#758)

• [ext.commands] Add a way to g-g-get the pawent ow woot commands of swash commands. (#277)

  • Add InvokableSlashCommand.parent, SubCommandGroup.parent, and SubCommand.parent.

  • Add InvokableSlashCommand.parents, SubCommandGroup.parents, and SubCommand.parents.

  • Add InvokableSlashCommand.root_parent, SubCommandGroup.root_parent, and SubCommand.root_parent.

• [ext.commands] I-I-Intwoduce commands.String fow definying stwing option wength wimitations. (#593)

• [ext.commands] Add suppowt fow Unyion[User, Role] and Unyion[User, Member, Role] annyotations in swash commands. (#595)

• [e-ext.commands] Add suppowt fow injected pawametews autocompwetion (#670)

  • Add Injection.autocomplete d-d-decowatow

  • Add injection as a decowatow intewface fow inject

  • Add autocompleters keywowd-onwy awgument to Injection, inject, and register_injection

• [e-ext.tasks] Add suppowt fow subcwassing ext.tasks.Loop and using subcwasses in ext.tasks.loop() decowatow. (#655)

Bug Fixes

• Update incowwect channyew edit method annyotations. (#418)

  • Fix sync_permissions pawametew type.

  • Wemuv topic pawametew fwom StageChannel.edit(), add bitrate.

• Pwopewwy cwose sockets when weceiving a voice sewvew update event. (#488)

• Wawn the usew that boows awe nyot suppowted fow default_member_permissions. (#520)

• Update the Guiwd Itewatow to nyot g-get stuck in an infinyite woop. (#526)

  • A-Add a missing i-i-impowt fow the scheduwed event usew itewatow.

• Change the defauwt guiwd GuildSticker wimit to 5. (#531)

• Handwe optionyaw Locale i-i-instances (nyo wongew cweate an enyum vawue). (#533)

• Update the type fiewd handwing fow audit wogs. (#535)

  • AuditLogDiff.type objects awe nyo wongew awways ChannelType instances.

• Dispatch disnake.on_reaction_remove() fow Thread i-i-instances. (#536)

• Update Guild.bitrate_limit to use the cowwect vawue fow the VIP_REGIONS featuwe fwag. (#538)

• Handwe ThreadAutoArchiveDuration instances fow default_auto_archive_duration when editing channyews. (#568)

• Assume that None is an empty channyew nyame and keep channel.name a stwing. (#569)

• Wemuv the $ pwefix fwom IDENTIFY paywoad pwopewties. (#572)

• Wepwace o-o-owd appwication command objects in c-c-cogs with the nyew/copied objects. (#575)

• Fix opus function cawws on awm64 macOS. (#620)

• Impwuv channyew/guiwd fawwback in wesowved intewaction data, using PartialMessageable f-fow unhandwed/unknyown channyews instead of using None. (#646)

• C-Check the type o-of t-t-the pwovided pawametew when vawidating nyames to impwuv end-usew ewwows when passing an i-i-incowwect object to swash command and option nyames. (#653)

• Make the ext.commands.default_member_permissions() decowatow awways wowk in cogs. (#678)

• Fix Spotify.start, Spotify.end, Spotify.duration waising KeyError instead of wetuwnying None, impwuv activity typing. (#685)

• Fixes message inyitiawization faiwing w-w-with thweads and nyo intents by expwicitwy c-checking we have a guiwd object whewe onye is wequiwed. (#699, #712)

• Fixed an issue whewe it wouwd be possibwe to wemuv othew featuwes when enyabwing ow disabwing the COMMUNITY featuwe fow a-a-a Guild. (#705)

• Fix invawid widget fiewds. (#736)

  • Widget.invite_url and Widget.fetch_invite awe nyow optionyaw.

  • WidgetMember.avatar and WidgetMember.activity nyow wowk pwopewwy and nyo w-wongew awways waise an exception ow wetuwn None.

• Nyo wongew use depwecated @! syntax fow mentionying usews. (#743)

• F-Fix cweation of fowum thweads without Permissions.manage_threads. (#746)

• Don’t count inyitiaw message in fowum thweads towawds Thread.message_count and Thread.total_message_sent. (#747)

• [ext.commands] Handwe VoiceChannel in commands.is_nsfw(). (#536)

• [ext.commands] Handwe Union[User, Member] annyotations on swash commands awguments when using the decowatow intewface. (#584)

• [ext.commands] Change has_permissions and bot_has_permissions checks to w-w-wowk w-w-with intewations in guiwds that onwy added the applications.commands scope, and in DMs. (#673)

• [ext.commands] Fix edge case with pawsing command annyotations that c-contain a unyion of nyon-type objects, wike Optional[Literal[1, 2, 3]]. (#770)

Documentation

• Add sidebaw-nyavigabwe sub-sections to Event Wefewence section of API Wefewence documentation. (#460)

• Wemuv nyotes that gwobaw appwication command wowwout takes up to an houw. (#518)

• Update sphinx fwom 4.4.0 to vewsion 5.1, and t-take advantage of n-n-nyew options. (#522, #565)

• Update the wequests intewsphinx uww to the nyew uww of the wequests documentation. (#539)

• Buiwd an htmwzip vewsion of the d-d-documentation fow downwoading. (#541)

• Fix bwoken Range wefewences. (#542)

• Expand and compwete the attwibute documentation fow AuditLogDiff. (#546)

• Add nyote about cuwwentwy wequiwed cwient uvwwide fow swash wocawisations. (#553)

• Westwuctuwe the examples/ diwectowy, and update + cwean up aww exampwes. (#562, #716)

• Cwawify vanyity invite handwing in Guild.invites. (#576)

• Cwawify the tawgets o-o-of Permissions.is_strict_subset() and Permissions.is_strict_superset(). (#612)

• Cwawify when the usew is a Member ow a User in disnake.on_member_ban() events. (#623)

• Update InteractionReference.name descwiption, nyow incwudes gwoup and subcommand. (#625, #648)

• Nyote that Interaction.channel may be a PartialMessageable in inyaccessibwe thweads, in addition to DMs. (#632)

• Fix the gwammaticaw ewwows in Guild channyew pwopewties. (#645)

• Update fiewds wisted in on_user_update() a-and on_member_update() docs. (#671)

• Add pweviouswy missing inhewited attwibutes to activity types. (#685)

• Add documentation fow the strict pawametew to Client.get_or_fetch_user() and Guild.get_or_fetch_member(). (#710)

• Wemuv nyote about appwication command wocawization wequiwing a cwient buiwd uvwwide. (#711)

• Change wefewences to pubwic guiwds to wefewence the COMMUNITY featuwe instead. (#720)

• Cwawify Thread.delete() cwitewia fow thweads in fowum channyews. (#745)

• Cwawify behaviow of kwawgs in fwag methods when both a fwag and an awias awe given. (#749)

• [e-e-ext.commands] Document t-the i18n a-a-attwibute on ext.commands.Bot and ext.commands.InteractionBot cwasses. (#652)

• [ext.commands] Document commands.Injection. (#669)

• [ext.commands] Impwuv documentation awound using None fow Bot.command_prefix. (#689)

Miscewwanyeous

• Wefactow t-the test bot to be easiew to use fow aww usews. (#247)

• Wefactow channyew edit uvwwoads and intewnyaws, impwoving typing. (#418)

• Wun pywight on exampwes a-a-and fix any typing issues uncuvwed b-by this change. (#519)

• Add inyitiaw testing fwamewowk. (#529)

• Expwicitwy type activity types w-w-with witewaw wetuwn v-vawues. (#543)

• E-E-Expwicitwy type channyew types with witewaw wetuwn vawues. (#543)

• Update PyPI u-u-uww and minyow wowding in the WEADME. (#556)

• Add flake8 as ouw wintew. (#557)

• Update p-p-pywight to 1.1.254. (#559)

• Add genyewic pawametews to usew/message command decowatows. (#563)

  • Update defauwt pawametew type to impwuv compatibiwty with cawwabwe/dynyamic defauwts.

• Wun docs cweation in GitHub actions to test fow wawnyings befowe a puww is mewged. (#564)

• Add mowe typing uvwwides to GuildCommandInteraction. (#580)

• Wewowk intewnyaw typings f-f-fow intewaction paywoads. (#588)

• Add typings fow aww gateway paywoads. (#594)

• Add towncrier and sphinxcontrib-towncrier to manyage changewogs. (#600)

  • U-U-Use towncrier fow changewog manyagement.

  • Use sphinxcontrib-towncrier to buiwd changewogs fow the in-devewopment documentation.

• Expand contwibuting d-d-documentation to incwude mowe infowmation on cweating puww wequests and wwiting featuwes. (#601)

• Add fwake8-compwehensions fow catching inyefficient comphwehensions. (#602)

• Wesowve minyow fwake8 issues. (#606)

  • Don’t use staw impowts except in __init__.py fiwes.

  • Don’t use ambigious vawiabwe nyames.

  • Don’t use setattw and getattw with constant vawiabwe nyames.

• Add flake8-pytest-style fow winting pytest specific featuwes with fwake8. (#608)

• Wepwace aww TypeVar instances with typing_extensions.Self acwoss the entiwe wibwawy whewe possibwe. (#610)

• Wemuv the intewnyaw fill_with_flags decowatow fow fwags cwasses and use the buiwt in object.__init_subclass__() method. (#616, #660)

• Add slice to ui.ActionRow __getattr__ and __delattr__ annyotations. (#624)

• Update and standawdise aww intewnyaw Snyowfwake wegexes to match between 17 and 19 chawactews (incwusive). (#651)

• Wenyame intewnyaw moduwe disnake.ext.commands.flags to disnake.ext.commands.flag_converter. (#667)

• I-I-Impwuv pawawwew documentation buiwd speed. (#690)

• Wimit instawwation of cchardet in the [speed] extwa to P-P-Python vewsions bewow 3.10 (see aiohttp#6857). (#702)

• Update annyotation and descwiption of options pawametew of ui.ActionRow.add_select to match ui.Select. (#744)

• Update typings to expwicitwy s-s-specify optionyaw types fow pawametews with a None defauwt. (#751)

• Adopt SPDX Wicense Headews acwoss aww pwoject fiwes. (#756)

v2.5.3

This is a maintenyance wewease with backpowts fwom v2.6.0.

Bug Fixes

• Fix cweation of fowum thweads without Permissions.manage_threads. (#746)

• [ext.commands] Fix edge case with pawsing command annyotations that contain a u-unyion of nyon-type objects, w-w-wike Optional[Literal[1, 2, 3]]. (#771)

Miscewwanyeous

• Wimit instawwation of cchardet in the [speed] extwa to Python vewsions bewow 3.10 (see aiohttp#6857). (#772)

v2.5.2

This wewease is a bugfix wewease with backpowts fwom upto v2.6.0.

Bug Fixes

• W-W-Wawn the usew t-t-that boows awe nyot suppowted fow default_member_permissions. (#520)

• Update the Guiwd Itewatow to nyot get stuck in an infinyite woop. (#526)

  • A-Add a missing impowt fow t-the scheduwed event usew itewatow.

• Change the d-defauwt guiwd GuildSticker wimit to 5. (#531)

• Handwe optionyaw Locale instances (nyo wongew cweate an enyum vawue). (#533)

• [ext.commands] Handwe VoiceChannel in commands.is_nsfw(). (#536)

• Dispatch disnake.on_reaction_remove() fow Thread instances. (#536)

• Update Guild.bitrate_limit to use the cowwect vawue fow the VIP_REGIONS featuwe fwag. (#538)

• Make aww *IntewactionData datacwasses dicts (MessageInteractionData, ApplicationCommandInteractionData, and so on). (#549)

• Handwe ThreadAutoArchiveDuration instances fow default_auto_archive_duration when editing c-c-channyews. (#568)

• Assume that None is an empty channyew nyame and keep channel.name a stwing. (#569)

• Wemuv the $ pwefix fwom IDENTIFY paywoad pwopewties. (#572)

• Wepwace owd appwication command objects in cogs with the nyew/copied objects. (#575)

• [ext.commands] Handwe Union[User, Member] annyotations on swash commands awguments when using t-t-the decowatow intewface. (#584)

• Fix opus f-f-function cawws on awm64 m-m-macOS. (#620)

• Impwuv channyew/guiwd f-fawwback in wesowved intewaction data, using PartialMessageable fow unhandwed/unknyown channyews instead o-of using None. (#646)

Documentation

• Wemuv nyotes that gwobaw a-appwication command wowwout takes up to an h-h-houw. (#518)

• Update the wequests intewsphinx uww t-to the nyew u-uww of the wequests documentation. (#539)

• Cwawify the tawgets of Permissions.is_strict_subset() and Permissions.is_strict_superset(). (#612)

• Update InteractionReference.name descwiption, nyow incwudes gwoup and subcommand. (#625, #648)

v2.5.1

Bug Fixes

• [ext.commands] Fix autocomplete() decowatow in cogs (#521)

v2.5.0

This vewsion adds suppowt fow API v10 (which comes with a few bweaking changes), fowum channyews, wocawizations, pewmissions v2, impwuvs API cuvwage by adding suppowt fow pweviouswy missing f-f-featuwes wike guiwd pweviews, w-widgets, ow wewcome scweens, and contains sevewaw miscewwanyeous enhancements and bugfixes.

Wegawding the message content intent: Nyote that eawwiew vewsions wiww continyue wowking finye aftew the message content intent deadwinye (August 31st 2022), as wong as the intent is enyabwed in the devewopew powtaw. Howevew, fwom this vewsion (2.5.0) onwawd, the intent nyeeds to be enyabwed in the devewopew powtaw and youw code. See this page of t-the g-g-guide fow mowe i-infowmation. If you do nyot have access to the intent yet, you can tempowawiwy continyue using A-API v9 by cawwing disnake.http._workaround_set_api_version(9) befowe connyecting, which wiww keep sending message content befowe the intent deadwinye, even with the intent disabwed.

Bweaking Changes

• The message_content intent is nyow w-wequiwed to weceive message content and wewated fiewds, see abuv (#353)

• The nyew p-pewmissions v2 system wevamped appwication command pewmissions, with the most nyotabwe changes being the wemovaw of default_permission and commands.guild_permissions in favow of nyew fiewds/methods - see bewow fow aww nyew changes (#405)

• TextChannel.create_thread() nyow wequiwes eithew a message ow a type p-p-pawametew (#355)

• GuildScheduledEvent.fetch_users() and Guild.bans() nyow wetuwn an async itewatow instead of a wist of usews (#428, #442)

• Guild.audit_logs() nyo wongew suppowts the oldest_first pawametew (#473)

• Stowe channyews have been wemuvd as they’we nyot suppowted by Discowd any wongew (#438)

• on_thread_join() wiww nyo wongew b-b-be invoked when a nyew thwead is c-cweated, see on_thread_create() (#445)

• The voice wegion enyum was wepwaced with a genyewic VoiceRegion data cwass (#477)

• locale attwibutes awe nyow of type Locale instead of str (#439)

• Invite.revoked and Thread.archiver_id have been wemuvd (depwecated in 2.4) (#455)

• Swash command nyames and option nyames awe nyo wongew automaticawwy c-c-convewted to wowewcase, an InvalidArgument exception is nyow waised instead (#422)

• The interaction pawametew o-o-of ui.Item.callback() can nyo wongew be passed as a kwawg (#311)

• The youtube, awkword and sketchy_artist PartyTypes nyo wongew wowk and have been wemuvd (#408, #409)

• Twying to defew an intewaction wesponse that does nyot suppowt defewwing (e.g. autocompwete) wiww nyow waise a TypeError (#505)

• [ext.commands] Faiwuwe to convewt an input p-p-pawametew annyotated as LargeInt nyow waises a LargeIntConversionFailure (#362)

Depwecations

• Pubwic stages and stage discuvwabiwity awe depwecated and nyo wongew suppowted (#287)

• Voice wegions on guiwd wevew awe depwecated and nyo wongew have any effect; they shouwd be set on a pew-channyew basis instead (#357, #374)

• Guild.create_integration(), Integration.delete(), StreamIntegration.edit() and StreamIntegration.sync() can’t be used by bots anymowe a-a-and w-w-wiww be wemuvd in a futuwe vewsion (#361)

• AppInfo.summary, PartialAppInfo.summary and IntegrationApplication.summary awe depwecated, use .description instead (#369)

• The suppress p-pawametew fow edit methods has been depwecated in favow of suppress_embeds, with unchanged functionyawity (#474)

Nyew Featuwes

• Suppowt API v10 (#353)

  • Nyew intent: Intents.message_content

  • [e-e-ext.commands] Nyew wawnying: MessageContentPrefixWarning

• Add fowum channyews (#448, #479, #504, #512)

  • Add ForumChannel

  • Add CategoryChannel.forum_channels, Guild.forum_channels

  • Add CategoryChannel.create_forum_channel, Guild.create_forum_channel

  • Add ChannelFlags, Thread.flags, Thread.is_pinned

  • A-A-Add pinned pawametew to Thread.edit()

  • Add Permissions.create_forum_threads, awias of send_messages

  • [ext.commands] Add ForumChannelConverter

• Add appwication command wocawizations, see Wocawizations (#269)

  • Add Localized, LocalizationProtocol, LocalizationStore

  • M-Most name and description pawametews nyow awso accept a Localized object

  • Update docstwing pawsing to accommodate fow wocawizations

  • Add Client.i18n

  • Add localization_provider and strict_localization pawametews to Client

  • Add with_localizations p-pawametew to Client.fetch_global_commands(), Client.fetch_guild_commands()

  • Add LocalizationWarning, LocalizationKeyError

  • Add utils.as_valid_locale()

  • Add wocawization exampwe

• Suppowt pewmissions v2, see Pewmissions (#405)

  • Bweaking changes:

    • Wemuv suppowt fow default_permission

    • Wemuv GuildApplicationCommandPermissions.edit(), PartialGuildApplicationCommandPermissions, UnresolvedGuildApplicationCommandPermissions

    • Wemuv Client.edit_command_permissions(), Client.bulk_edit_command_permissions(), Client.edit_command_permissions(), Client.edit_command_permissions()

    • Wemuv Guild.get_command_permissions(), Guild.edit_command_permissions(), Guild.bulk_edit_command_permissions()

    • Update behaviow of GuildCommandInteraction annyotation to automaticawwy set dm_permission=False instead of adding a wocaw check, wemuv suppowt fow subcommands

    • Add ApplicationCommandPermissionType enyum, change type of ApplicationCommandPermissions.type to suppowt channyew tawgets

    • [ext.commands] Wemuv guild_permissions() decowatow

    • [ext.commands] Wemuv sync_permissions pawametew fwom Bot

  • Nyew featuwes:

    • Add dm_permission and default_member_permissions pawametews to appwication command objects and decowatows

    • Add dm_permission, default_member_permissions attwibutes to ApplicationCommand and InvokableApplicationCommand

    • Add ApplicationCommandPermissions.is_everyone() a-a-and ApplicationCommandPermissions.is_all_channels()

    • A-Add AuditLogAction.application_command_permission_update enyum vawue and AuditLogDiff.command_permissions

    • Add on_application_command_permissions_update() event

    • [ext.commands] Add default_member_permissions() decowatow, awtewnyative to identicawwy nyamed pawametew

• Add g-g-guiwd pweviews (#359)

  • Add GuildPreview

  • Add Client.fetch_guild_preview()

• Add guiwd widget s-settings and widget uww (#360, #365)

  • Add WidgetSettings, WidgetStyle

  • A-A-Add Guild.widget_settings(), Guild.widget_image_url()

  • Add Widget.image_url()

  • Change Guild.edit_widget() w-w-wetuwn type

• Add guiwd wewcome scweens (#339)

  • Add WelcomeScreen, WelcomeScreenChannel

  • Add Guild.welcome_screen(), Guild.edit_welcome_screen()

  • Add Invite.guild_welcome_screen

• Suppowt List[str] and Dict[str, str] in option pawametew of disnake.ui.Select (#326)

• Add Guild.search_members() (#358, #388)

• Add ModalInteraction.message (#363, #400)

• Suppowt InteractionResponse.edit_message() f-fow modaw intewactions, if modaw w-was sent in wesponse to componyent intewaction (#364, #400)

• Suppowt reason pawametew in Message.create_thread() and Thread.delete() (#366)

• Add StageInstance.guild_scheduled_event and StageInstance.guild_scheduled_event_id (#394)

• Add SessionStartLimit and Client.session_start_limit (#402)

• Add PartialInviteGuild.premium_subscription_count (#410)

• Awwow passing asset types fow most image pawametews, in addition to bytes (#415)

• Update GuildScheduledEvent.fetch_users() and Guild.bans() to be async itewatows suppowting paginyation (#428, #442)

• Add AuditLogDiff.image fow scheduwed event images (#432)

• Add Locale enyum (#439)

• Add notify_everyone pawametew to StageChannel.create_instance() (#440)

• Add to_file() method to assets, emojis, stickews (#443, #475)

• Add on_thread_create() e-e-event (#445)

• Suppowt reason pawametew in Thread.edit() (#454)

• A-A-Add default_auto_archive_duration pawametew to Guild.create_text_channel(), add nsfw pawametew to Guild.create_voice_channel() (#456)

• Awwow pwoviding attachments=None to cweaw attachments when editing a message (#457)

• Add __repr__ methods to intewaction data types (#458)

• Add VoiceChannel.delete_messages(), VoiceChannel.purge(), VoiceChannel.webhooks(), VoiceChannel.create_webhook(), and impwuv VoiceChannel.permissions_for() (#461)

• Add AppInfo.tags, AppInfo.install_params, AppInfo.custom_install_url (#463)

• Add TextChannel.last_pin_timestamp, DMChannel.last_pin_timestamp, Thread.last_pin_timestamp (#464)

• Add MessageType.auto_moderation_action (#465)

• Add tempowawy wowkawound f-f-fow setting API vewsion to avoid message content intent wequiwement untiw deadwinye (#467)

• Add Interaction.expires_at and Interaction.is_expired, automaticawwy faww back to message edit/dewete if intewaction expiwed (#469)

• Add suppress_embeds pawametew to message send methods (#474)

• Add VoiceRegion (wepwacing v-voice wegion enyum), Client.fetch_voice_regions(), Guild.fetch_voice_regions() (#477)

• Add Member.role_icon pwopewty (#485)

• Add debug wogging of webhook wequest/wesponse data (#486)

• Add on_raw_thread_delete(), on_raw_thread_member_remove() and on_raw_thread_update() events (#495)

• Suppowt cweating nyews channyews using Guild.create_text_channel() (#497)

• Add Guild.vanity_url_code, add option to Guild.vanity_invite() to use cached invite code (#502)

• Add Message.application_id (#513)

• [ext.commands] A-A-Add GuildScheduledEventConverter and GuildScheduledEventNotFound (#376)

• [ext.commands] Add extras to a-a-appwication commands (#483)

• [ext.commands] Add slash_command_attrs, user_command_attrs and message_command_attrs Cog pawametews (#501)

Bug Fixes

• Impwuv componyents exception message (#352)

• Use pwopew HTTP method fow joinying thweads, wemuv unyused methods (#356)

• Fix missing create_public_threads pewmission in Permissions.private_channel (#373)

• Ensuwe token is of type str (#375)

• Impwuv abc.Messageable.send() typing and fix annyotations o-o-of HTTP methods (#378)

• Fix shadowed disnake.message moduwe (#380)

• Fix missing/incowwect __slots__ (#381)

• Fix PartialInviteChannel.__str__ (#383)

• Fix wowe icon/emoji editing (#403)

• W-Wemuv cached scheduwed events if associated channyew was d-d-deweted (#406)

• Update some types/pawametews of wowes, scheduwed events and voice s-s-states (#407)

• Awwow content pawametews i-in send/edit methods to be positionyaw (#411)

• Fix gateway watewimitew being too stwict (#413)

• Fix caching of stage instances andd scheduwed events (#416)

• Fix memowy weaks on shawd weconnyect (#424, #425)

• Impwuv PartialMessageable channyew handwing (#426)

• Use asyncio.iscoroutinefunction() instead o-of inspect.iscoroutinefunction() (#427)

• F-F-Fix read() fow activity emojis (#430)

• Don’t automaticawwy e-enyabwe wogging if autowewoad is enyabwed (#431)

• Suppowt embed images in InteractionResponse.edit_message() (#466)

• Fix after pawametew of Guild.audit_logs() (#473)

• Add __str__ to ApplicationCommand, impwuv sync debug output (#478)

• Don’t wequiwe a topic when cweating a stage channyew (#480)

• Update and add missing uvwwoads (#482)

• Make disnake.types.interactions impowtabwe at wuntime (#493)

• Waise TypeError instead of siwentwy wetuwnying when twying t-t-to defew an unsuppowted intewaction type (#505)

• Fix deway of after cawwback in AudioPlayer when stopping (#508)

• [ext.commands] Make convewsion exceptions in swash commands pwopagate cweanwy as documented (#362)

• [ext.commands] Fix clean_content convewtew (#396)

• [ext.commands] Fix usage of custom convewtews with Param (#398)

• [ext.commands] Suppowt intewactions in UserConverter, MemberConverter (#429)

• [ext.commands] Fix unwoading o-o-of wistenyews with custom nyames (#444)

• [ext.commands] Fix pawametew nyame confwicts in swash commands (#503)

Documentation

• Disabwe m-m-mathjax in d-d-documentation t-t-to impwuv woading times (#370)

• Update wetuwn type of Guild.create_template() (#372)

• Add documentation fow GuildCommandInteraction, UserCommandInteraction, and MessageCommandInteraction (#374)

• Fix sevewaw bugs of wedesign (#377)

• Update bwoken wefewences (#419)

• Fix dupwicate seawch wesuwts, impwuv scowing (#423)

• Add seawch hotkeys ctrl+k, /, s (#434)

• Fix stwing escape wawnyings (#436)

• Add sevewaw pweviouswy missing documentation entwies (#446, #470)

• Add autocompwete decowatow e-e-exampwe (#472)

• Update docs o-o-of ABCs to mention subcwasses (#506)

• Update on_member_update() documentation to incwude nyew and futuwe attwibutes (#510)

• Fix miscewwanyeous issues, impwuv fowmatting (#511)

Miscewwanyeous

• Fix wemainying pywight issues, add pywight C-C-CI (#311, #387, #514)

• Update dev dependencies and CI (#345, #386, #451)

• Impwuv _WebhookState typing (#391)

• Impwuv basic_bot.py exampwe (#399)

• Add wow-wevew componyent exampwe (#452)

• Update Discowd sewvew invite winks (#476)

v2.4.1

This wewease is a bugfix wewease with backpowts fwom v2.5.0 up to v2.5.2.

Bug Fixes

• Fix missing create_public_threads pewmission in Permissions.private_channel (#373)

• Fix PartialInviteChannel.__str__ (#383)

• Fix wowe icon/emoji editing (#403)

• Wemuv cached scheduwed events if associated channyew was deweted (#406)

• Update some types/pawametews of wowes, scheduwed events and voice states (#407)

• Awwow content pawametews in send/edit methods to be positionyaw (#411)

• Fix gateway watewimitew b-b-being too stwict (#413)

• Fix caching of stage instances andd scheduwed events (#416)

• Fix memowy weaks on shawd weconnyect (#424, #425)

• Impwuv PartialMessageable channyew handwing (#426)

• Fix read() fow activity emojis (#430)

• Fix deway o-of after cawwback in AudioPlayer w-w-when stopping (#508)

• Change the defauwt guiwd GuildSticker wimit to 5. (#531)

• Dispatch disnake.on_reaction_remove() fow Thread instances. (#536)

• Update Guild.bitrate_limit t-to use the cowwect vawue fow the VIP_REGIONS featuwe fwag. (#538)

• Wemuv the $ pwefix fwom IDENTIFY paywoad pwopewties. (#572)

• Fix opus function cawws on awm64 macOS. (#620)

• Impwuv channyew/guiwd fawwback in wesowved intewaction data, using PartialMessageable fow unhandwed/unknyown channyews instead o-of using None. (#646)

• [ext.commands] Fix clean_content convewtew (#396)

• [ext.commands] Suppowt intewactions in UserConverter, MemberConverter (#429)

• [ext.commands] Fix unwoading of wistenyews with custom nyames (#444)

• [ext.commands] Handwe VoiceChannel in commands.is_nsfw(). (#536)

Documentation

• Update the wequests intewsphinx uww to the nyew uww of the wequests documentation. (#539)

Miscewwanyeous

• Update dev dependencies and CI (#451)

v2.4.0

This vewsion contains m-m-many nyew featuwes, incwuding attachment options, modaws, and the abiwity to diwectwy send message componyents without views, as weww as sevewaw fixes and othew genyewaw impwuvments.

Bweaking Changes

• The constwuctow of ApplicationCommand and its subtypes nyo wongew accepts **kwargs fow setting intewnyaw v-vawues (#249)

  • This shouwdn’t affect anyonye, as **kwargs was onwy used fow setting fiewds w-wetuwnyed by the API and had nyo effect if the usew set them

• Interaction.permissions nyow wetuwns pwopew pewmission vawues in DMs (#321)

• The reason pawametew fow stickew endpoints in HTTPClient is nyow kwawg-onwy

Depwecations

• Thread.archiver_id is nyot being pwovided by t-t-the API anymowe and wiww be wemuvd in a futuwe vewsion (#295)

• Invite.revoked is nyot being pwovided by the API a-a-anymowe and wiww b-b-be wemuvd in a futuwe vewsion (#309)

Nyew Featuwes

• Add Interaction.locale and Interaction.guild_locale pwopewties to intewactions (#225)

• Add ui.ActionRow and components kwawg to send methods (#224)

• Add ui.WrappedComponent as a base cwass fow aww UI componyents (#253)

  • ui.Item nyow inhewits fwom ui.WrappedComponent. It’s nyo wongew a base cwass fow aww UI componyents.

• Impwement modaws and text inputs (#253)

  • Add TextInput componyent.

  • Add ui.Modal as a high-wevew impwementation of modaws.

  • Add ui.TextInput fow modaws. It inhewits fwom ui.WrappedComponent and adds mowe functionyawity o-on top of TextInput.

  • Add InteractionResponse.send_modal() t-to suppowt n-n-nyew intewaction wesponse t-type.

  • Add on_modal_submit() event.

• A-A-Add MessageFlags.failed_to_mention_roles_in_thread (#238)

• Use woggew fow appwication command sync debug (#230)

• [ext.commands] Impwuv appwication command sync awgowithm (#240)

• Use HTTP A-A-API v9 (#250)

• [ext.commands] Add commands.Range, see Nyumbew Wanges (#237, #276, #316)

• [ext.commands] Add Bot.load_extensions and utils.search_directory() (#245)

• [ext.commands] Add commands.LargeInt (#264)

• Add with_message pawametew to InteractionResponse.defer() to suppowt defewwing componyent intewaction wesponses with messages (#248)

• A-A-Add Widget.edit() (#266)

• Add the abiwity to specify a defauwt cowow fow embeds (#203)

• Add PartialInviteGuild.nsfw_level and PartialInviteGuild.vanity_url_code (#297)

• Add Thread.create_timestamp (#285)

• Add Message.thread (#291)

• Add Permissions.events a-and Permissions.private_channel, impwuv existing factowy methods (#286, #321)

• Suppowt images in GuildScheduledEvent (#280)

• Add PartyType.sketch_heads and PartyType.ocho (#306)

• Suppowt Thread annyotations in s-s-swash commands (#305)

• Interaction.bot, Interaction.client, Interaction.channel and Interaction.channel_id awe nyo w-w-wongew optionyaw (#279)

• Suppowt timeouts in abc.GuildChannel.permissions_for() and othew channyew types (#289)

• Suppowt disnake.Attachment options in swash commands (#226)

• Add attachments pawametew to InteractionResponse.edit_message() (#335)

• Add Guild.get_or_fetch_members() with an awias Guild.getch_members() (#322).

• Add abc.GuildChannel.jump_url, DMChannel.jump_url and Thread.jump_url (#319)

Bug Fixes

• Fix missing suppowt fow reason pawametew in some m-m-methods (#266)

• Impwuv vawidation of swash command and option nyames (#267)

• [ext.commands] Fix typing of ctx pawametew in Converter (#292)

• Fix Guild.get_command() n-n-nyevew wetuwnying any c-commands (#333)

• Wetuwn wist of membews fwom Guild.chunk() (#334)

• Fix handwing of uppewcase swash command nyames (#346)

• Fix permissions annyotation o-o-of abc.GuildChannel.set_permissions() (#349)

• Fix tasks.loop usage with fixed times (#337)

Documentation

• Show toowtips when h-huvwing uvw winks (#236, #242)

• Genyewaw c-content impwuvments/adjustments (#275)

• Swight wedesign a-a-and genyewaw wayout impwuvments (#278)

Miscewwanyeous

• Impwuv exampwes (#209, #262, #270, #307, #332, #341)

• Impwuv typing/annyotations o-o-of sevewaw pawts of the wibwawy (#249, #256, #263, #279, #292, #299, #308)

• Add additionyaw pwe-commit h-h-hooks fow devewopment (#233)

• Add taskipy fow devewopment (#234)

• Impwuv membew desewiawization (#304)

• Spwit appwication command objects into sepawate types fow data wetuwnyed by the API (#299)

• Update WEADME bannyew (#343)

v2.3.2

Bug Fixes

• Fix i-i-invawid d-d-defauwt vawue f-f-fow appwication command option descwiptions (#338)

v2.3.1

Bug F-Fixes

• [ext.commands] Fix Python 3.10 unyion type annyotations in swash commands (#231)

• Fix doubwe @ when mentionying defauwt wowe (#244)

• Fix a command sync bug which pwevented wegistewing two appwication commands with the same nyame but diffewent types (#254)

• Fix GuildScheduledEvent.fetch_users() (#274)

• Fix bug when editing a View with UWW buttons that wesuwted in the row attwibute being weset (#252)

• [ext.commands] Fix MessageConverter nyot defauwting to cuwwent channyew if nyo channyew ID specified (#284)

• Fix attachment descwiptions nyot wowking aftew wecent API change (#241)

• Fix incowwect type check in Guild.create_scheduled_event() u-using StagePrivacyLevel instead of GuildScheduledEventPrivacyLevel (#263)

• [ext.commands] Fix exceptions that occuwwed when using a Union i-in a swash command pawametew annyotation

• [ext.commands] Fix dynyamic command coowdowns (#320)

• Fix type-checking of guild_ids / test_guilds pawametews which couwd bweak appwication command caching (#300, #325)

• Fix Guild.create_sticker() nyot wowking when nyo descwiption was pwovided (#328)

Documentation

• Fix guild_permissions() documentation

• Fix missing dwopdown icon (#235)

Miscewwanyeous

• Add isort and black pwe-commit hooks, wun isowt (#169, #173, #233)

• Wenyame tests diwectowy (#232)

v2.3.0

This vewsion contains sevewaw nyew featuwes and fixes, nyotabwy suppowt fow guiwd scheduwed events, guiwd timeouts, and a-a-a swash command wewowk with pawametew injections, as weww as sevewaw documentation fixes.

Nyote: the Vewsion Guawantees have been updated to mowe accuwatewy wefwect the vewsionying scheme this w-wibwawy is fowwowing.

Bweaking Changes

• The suppowted aiohttp vewsion wange changed fwom >=3.6.0,<3.8.0 to >=3.7.0,<3.9.0

• Due to the upcoming t-text-in-voice featuwe (nyot y-yet weweased at the time of wwiting), many methods/pwopewties that pweviouswy wetuwnyed a TextChannel can nyow awso wetuwn a VoiceChannel, which shawes many but nyot a-aww of its methods. Awso see t-t-the detaiws fow text-in-voice undew “Nyew Featuwes” bewow, which incwude a few impowtant things to nyote.

• Swash c-command i-i-intewnyaws have undewgonye an extensive wewowk, a-and whiwe existing code shouwd stiww wowk as befowe, it is wecommended that you do some t-testing using the nyew impwementation fiwst

• Bot.get_slash_command may nyow awso wetuwn SubCommandGroup ow SubCommand instances, see documentation

• disnake.types.ThreadArchiveDuration is nyow ThreadArchiveDurationLiteral, to avoid confusion with the nyew ThreadArchiveDuration enyum

Depwecations

• The role_ids and user_ids pawametews fow guild_permissions awe nyow roles and users w-wespectivewy; the owd pawametew nyames wiww be wemuvd in a futuwe vewsion

Nyew Featuwes

• Add guiwd scheduwed events (#151, #217)

  • Nyew intent: Intents.guild_scheduled_events (enyabwed by defauwt)

  • Nyew types

    • GuildScheduledEvent

    • GuildScheduledEventMetadata

    • GuildScheduledEventEntityType

    • GuildScheduledEventStatus

    • GuildScheduledEventPrivacyLevel

  • Guiwd additions/changes

    • Guild.scheduled_events

    • Guild.get_scheduled_event()

    • Guild.fetch_scheduled_event()

    • Guild.fetch_scheduled_events()

    • Guild.create_scheduled_event()

  • Invite additions/changes

    • Invite.guild_scheduled_event

    • guild_scheduled_event pawametew on abc.GuildChannel.create_invite()

    • guild_scheduled_event_id pawametew on Client.fetch_invite()

    • Incwude event UWW p-p-pawametew in Invite.url if appwicabwe

    • Suppowt pawsing scheduwed event ID fwom invite UWWs

  • Nyew events

    • on_guild_scheduled_event_create()

    • on_guild_scheduled_event_update()

    • on_guild_scheduled_event_delete()

    • on_guild_scheduled_event_subscribe() and on_raw_guild_scheduled_event_subscribe()

    • on_guild_scheduled_event_unsubscribe() and on_raw_guild_scheduled_event_unsubscribe()

  • Nyew audit wog actions

    • AuditLogAction.guild_scheduled_event_create

    • AuditLogAction.guild_scheduled_event_update

    • AuditLogAction.guild_scheduled_event_delete

• Add guiwd timeouts (#161, #221, #223)

  • Guild.timeout()

  • Member.timeout()

  • Member.current_timeout

  • timeout pawametew on Member.edit()

  • Nyew pewmission: Permissions.moderate_members

• Add pwewiminyawy suppowt fow text-in-voice (#162, #177)

  • Many methods/pwopewties that pweviouswy wetuwnyed a TextChannel can nyow awso wetuwn a VoiceChannel, which shawes many but nyot aww of its methods

  • Impowtant nyotes:

    • This featuwe is onwy avaiwabwe i-in a vewy wimited nyumbew of sewvews at the time of wwiting this, and the API is stiww being devewoped; thewefowe, expect changes in the futuwe

    • T-Text-in-voice cuwwentwy does nyot suppowt these t-t-text channyew featuwes (nyote: this is nyot guawanteed t-to be an exhaustive wist): thweads, webhooks, nsfw fwags, swowmode

    • The nsfw and slowmode_delay vawues/pawametews awe cuwwentwy nyot suppowted by the A-API and awe stiww TBD

    • Pinnyed messages awe c-c-cuwwentwy nyot exposed i-i-in the cwient UI, and whiwe the API fow them wowks, theiw futuwe is uncewtain

  • VoiceChannel nyow inhewits fwom abc.Messageable

  • Nyew VoiceChannel pwopewties: .nsfw, .slowmode_delay, .last_message_id, .last_message

  • Nyew VoiceChannel methods: .is_nsfw, .get_partial_message

  • nsfw and slowmode_delay pawametews fow VoiceChannel.edit()

• [ext.commands] Add pawametew injections (exampwe) (#130)

  • inject

  • register_injection

  • converter_method

• Add attachment descwiptions (see File, Attachment) (#100)

• Add on_raw_typing() event (#176)

• Add Guild.approximate_member_count and Guild.approximate_presence_count (avaiwabwe on manyuawwy fetched guiwds) (#139)

• Add Permissions.start_embedded_activities (#160)

• Add ThreadArchiveDuration enyum, containying the cuwwentwy vawid vawues fow the thwead auto-awchive featuwe (#187)

• [e-e-ext.commands] Add PermissionsConverter, which awwows the convewsion of a vawue ow a (wist of) pewmission nyames to a-a Permissions instance (using a-a-a Permissions annyotation)

• A-A-Add AppInfo.flags

• [ext.commands] Add channel_types pawametew to Param/ParamInfo (#130)

• Add suppowt fow setting slowmode_delay on thwead cweation (TextChannel.create_thread(), Message.create_thread()) (#132)

• Add invitable pawametew to TextChannel.create_thread() (#132)

• Add fail_if_not_exists pawametew to Message.reply() (#199, #211)

• [ext.commands] Bot.get_slash_command nyow wowks simiwaw to Bot.get_command, in that it can awso wetuwn subcommands/gwoups fow inputs wike "foo bar" (#149)

• Add nyew awiases fow ApplicationCommandInteraction: CommandInteraction, CmdInteraction, CommandInter, CmdInter, AppCommandInteraction

• Add a base cwass fow wawnyings emitted by this wibwawy, DiscordWarning (#118)

• Add nyew wawnyings (emitted instead of just using print fow wawnyings): ConfigWarning, SyncWarning (#118)

• Add nyew voice channyew activities: (#145, #148, #183)

  • PartyType.watch_together

  • PartyType.checkers

  • PartyType.spellcast

  • PartyType.awkword

  • PartyType.sketchy_artist

• Add nyew fwags/enyum vawues: (#148, #194)

  • MessageType.context_menu_command

  • Status.streaming

  • SystemChannelFlags.join_notification_replies

  • MessageFlags.loading

  • UserFlags.http_interactions_bot, PublicUserFlags.http_interactions_bot

  • UserFlags.spammer, PublicUserFlags.spammer

Bug Fixes

• Fix dispatch of typing events in DMs (#176)

• Twy to wetwieve objects in weceived intewactions fwom cache fiwst (fixing pwopewties wike Member.status on membew pawametews fow commands) (#182, #213)

• Fix wetuwn type annyotation of ui.button() and ui.select() decowatows (#163)

• F-F-Fix incowwect UWW wetuwnyed by Template.url

• Fix sending wocaw fiwes in embeds with intewactions/webhooks if onwy o-onye embed w-w-was specified (#193)

• Fix weftuvw uses of json, which didn’t use orjson if avaiwabwe (#184)

• Fix Message.channel type being DMChannel fow ephemewaw messages in on_message() (#197)

• Fix command/option nyame vawidation (#210)

• Awways cwose fiwes aftew compweting HTTP wequests (#124)

• [ext.commands] Fix unnyecessawy appwication command sync without c-changes

• [ext.commands] Fix incowwect detection of d-d-depwecated guiwd commands in sync awgowithm whiwe sync is in pwogwess (#205)

Documentation

• Muv documentation to h-h-https://docs.disnyake.dev/

• Update Vewsion Guawantees (#200)

• Cwawify Interaction.original_message() documentation wegawding d-diffewent wesponse types (#140)

• Cwawify Interaction.send() documentation (#188)

• Wediwect seawches fow color to colour (#153)

• Add documentation fow nyew guiwd featuwe vawues (#148)

• Add documentation fow sevewaw methods/pwopewties: (#153)

  • Client.global_application_commands

  • Client.global_slash_commands

  • Client.global_user_commands

  • Client.global_message_commands

  • Bot.on_slash_command_error

  • Bot.on_user_command_error

  • Bot.on_message_command_error

  • on_slash_command_completion

  • on_user_command_completion

  • on_message_command_completion

  • ApplicationCommandInteraction.bot

  • InvokableApplicationCommand

• Fix incowwect type fow Invite.channel in documentation

• Add additionyaw infowmation about appwication command sync awgowithm and syncing commands in shawded bots (#205)

Miscewwanyeous

• Add Python 3.10 to p-package cwassifiews (#127)

• Change suppowted aiohttp vewsion wange fwom >=3.6.0,<3.8.0 to >=3.7.0,<3.9.0 (#119, #164)

• Add guide f-fow configuwing inviting a bot thwough its pwofiwe (#153)

• Wewwite pwoject WEADME (#191)

• Impwuv exampwes (#143)

v2.2.3

B-B-Bug Fixes

• Fix invawid defauwt vawue fow appwication command option descwiptions (#338)

v2.2.2

Bug Fixes

• Fix channyew convewsion i-in audit wog e-entwies

• Fix impwopew ewwow h-handwing in context menyu commands

• Suppwy ApplicationCommandInteraction.application_command in autocompwete cawwbacks

• Fix Select.append_option nyot waising an ewwow if 25 options have awweady been added

• Impwuv c-check fow options pawametew on swash commands and s-subcommands

• Impwuv pawametew pawsing fow c-c-convewtews

• Fix wawnying wewated to nyew option pwopewties

Documentation

• Update wepositowy winks to nyew owganyization

• Fix dupwicate entwies in documentation

• Fix incowwect versionadded t-t-tags

• Add documentation fow InteractionBot and AutoShardedInteractionBot

v2.2.1

Bug Fixes

• Fixed ewwow wewated to guiwd membew count

v-v2.2.0

Nyew Featuwes

• Add Interaction.send()

• Add kwawg attachments to edit methods

• Add kwawgs file and files to InteractionResponse.edit_message(), PartialMessage.edit() and Message.edit()

• Add kwawg file to Embed.set_image() and Embed.set_thumbnail()

• Add kwawg delay to Interaction.delete_original_message() and WebhookMessage.delete()

• Add kwawg delete_after to InteractionResponse.send_message() and WebhookMessage.send()

• [ext.commands] Add InvokableSlashCommand.autocomplete (awtewnyative method of adding autocompwete functions)

• [ext.commands] Add SubCommand.autocomplete (awtewnyative method of adding autocompwete functions)

• [ext.commands] Add Cog.cog_load

• [ext.commands] Ewwow handwews nyow can cancew each othew by wetuwnying True

v2.1.5

Nyew Featuwes

• Add InteractionReference

• Add UnresolvedGuildApplicationCommandPermissions

• Add Message.interaction

• Add kwawgs min_value and max_value in Option

• [ext.commands] Add kwawg min_value (with awiases ge, gt) to Param

• [ext.commands] Add kwawg max_value (with awiases le, lt) to Param

• [e-e-ext.commands] Add kwawg owner to guild_permissions

Bug Fixes

• Command dewetions on weconnyections

• Pending sync tasks on woop tewminyation

v2.1.4

Bug Fixes

• Fixed some issues with appwication command p-pewmissions synchwonyisation

v2.1.3

Nyew Featuwes

• Add GuildApplicationCommandPermissions

• Add PartialGuildApplicationCommandPermissions

• Add ApplicationCommandInteraction.filled_options pwopewty

• Add on_slash_command_completion

• Add on_user_command_completion

• A-A-Add on_message_command_completion

• [ext.commands] Add AutoShardedInteractionBot

• [ext.commands] Add InteractionBot

• [ext.commands] A-Add guild_permissions

• [ext.commands] Add kwawgs sync_commands_on_cog_unload and sync_permissions to InteractionBotBase

Bug Fixes

• Music

• default_permission kwawg in usew / message commands

• Commands nyo wongew sync duwing the woop t-tewminyation

v2.1.2

This is the fiwst stabwe vewsion of this discowd.py 2.0 fowk.

Nyew Featuwes

• Add i-i-intewaction hiewawchy. Interaction is nyow the base cwass fow othew intewaction types, such as ApplicationCommandInteraction and MessageInteraction.

• Add intewaction data wwappews: ApplicationCommandInteractionData and MessageInteractionData.

• Add intewaction data option wwappew: ApplicationCommandInteractionDataOption

• Add Client.bulk_edit_command_permissions()

• Add Client.bulk_overwrite_global_commands()

• Add Client.bulk_overwrite_guild_commands()

• Add Client.create_global_command()

• Add Client.create_guild_command()

• Add Client.delete_global_command()

• Add Client.delete_guild_command()

• Add Client.edit_command_permissions()

• A-A-Add Client.edit_global_command()

• Add Client.edit_guild_command()

• Add Client.fetch_command_permissions()

• Add Client.fetch_global_commands()

• Add Client.fetch_global_command()

• Add Client.fetch_guild_commands()

• Add Client.fetch_guild_command()

• Add Client.get_global_command()

• Add Client.get_global_command_named()

• Add Client.get_guild_application_commands()

• Add Client.get_guild_slash_commands()

• Add Client.get_guild_user_commands()

• Add Client.get_guild_message_commands()

• Add Client.get_guild_command()

• Add Client.get_guild_command_named()

• Add Client.global_application_commands

• Add Client.global_slash_commands

• Add Client.global_user_commands

• Add Client.global_message_commands

• [ext.commands] Suppowt fow swash commands and context menyus.

• [ext.commands] Add InvokableApplicationCommand - the base cwass fow invokabwe swash commands and context menyus.

• [ext.commands] Add InvokableSlashCommand fow swash command manyagement.

• [ext.commands] Add SubCommand fow swash s-sub-command manyagement.

• [ext.commands] Add SubCommandGroup fow swash sub-command gwoup manyagement.

• [ext.commands] Add InvokableUserCommand fow usew command manyagement (context menyus).

• [ext.commands] Add InvokableMessageCommand fow message command manyagement (context menyus).

• [ext.commands] Add ParamInfo fow wwapping annyotations.

• [ext.commands] Add slash_command fow swash command definyitions.

• [ext.commands] Add user_command fow usew command definyitions (context menyus).

• [ext.commands] Add message_command fow message command definyitions (context menyus).

• [ext.commands] Add Param (with an awias param) in case ParamInfo causes wintew ewwows.

• [ext.commands] Add Bot.slash_command fow swash command definyitions.

• [ext.commands] Add Bot.user_command fow usew command definyitions (context menyus).

• [e-ext.commands] Add Bot.message_command fow message command definyitions (context menyus).

• [ext.commands] Add Bot.after_slash_command_invoke - a decowatow fow post-invoke hooks fow swash commands.

• [ext.commands] Add Bot.after_user_command_invoke - a decowatow fow post-invoke hooks fow usew commands.

• [ext.commands] Add Bot.after_message_command_invoke - a decowatow fow post-invoke hooks fow message commands.

• [e-e-ext.commands] Add Bot.before_slash_command_invoke - a decowatow fow p-pwe-invoke h-h-hooks fow swash commands.

• [ext.commands] Add Bot.before_user_command_invoke - a decowatow fow pwe-invoke hooks f-f-fow usew commands.

• [ext.commands] Add Bot.before_message_command_invoke - a d-decowatow fow pwe-invoke hooks fow message commands.

• [ext.commands] Add Bot.add_slash_command

• [ext.commands] Add Bot.add_user_command

• [e-ext.commands] Add Bot.add_message_command

• [ext.commands] Add Bot.remove_slash_command

• [ext.commands] Add Bot.remove_user_command

• [ext.commands] Add Bot.remove_message_command

• [ext.commands] A-Add Bot.get_slash_command

• [ext.commands] A-A-Add Bot.get_user_command

• [e-ext.commands] Add Bot.get_message_command

• [ext.commands] Add Bot.slash_command_check

• [ext.commands] Add Bot.slash_command_check_once

• [ext.commands] Add Bot.user_command_check

• [ext.commands] Add Bot.user_command_check_once

• [ext.commands] Add Bot.message_command_check

• [ext.commands] Add Bot.message_command_check_once

• [ext.commands] Add Cog.cog_slash_command_check

• [ext.commands] Add Cog.cog_user_command_check

• [ext.commands] Add Cog.cog_message_command_check

• [ext.commands] Add Cog.cog_slash_command_error

• [ext.commands] Add Cog.cog_user_command_error

• [ext.commands] A-A-Add Cog.cog_message_command_error

• [ext.commands] Add Cog.cog_before_slash_command_invoke

• [ext.commands] Add Cog.cog_after_slash_command_invoke

• [ext.commands] Add Cog.cog_before_user_command_invoke

• [ext.commands] Add Cog.cog_after_user_command_invoke

• [ext.commands] Add Cog.cog_before_message_command_invoke

• [ext.commands] Add Cog.cog_after_message_command_invoke

• [ext.commands] Add Cog.bot_slash_command_check

• [ext.commands] Add Cog.bot_slash_command_check_once

• [ext.commands] Add Cog.bot_user_command_check

• [e-e-ext.commands] Add Cog.bot_user_command_check_once

• [ext.commands] Add Cog.bot_message_command_check

• [ext.commands] Add Cog.bot_message_command_check_once

Wegacy Changewog

Changewogs fow owdew vewsions (0.x, 1.x) can be found on the Wegacy Changewog page.