#error #discord-bot #poise #opinionated #handle #let #plug

poise_error

An opinionated plug-and-play library for error handling in Discord bots made with poise

3 stable releases

new 1.2.0 Jan 24, 2025
1.1.0 Jan 23, 2025
1.0.0 Jan 21, 2025

#1017 in Web programming

Download history 15/week @ 2025-01-15 322/week @ 2025-01-22

337 downloads per month

MIT license

22KB
374 lines

poise_error

An opinionated plug-and-play library for error handling in Discord bots made with poise.

To get started, plug poise_error::on_error into your poise::FrameworkOptions to let poise_error handle your bot's errors.

use poise_error::on_error;

let framework = poise::Framework::builder()
    .options(poise::FrameworkOptions {
        on_error,
        ..Default::default()
    })
    .build();

See the docs for more information.

Examples

Goober Bot is a Discord bot which uses poise_error, here's how it looks:

Screenshot 2025-01-22 at 6 23 00 PM

Screenshot 2025-01-22 at 6 24 01 PM

/// Fails intentionally
#[command(slash_command)]
async fn error(
    _ctx: Context<'_>,
    #[description = "Kind of error to return"] kind: ErrorKind,
) -> Result<(), poise_error::anyhow::Error> {
    match kind {
        ErrorKind::User => bail!(UserError(
            anyhow!("This is an example of a user error")
                .context("This is an example of extra context")
        )),
        ErrorKind::Internal => Err(anyhow!("This is an example of an internal error")
            .context("This is an example of extra context")),
        ErrorKind::Panic => panic!("This is an example of a panic"),
    }
}

Dependencies

~16–30MB
~447K SLoC