ILLEST Developers

illest.py 2.3.1

Errors

Read from the library itself: every signature and every word here is its own docstring.

IllestException

exceptionfrom Exception

illest.IllestException

class IllestException

The root of every error this library raises on purpose.

ClientException

exceptionfrom IllestException

illest.ClientException

class ClientException

The library refused before anything was sent: a call made at the wrong time or with the wrong arguments.

LoginFailure

exceptionfrom ClientException

illest.LoginFailure

class LoginFailure

The bot token was refused: unknown, revoked, or its bot or its owner banned. Mint a new token in Settings, Developers.

ConnectionClosed

exceptionfrom IllestException

illest.ConnectionClosed

class ConnectionClosed

The socket dropped while a request waited for its answer. Nothing is known about whether the server acted on it.

GatewayNotFound

exceptionfrom ConnectionClosed

illest.GatewayNotFound

class GatewayNotFound

The server could not be reached at all: no connection, the address unreachable, or the server down. Its message names the address and what happened; the client tried a few times before raising it. A ConnectionClosed, as it was before 2.2.0.

Forbidden

exceptionfrom GatewayError

illest.Forbidden

class Forbidden(code: 'str', message: 'str')

The bot is not allowed to do this here (FORBIDDEN): a guild permission it lacks, or a member above it.

MissingScope

exceptionfrom Forbidden

illest.MissingScope

class MissingScope(code: 'str', message: 'str', scopes: 'list[str]')

The bot's tokens do not hold the scope this action needs. Grant it by minting a token with it in Settings, Developers.

scopes lists every scope that would have done (any one is enough); scope is the first.

NotFound

exceptionfrom GatewayError

illest.NotFound

class NotFound(code: 'str', message: 'str')

No such thing, or none the bot can see (NOT_FOUND).

RateLimited

exceptionfrom GatewayError

illest.RateLimited

class RateLimited(code: 'str', message: 'str', retry_after: 'float | None' = None)

The server's budget for this action ran out (RATE_LIMITED) and the library's retries did too.

retry_after is how many seconds the library expects the budget to need, from the server when it says, else from the action's published rate.

InteractionResponded

exceptionfrom ClientException

illest.InteractionResponded

class InteractionResponded(interaction: 'object' = None)

An interaction was answered already: interaction.response takes one answer, and the rest go through interaction.followup.

PrivilegedIntentsRequired

exceptionfrom ClientException

illest.PrivilegedIntentsRequired

class PrivilegedIntentsRequired(intents: 'object' = None)

An intent the bot asked for needs a scope its tokens do not hold. Turn it on in Settings, Developers.

CommandError

exceptionfrom IllestException

illest.ext.commands.CommandError

class CommandError

The root of the command errors.

AppCommandError

exceptionfrom IllestException

illest.app_commands.AppCommandError

class AppCommandError