Hata

Summary

Channels now have a metadata system, making every channel share the same type.

This fixes a case when a precreated channel could mess up the channel's and other related entities lifecycle.

Improvements

- Add `should_request_users` parameter to `Client` constructor.
- Add `Channel` type inheriting all methods & properties of the old `ChannelBase`.
- Add `Channel.is_in_group_messageable`.
- Add `Channel.is_in_group_guild_messageable`.
- Add `Channel.is_in_group_guild_main_text`.
- Add `Channel.is_in_group_connectable`.
- Add `Channel.is_in_group_guild_connectable`.
- Add `Channel.is_in_group_private`.
- Add `Channel.is_in_group_guild`.
- Add `Channel.is_in_group_thread`.
- Add `Channel.is_in_group_can_contain_threads`.
- Add `Channel.is_guild_text`.
- Add `Channel.is_private`.
- Add `Channel.is_guild_voice`.
- Add `Channel.is_private_group`.
- Add `Channel.is_guild_category`.
- Add `Channel.is_guild_announcements`.
- Add `Channel.is_guild_store`.
- Add `Channel.is_thread`.
- Add `Channel.is_guild_thread_announcements`.
- Add `Channel.is_guild_thread_public`.
- Add `Channel.is_guild_thread_private`.
- Add `Channel.is_guild_stage`.
- Add `Channel.is_guild_directory`.
- Add `Channel.is_guild_forum`.
- Add `CHANNEL_TYPES.GROUP_IN_PRODUCTION`.
- Add `get_channel_type_name`.
- Add `get_channel_type_names`.
- Add `Channel.is_in_group_can_create_invite_to`.
- Add `CHANNEL_TYPED.GROUP_CAN_CREATE_INVITE_TO`.
- Add `CHANNEL_TYPES.GROUP_GUILD_MOVABLE`.
- Add `Channel.is_in_group_guild_movable`.
- Add `HubType`.
- Add `Guild.hub_type`.
- Add `hub_type` audit log converter.
- Add `send_start_notification` parameter to `Client.stage_create`.
- Enable animated `banner` in `Client.guild_edit` if the guild has `animated banner` feature.
- Do not require community feature in `Client.guild_edit` to edit `description`.
- Set `form` title max length to `45`.

ext.extension_loader

- Exception messages will not show internal frames.
- `Extension` class now supports rich attribute errors.
- When circularly loading extensions, `ImportError` is raised.
- `EXTENSION_LOADER.load_extension` returns the loaded extension.
- Add `Extension.__gt__`.
- Add `Extension.__lt__`.
- `EXTENSION_LOADER.load` returns the loaded extensions.
- `EXTENSION_LOADER.unload` returns the unloaded extensions.
- `EXTENSION_LOADER.reload` returns the reloaded extensions.
- Add `Extension.path`.
- Now python implementation errors wont stop us to load & reload modules caused by dead locked imports.
- Sync extension loading & unloading to avoid parallel calls on a single file.
- `ExtensionLoader` class now supports rich attribute errors.

ext.commands_v2

- Add missing `CommandContentParser.__repr__`.
- `CommandContentParser` now support rich attribute error messages.
- Add missing `CommandContentParser.__eq__`.
- Add missing `CommandContentParser.__hash__`.
- `ContentParserParameter` now support rich attribute error messages.
- Add missing `ContentParserParameter.__eq__`.
- Add missing `ContentParserParameter.__hash__`.
- `ContentParserParameterDetail` now support rich exception messages.
- Add missing `ContentParserParameterDetail.__eq__`.
- Add missing `ContentParserParameterDetail.__hash__`.
- `ConverterSetting` now support rich attribute error messages.
- Add missing `ConverterSetting.__eq__`.
- Add missing `ConverterSetting.__hash__`.
- `ContentParameterParser` now support rich exception messages.
- `ContentParameterParserContextBase` now support rich attribute error messages.
- Add missing `ContentParameterParserContextBase.__repr__`.
- Add missing `ContentParameterParserContextBase.__eq__`.
- Add missing `ContentParameterParserContextBase.__hash__`.
- Add missing `CommandProcessor.__repr__`.

Bug Fixes

- `datetime_to_unix_time` returned incorrect value.
- `run_console_till_interruption` could raise is called outside from a module. (Forest2913)
- `User.from_data` didn't update guild profile every time.

ext.slash

- `Slasher.discard_kept_commands` was missing the last `s` from the end. :derp:

ext.commands_v2

- Commands were not unlinked correctly.

Renames, Deprecation & Removals

- Deprecate `ChannelBase`.
- Deprecate `ChannelTextBase`.
- Deprecate `ChannelGuildBase`.
- Deprecate `ChannelGuildMainBase`.
- Deprecate `ChannelCategory`.
- Deprecate `ChannelDirectory`.
- Deprecate `ChannelForum`.
- Deprecate `ChannelStore`.
- Deprecate `ChannelGuildUndefined`.
- Deprecate `ChannelVoiceBase`.
- Deprecate `ChannelVoice`.
- Deprecate `ChannelStage`.
- Deprecate `ChannelPrivate`.
- Deprecate `ChannelGroup`.
- Deprecate `ChannelThread`.
- Rename `CHANNEL_NAMES.GROUP_GUILD_TEXT_LIKE` to `.GROUP_GUILD_MAIN_TEXT`.
- Deprecate `Guild.booster_count`.
- Rename `Guild.booster_count` to `.boost_count`.
- Deprecate `ButtonStyle.violet`.
- Rename `ButtonStyle.violet` to `.blue` (seems like they never intended it to be burple)

Improvements

- `allow_by_default` should not default based on `required_permissions`.
- Force request application command localizations.
- Improve `DiscordGatewayException` error messages.
- Improve `ChannelTextBase` docs mentioning that you are looking at a bad class for general channel methods.
- Plugged in cli commands are now supported.
- Add `Locale.native_name`.

Bug fixes

- Use `create_event_loop` instead of `EventThread`, so `get_event_loop` wont fail in the main thread initially.

Renames, Deprecation & Removals

- Rename `Locale.spanish_sp` to `.spanish`
- Deprecate `Locale.spanish_sp`.
- Rename `Locale.portuguese_br` to `.portuguese`
- Deprecate `Locale.portuguese_br`.

Improvements

- Add `ApplicationCommand.version`.
- Add `ApplicationCommand.edited_at`.
- Add `e` format code to `ApplicationCommand`.
- Add `ApplicationCommand._create_empty`.
- `ApplicationCommandOption` now supports rich attribute errors.
- `ApplicationCommandOptionChoice` now supports rich attribute errors.
- `ApplicationCommandPermission` now supports rich attribute errors.
- `ApplicationCommandPermissionOverwrite` now supports rich attribute errors.
- `Client.achievement_create`'s `description_localizations` parameter is now validated.
- `Client.achievement_create`'s `name_localizations` parameter is now validated.
- `Client.achievement_edit`'s `description_localizations` parameter is now validated.
- `Client.achievement_edit`'s `name_localizations` parameter is now validated.
- Add `required_permissions` parameter to `ApplicationCommand.__new__`.
- Add `ApplicationCommand.required_permissions`.
- `ApplicationCommandOptionChoice.__new__`'s `value` parameter is not optional and defaults to `name`.
- Add `name_localizations` parameter to `ApplicationCommandOptionChoice.__new__`.
- Add `ApplicationCommandOptionChoice.name_localizations`.
- Add `name_localizations` parameter to `ApplicationCommandOption.__new__`.
- Add `ApplicationCommandOption.name_localizations`.
- Add `description_localizations` parameter to `ApplicationCommandOption.__new__`.
- Add `ApplicationCommandOption.description_localizations`.
- Add `name_localizations` parameter to `ApplicationCommand.__new__`.
- Add `ApplicationCommand.name_localizations`.
- Add `description_localizations` parameter to `ApplicationCommand.__new__`.
- Add `ApplicationCommand.description_localizations`.
- Add `ApplicationCommandOptionChoice.copy`.
- Add `OA2Access.expires_at`.
- `ApplicationCommand.__new__`'s `description` parameter defaults to `name` one.
- Add `ApplicationCommand.apply_translation`.
- Add `ApplicationCommandOption.apply_translation`.
- Add `ApplicationCommandOptionChoice.apply_translation`.
- Add `ComponentType.user_select`.
- Add `ComponentType.role_select`.
- Add `ComponentType.mentionable_select`.
- Add `ComponentType.channel_select`.

ext.slash
- Add `required_permissions` parameter to slasher application commands.
- Add `SlasherSyncError` to improve sync exceptions' readability. (experimental)

Bug fixes

- `Achievement.description_localizations` not correctly defaulted to `None`.
- `Achievement.name_localizations` not correctly defaulted to `None`.
- `ChannelGuildBase.to_data` returned incorrect value (typo). (FoxeiZ)

Renames, Deprecation & Removals

- Rename `OA2Access.expires_in` to `.expires_after`.
- Deprecate `OA2Access.expires.in`.

Improvements

- Change embed author constructor parameter order to `name, icon_url, url` from `icon_url`, `name`, `url`. On this
way it is more intuitive and matches the footer's parameter order as well. Drop warning if passed in bad order.
- `MessageInteraction` now picks up the `member` field from payload.
- Update max auto-completion options to 25 (from 20).
- Auto generate bit flag getters, setters and deleters instead of using descriptors (this improves performance).
- Add `ERROR_CODES.invalid_oauth2_redirect_url`.

ext.slash
- `int` fields with applied max or min values are translated to `number` ones.

Bug fixes
- `Sticker.user` was not updated when expected.
- Update message content fields correctly when polling from cache.

Renames, Deprecation & Removals
- Rename `start_embedded_activities` to `use_embedded_activities` permission.
- Add deprecated `Permission.can_start_embedded_activities` property.

Improvements

- Add `User.from_data`. New user constructor, which can bind guild profile even if the guild is uncached.
- Add `ERROR_CODES.unknown_guild_welcome_screen`.
- `Role` constructor now accepts `guild_id` instead of `Guild`.
- `Client.events.guild_user_add` will fire instantly even if the guild is not cached.
- `Client.events.role_create` will fire instantly even if the guild is not cached.
- Add `VoiceServerUpdateEvent.guild` property.
- Add `GuildUserChunkEvent.guild` property.
- Add `WebhookUpdateEvent`.

Bug fixes

- `_delete_reaction_with_task` ignored `GeneratorExit`.
- `Client.connect` ignored `GeneratorExit`.
- `WaitForHandler.__call__` ignored `GeneratorExit`.
- `_with_error` ignored `GeneratorExit`.

ext.commands_v2

- `CommandProcessor.__call__` ignored `GeneratorExit`.
- `process_command_coroutine_generator` ignored `GeneratorExit`.
- `CheckCustom.__call__` ignored `GeneratorExit`.
- `CommandContext.invoke` ignored `GeneratorExit`.

ext.command_utils

- `ChooseMenu.__call__` ignored `GeneratorExit`.
- `Closer.__call__` ignored `GeneratorExit`.
- `UserMenu.__call__` ignored `GeneratorExit`.
- `UserMenu._handle_close_exception` ignored `GeneratorExit`.
- `PaginationBase._handle_close_exception` ignored `GeneratorExit`.
- `Pagination.__call__` ignored `GeneratorExit`.

ext.extension_loader

- `ExtensionLoader._load_extension` ignored `GeneratorExit`.
- `ExtensionLoader._unload_extension` ignored `GeneratorExit`.

ext.slash

- `acknowledge_component_interaction` ignored `GeneratorExit`.
- `Slasher._sync_permission_task` ignored `GeneratorExit`.
- `Slasher._create_command` ignored `GeneratorExit`.
- `Slasher._delete_command` ignored `GeneratorExit`.
- `Slasher._edit_command` ignored `GeneratorExit`.
- `Slasher._edit_guild_command_to_non_global` ignored `GeneratorExit`.
- `Slasher._register_command_task` ignored `GeneratorExit`.
- `Slasher._dispatch_application_command_event` ignored `GeneratorExit`.
- `Slasher._dispatch_application_command_autocomplete_event` ignored `GeneratorExit`.
- `Slasher._sync_guild_task` ignored `GeneratorExit`.
- `Slasher._sync_global_task` ignored `GeneratorExit`.
- `process_command_coroutine_generator` ignored `GeneratorExit`.
- `Menu._handle_close_exception` ignored `GeneratorExit`.
- `Menu.__call__` ignored `GeneratorExit`.
- `Menu._canceller_function` ignored `GeneratorExit`.
- `FormSubmitCommand.__call__` ignored `GeneratorExit`.
- `handle_command_exception` ignored `GeneratorExit`.
- `ComponentCommand.__call__` ignored `GeneratorExit`.
- `SlasherApplicationCommandFunction.__call__` ignored `GeneratorExit`.
- `SlasherApplicationCommandParameterAutoCompleter.__call__` ignored `GeneratorExit`.

Renames, Deprecation & Removals

- Deprecate `User.__new__`. Use `User.from_data` instead.
- `Client.events.webhook_update` now has `client, events` parameters (from `client, channel`). If added with `channel`
parameter, deprecation is dropped.

Improvements

- Add `DiscordException.debug_options`.

Bug fixes

- `Sticker.description` now correctly defaults to `None`.