Errors#

ArcError #

Bases: Exception

Base exception for all Arc errors.

AutocompleteError #

Bases: ArcError

An error occurred while trying to autocomplete a command.

BotMissingPermissionsError #

BotMissingPermissionsError(missing_permissions: Permissions, *args: Any)

Bases: HookAbortError

Raised when a command is invoked and the bot is missing the required permissions set by a bot_has_permissions hook.

ATTRIBUTE	DESCRIPTION
`missing_permissions`	The permissions that the bot is missing. TYPE: `Permissions`

CommandInvokeError #

Bases: ArcError

An error occurred while trying to invoke a command.

CommandPublishFailedError #

Bases: ArcError

Raised when a set of commands could not be published to Discord.

DMOnlyError #

Bases: HookAbortError

Raised when a command is invoked outside of a DM and a dm_only hook is present.

ExtensionError #

Bases: ArcError

A base exception for all extension errors.

ExtensionLoadError #

Bases: ExtensionError

An error occurred while trying to load an extension.

ExtensionUnloadError #

Bases: ExtensionError

An error occurred while trying to unload an extension.

GlobalCommandPublishFailedError #

Bases: CommandPublishFailedError

Raised when a command could not be published to Discord.

GuildCommandPublishFailedError #

GuildCommandPublishFailedError(guild_id: Snowflake, *args: Any)

Bases: CommandPublishFailedError

Raised when a set of commands could not be published to a guild.

ATTRIBUTE	DESCRIPTION
`guild_id`	The guild that commands could not be published to. TYPE: `Snowflake`

GuildOnlyError #

Bases: HookAbortError

Raised when a command is invoked outside of a guild and a guild_only hook is present.

HookAbortError #

Bases: ArcError

Raised when a built-in hook aborts the execution of a command.

InteractionResponseError #

Bases: ArcError

Base exception for all interaction response errors.

InvokerMissingPermissionsError #

InvokerMissingPermissionsError(missing_permissions: Permissions, *args: Any)

Bases: HookAbortError

Raised when a command is invoked by a user without the required permissions set by a has_permissions hook.

ATTRIBUTE	DESCRIPTION
`missing_permissions`	The permissions that the invoker is missing. TYPE: `Permissions`

MaxConcurrencyReachedError #

MaxConcurrencyReachedError(
    limiter: ConcurrencyLimiterProto[Any], max_concurrency: int, *args: Any
)

Bases: ArcError

Raised when a built-in concurrency limiter is acquired while it is exhausted.

ATTRIBUTE	DESCRIPTION
`limiter`	The limiter that was exhausted. TYPE: `ConcurrencyLimiterProto`
`max_concurrency`	The maximum amount of concurrent instances of the command that reached max concurrency. TYPE: `int`

NoResponseIssuedError #

Bases: InteractionResponseError

Raised when no response was issued by a command. Interactions must be responded to or deferred within 3 seconds to avoid this error.

arc tries to automatically defer responses when possible, so this error should rarely occur, unless autodefer is disabled.

NotOwnerError #

Bases: HookAbortError

Raised when a command is invoked by a non-owner and a owner_only hook is present.

OptionConverterFailureError #

OptionConverterFailureError(
    option: ConverterOption[Any, Any, Any, Any], value: Any, *args: Any
)

Bases: ArcError

Raised when an option converter fails to convert a value.

ATTRIBUTE	DESCRIPTION
`option`	The option that failed to convert the value. TYPE: `ConverterOption`
`value`	The value that failed to be converted. TYPE: `Any`

ResponseAlreadyIssuedError #

Bases: InteractionResponseError

Raised when a response was already issued to an interaction. Interactions can only be issued one initial response, every other response should be a followup.

Note that certain actions can only be done in an initial response, such as sending modals or builders.

UnderCooldownError #

UnderCooldownError(limiter: LimiterProto[Any], retry_after: float, *args: Any)

Bases: ArcError

Raised when a built-in ratelimiter is acquired while it is exhausted, and the wait parameter is set to False.

ATTRIBUTE	DESCRIPTION
`limiter`	The limiter that was rate limited. TYPE: `LimiterProto`
`retry_after`	The amount of time in seconds until the command is off cooldown. TYPE: `float`