diff --git a/discord/client.py b/discord/client.py index 16b1cfe00..0d8d35e19 100644 --- a/discord/client.py +++ b/discord/client.py @@ -117,6 +117,14 @@ class Client: r"""Represents a client connection that connects to Discord. This class is used to interact with the Discord WebSocket and API. + .. container:: operations + + .. describe:: async with x + + Asynchronously initialises the client and automatically cleans up. + + .. versionadded:: 2.0 + A number of options can be passed to the :class:`Client`. Parameters diff --git a/discord/ext/commands/bot.py b/discord/ext/commands/bot.py index dae55120a..819adeed1 100644 --- a/discord/ext/commands/bot.py +++ b/discord/ext/commands/bot.py @@ -1387,6 +1387,14 @@ class Bot(BotBase, discord.Client): a :class:`~discord.app_commands.CommandTree` and is automatically set upon instantiating the class. + .. container:: operations + + .. describe:: async with x + + Asynchronously initialises the bot and automatically cleans up. + + .. versionadded:: 2.0 + Attributes ----------- command_prefix @@ -1457,6 +1465,14 @@ class Bot(BotBase, discord.Client): class AutoShardedBot(BotBase, discord.AutoShardedClient): """This is similar to :class:`.Bot` except that it is inherited from :class:`discord.AutoShardedClient` instead. + + .. container:: operations + + .. describe:: async with x + + Asynchronously initialises the bot and automatically cleans. + + .. versionadded:: 2.0 """ pass diff --git a/discord/shard.py b/discord/shard.py index bd16c18c1..6d309f54c 100644 --- a/discord/shard.py +++ b/discord/shard.py @@ -308,6 +308,14 @@ class AutoShardedClient(Client): if this is used. By default, when omitted, the client will launch shards from 0 to ``shard_count - 1``. + .. container:: operations + + .. describe:: async with x + + Asynchronously initialises the client and automatically. + + .. versionadded:: 2.0 + Attributes ------------ shard_ids: Optional[List[:class:`int`]]