From d9e54d7dd36368bb97b3c31225901ba80cb81a62 Mon Sep 17 00:00:00 2001 From: Rapptz Date: Tue, 19 Mar 2019 07:35:56 -0400 Subject: [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. --- docs/ext/commands/api.rst | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) (limited to 'docs') 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` -- cgit v1.2.3