diff options
| author | Rapptz <[email protected]> | 2019-03-19 07:35:56 -0400 |
|---|---|---|
| committer | Rapptz <[email protected]> | 2019-03-19 09:23:11 -0400 |
| commit | d9e54d7dd36368bb97b3c31225901ba80cb81a62 (patch) | |
| tree | 1254d4ea7643afa9c0912d477598bd90c5f49601 /docs/ext | |
| parent | [commands] Add Bot.reload_extension for atomic loading. (diff) | |
| download | discord.py-d9e54d7dd36368bb97b3c31225901ba80cb81a62.tar.xz discord.py-d9e54d7dd36368bb97b3c31225901ba80cb81a62.zip | |
[commands] Redesign extension exception flow.
Instead of raising a whole variety of exceptions, they are now wrapped
into ExtensionError derived classes.
* ExtensionAlreadyLoaded
* Raised when an extension is already loaded in Bot.load_extension
* ExtensionNotLoaded
* Raised when an extension is not loaded, e.g. Bot.unload_extension
* NoEntryPointError
* Raised when an extension does not have a `setup` function.
* ExtensionFailed
* Raised when an extension's `setup` function fails.
* ExtensionNotFound
* Raised when an extension's module import fails.
Diffstat (limited to 'docs/ext')
| -rw-r--r-- | docs/ext/commands/api.rst | 25 |
1 files changed, 25 insertions, 0 deletions
diff --git a/docs/ext/commands/api.rst b/docs/ext/commands/api.rst index ca822c40..4722a56a 100644 --- a/docs/ext/commands/api.rst +++ b/docs/ext/commands/api.rst @@ -285,6 +285,25 @@ Exceptions .. autoexception:: discord.ext.commands.BotMissingPermissions :members: +.. autoexception:: discord.ext.commands.ExtensionError + :members: + +.. autoexception:: discord.ext.commands.ExtensionAlreadyLoaded + :members: + +.. autoexception:: discord.ext.commands.ExtensionNotLoaded + :members: + +.. autoexception:: discord.ext.commands.NoEntryPointError + :members: + +.. autoexception:: discord.ext.commands.ExtensionFailed + :members: + +.. autoexception:: discord.ext.commands.ExtensionNotFound + :members: + + Exception Hierarchy +++++++++++++++++++++ @@ -311,3 +330,9 @@ Exception Hierarchy - :exc:`~.commands.DisabledCommand` - :exc:`~.commands.CommandInvokeError` - :exc:`~.commands.CommandOnCooldown` + - :exc:`~.commands.ExtensionError` + - :exc:`~.commands.ExtensionAlreadyLoaded` + - :exc:`~.commands.ExtensionNotLoaded` + - :exc:`~.commands.NoEntryPointError` + - :exc:`~.commands.ExtensionFailed` + - :exc:`~.commands.ExtensionNotFound` |