Hikari

Breaking Changes

- Remove `RateLimitedError` in favour of always waiting on ratelimits. ([1441](https://github.com/hikari-py/hikari/issues/1441))
- ([1455](https://github.com/hikari-py/hikari/issues/1455))
- Default logging to `sys.stdout` stream to bring more in-line with banner output. ([1485](https://github.com/hikari-py/hikari/issues/1485))

Deprecation

- Deprecate selects v1 functionality:
- `ComponentType.SELECT_MENU` -> `ComponentType.TEXT_SELECT_MENU`
- Not passing `MessageActionRowBuilder.add_select_menu`'s `type` argument explicitly.
- `InteractionChannel` and `ResolvedOptionData` moved from `hikari.interactions.command_interactions` to `hikari.interactions.base_interactions`. ([1455](https://github.com/hikari-py/hikari/issues/1455))
- Renamed `Intents.GUILD_BANS` to `Intents.GUILD_MODERATION`. ([1471](https://github.com/hikari-py/hikari/issues/1471))

Features

- Add linked roles support (models + endpoints). ([1422](https://github.com/hikari-py/hikari/issues/1422))
- Add selects v2 components. ([1455](https://github.com/hikari-py/hikari/issues/1455))
- Added `fetch_self`, `edit`, `delete`, `sync`, and `create_guild` methods to `hikari.templates.Template`. ([1457](https://github.com/hikari-py/hikari/issues/1457))
- Add ability to suppress optimization warnings through `suppress_optimization_warning=True` to the `GatewayBot` or `RESTBot` constructors. ([1459](https://github.com/hikari-py/hikari/issues/1459))
- Support GIF sticker image format ([1464](https://github.com/hikari-py/hikari/issues/1464))
- Add support for guild audit log entry create events. ([1471](https://github.com/hikari-py/hikari/issues/1471))
- Update `RESTClient.edit_channnel` to support setting `applied_tags` on forum threads. ([1474](https://github.com/hikari-py/hikari/issues/1474))
- Implement `reply_must_exist` in create message methods ([1475](https://github.com/hikari-py/hikari/issues/1475))
- Support loading files through `logging.config.fileConfig` in `init_logging`. ([1485](https://github.com/hikari-py/hikari/issues/1485))
- Add `orjson` as an optional speedup and allow to pass custom `json.dumps` and `json.loads` functions to all components. ([1486](https://github.com/hikari-py/hikari/issues/1486))

Bugfixes

- The global ratelimit now abides by `max_rate_limit`. ([1441](https://github.com/hikari-py/hikari/issues/1441))
- Move `description_localizations` from `PartialCommand` to `SlashCommand` (removing it from `ContextMenuCommand`). ([1470](https://github.com/hikari-py/hikari/issues/1470))
- Add missing fields to `GuildChannel.edit`. ([1474](https://github.com/hikari-py/hikari/issues/1474))
- Fix `hikari.webhooks.ChannelFollowWebhook` not including source in all cases.
- `source_channel` and `source_guild` will be `None` instead. ([1480](https://github.com/hikari-py/hikari/issues/1480))
- Fix colour logging not occurring on specific terminals (ie, Pycharm). ([1485](https://github.com/hikari-py/hikari/issues/1485))

---

Breaking Changes

- Remove previously deprecated functionality.
This includes:
- `RESTClient.build_action_row` ([1438](https://github.com/hikari-py/hikari/issues/1438))

Bugfixes

- Fix deserializing old forum channels on `GUILD_CREATE` missing some fields. ([1439](https://github.com/hikari-py/hikari/issues/1439))

---

Breaking Changes

- `BulkDeleteError`:
- No longer contains a `messages_skipped` attribute.
- `messages_deleted` renamed to `deleted_messages`. ([1134](https://github.com/hikari-py/hikari/issues/1134))
- `RESTApp` and `RESTBucketManager` now need to be started and stopped by using `.start` and `.close`. ([1230](https://github.com/hikari-py/hikari/issues/1230))
- Remove long deprecated `async with` support for `EventStream`. ([1426](https://github.com/hikari-py/hikari/issues/1426))

Deprecation

- Deprecate the `delete_message_days` parameter for PartialGuild.ban and Member.ban. ([1378](https://github.com/hikari-py/hikari/issues/1378))

Features

- Allow async iterators in `RESTClient.delete_messages`. ([1134](https://github.com/hikari-py/hikari/issues/1134))
- `RESTClientImpl` improvements:
- You can now share client sessions and bucket managers across these objects or have them created for you.
- Speedup of request lifetime
- No-ratelimit routes no longer attempt to acquire rate limits
- Just for safety, a check is in place to treat the route as a rate limited route if a bucket is ever received for it and a error log is emitted. If you spot it around, please inform us! ([1230](https://github.com/hikari-py/hikari/issues/1230))
- Add `save()` method to `Resource`. ([1272](https://github.com/hikari-py/hikari/issues/1272))
- Allow specifying the `delete_message_seconds` parameter for PartialGuild.ban and Member.ban.
- This parameter can be specified as either an int, a float, or a datetime.timedelta object. ([1378](https://github.com/hikari-py/hikari/issues/1378))
- Support yielding in interaction listeners. ([1383](https://github.com/hikari-py/hikari/issues/1383))
- Add Indonesian locale as `hikari.Locale.ID`. ([1404](https://github.com/hikari-py/hikari/issues/1404))
- Improve pyright support ([1412](https://github.com/hikari-py/hikari/issues/1412))
- Improve error raised when attempting to use an asynchronous iterator synchronously. ([1419](https://github.com/hikari-py/hikari/issues/1419))
- Add missing `Application` fields:
- `Application.custom_install_url`
- `Application.tags`
- `Application.install_parameters` ([1420](https://github.com/hikari-py/hikari/issues/1420))
- Add support for guild forum channels. ([1430](https://github.com/hikari-py/hikari/issues/1430))
- Add a warning when not running in (at least) level 1 optimization mode. ([1431](https://github.com/hikari-py/hikari/issues/1431))

Bugfixes

- Buckets across different authentications are not shared any more, which would lead to incorrect rate limiting. ([1230](https://github.com/hikari-py/hikari/issues/1230))
- Suppress incorrect deprecation warning regarding event loops. ([1425](https://github.com/hikari-py/hikari/issues/1425))
- Properly close unclosed file descriptor when reading banner.
- This only affects versions of Python >= 3.9. ([1434](https://github.com/hikari-py/hikari/issues/1434))
- Start GC of bucket manager when creating a rest client. ([1435](https://github.com/hikari-py/hikari/issues/1435))
- Fix incorrect value in `CommandBuilder.is_nsfw`. ([1436](https://github.com/hikari-py/hikari/issues/1436))

---

Breaking Changes

- Remove previously deprecated functionality.

This includes:
- `Message.mentions`
- `nick` argument in rest methods
- `edit_permission_overwrites`, `edit_my_nick` and `command_builder` rest methods
- `CacheView.iterator` ([1347](https://github.com/hikari-py/hikari/issues/1347))

Deprecation

- Deprecate `RESTClientImpl.build_action_row` in favour of `RESTClientImpl.build_message_action_row`. ([1002](https://github.com/hikari-py/hikari/issues/1002))

Features

- Implement modal interactions.
- Additionally, it is now guaranteed (typing-wise) that top level components will be an action row ([1002](https://github.com/hikari-py/hikari/issues/1002))
- Add new `UserFlag.ACTIVE_DEVELOPER`. ([1355](https://github.com/hikari-py/hikari/issues/1355))
- Allow specifying a filename to `hikari.files.URL`. ([1368](https://github.com/hikari-py/hikari/issues/1368))
- Only subscribe to voice events when needed in the voice manager. ([1369](https://github.com/hikari-py/hikari/issues/1369))
- Add functionality to create and deserialize age-restricted (NSFW) commands. ([1382](https://github.com/hikari-py/hikari/issues/1382))
- Threads cache. ([1384](https://github.com/hikari-py/hikari/issues/1384))

Bugfixes

- Allow re-uploading attachments when creating messages ([1367](https://github.com/hikari-py/hikari/issues/1367))
- Fix error caused when disconnecting the bot and having active voice connections. ([1369](https://github.com/hikari-py/hikari/issues/1369))
- Remove incorrect `is_nsfw` field from threads.
- The "NSFW" status is inherited from the parent object and not sent for threads.
- This also involved moving the base attribute from `GuildChannel` to `PermissibleGuildChannel`. ([1386](https://github.com/hikari-py/hikari/issues/1386))

Documentation Improvements

- Documentation overhaul and move to docs.hikari-py.dev domain. ([1118](https://github.com/hikari-py/hikari/issues/1118))

---

Breaking Changes

- Moved permission overwrite mapping and permission related methods from `GuildChannel` to `PermissibleGuildChannel`. ([811](https://github.com/hikari-py/hikari/issues/811))
- Support v10 attachments edits

This includes breaking changes, features and things to look out for when editing messages:
- Modifying attachments in messages that contain embeds with any image attached to them now requires the images of that embed
image to be re-passed in the edit or they will be lost.
- `attachment` and `attachments` in message edits now support passing an `Attachment` object to keep existing attachments.
- `replace_attachments` has been removed, as it is now the default.
- `attachment` and `attachments` now supports `None` to replicate the behaviour of fully removing all attachments.
- `InteractionMessageBuilder.clear_attachments` has been implemented to remove existing attachments from messages. ([1260](https://github.com/hikari-py/hikari/issues/1260))

Features

- Thread support for REST requests and gateway events. ([811](https://github.com/hikari-py/hikari/issues/811))
- Startup and shutdown callbacks for the RESTBot interface/impl. ([999](https://github.com/hikari-py/hikari/issues/999))
- Support specifying `with_counts` and `with_expiration` in `RESTClient.fetch_invite` ([1330](https://github.com/hikari-py/hikari/issues/1330))
- Support for including the `SUPPRESS_EMBEDS` flag while creating a message. ([1331](https://github.com/hikari-py/hikari/issues/1331))
- Add `MANAGE_EVENTS` permission to `hikari.Permissions` ([1334](https://github.com/hikari-py/hikari/issues/1334))

Bugfixes

- Wrong typehint for `InviteGuild.features`. ([1307](https://github.com/hikari-py/hikari/issues/1307))
- Fix aiohttp error "charset must not be in content type" when using `InteractionServer` ([1320](https://github.com/hikari-py/hikari/issues/1320))
- The REST list methods (e.g. `fetch_channels`) no-longer raise `hikari.errors.UnrecognisedEntityError` when they encounter an unknown type. ([1337](https://github.com/hikari-py/hikari/issues/1337))
- Fix deprecation warnings in CPython3.11 in `hikari.internal.ux`. ([1344](https://github.com/hikari-py/hikari/issues/1344))

---

Breaking Changes

- Lifetime improvements breaking changes:
- `GatewayBot.join`'s `until_close` argument removed.
- `GatewayShardImpl.get_user_id` is no longer async and will now always be available.
- `GatewayBotAware` no longer defines the default parameters for `join`, `start` and `run`. It is left to implementation detail. ([1204](https://github.com/hikari-py/hikari/issues/1204))
- Remove support for ProcessPoolExecutor executor when reading files
- It is much more efficient to use a threadpool executor for I/O actions like this one
- Due to the nature of process pool, we were also not able to perform proper chunking when reading off the file ([1273](https://github.com/hikari-py/hikari/issues/1273))

Deprecation

- Deprecate `CacheView.iterator` in favour of using the `itertools` module. ([1289](https://github.com/hikari-py/hikari/issues/1289))

Features

- Add python 3.11-dev support. ([847](https://github.com/hikari-py/hikari/issues/847))
- Support for Application Command Localizations. ([1141](https://github.com/hikari-py/hikari/issues/1141))
- Improve components lifetimes:
- `GatewayBot`:
- General speedups.
- Fix a lot of edge cases of hard crashes if the application shuts unexpectedly.
- More consistent signal handling.
- `run`'s `shard_ids` argument can now be a `typing.Sequence`.
- Improved logging.
- `RESTBot`:
- Consistent signal handling inline with `GatewayBot`.
- Improved logging.
- Improved loop closing.
- `GatewayShardImpl`:
- New `is_connected` property to determine whether the shard is connected to the gateway.
- Faster websocket pulling and heartbeating.
- Improved error handling.
- Rate limiting changes:
- Chunking no longer has its own special ratelimit. Now it is shared with the rest of
"non-priority" packages sent, which is of 117/60s (3 less than the hard limit).
- "priority" packages currently only include heartbeating. ([1204](https://github.com/hikari-py/hikari/issues/1204))
- Implement slash option min/max length fields ([1216](https://github.com/hikari-py/hikari/issues/1216))
- Add `mention` property to `PartialChannel`. ([1221](https://github.com/hikari-py/hikari/issues/1221))
- Implement new Gateway reconnect logic enforced by Discord. ([1245](https://github.com/hikari-py/hikari/issues/1245))

Bugfixes

- Lifetime improvements bugfixes:
- `GatewayShardImpl` can now be instantiated out of an async environment for consistency with other components.
- Correct signal handling in `RESTBot`. ([1204](https://github.com/hikari-py/hikari/issues/1204))
- Improve `BadRequestError`'s error string. ([1213](https://github.com/hikari-py/hikari/issues/1213))
- Fix `hikari.impl.VoiceImpl.connect_to` silently failing if the guild or voice channel do not exist by providing a timeout. ([1242](https://github.com/hikari-py/hikari/issues/1242))
- `dm_permission` now correctly defaults to `True` instead of `False` when parsing command objects from Discord. ([1243](https://github.com/hikari-py/hikari/issues/1243))
- Fix float precision issues when creating a snowflake from a datetime object. ([1247](https://github.com/hikari-py/hikari/issues/1247))
- Fix `reposition_channels` to use the correct route. ([1259](https://github.com/hikari-py/hikari/issues/1259))
- Allow for `replace_attachments` kwarg to be used in `RESTClient.create_initial_response`. ([1266](https://github.com/hikari-py/hikari/issues/1266))
- Ignore guild create events which contain unavailable guilds ([1284](https://github.com/hikari-py/hikari/issues/1284))

---