Crate tiny_bail

Tiny bailing convenience macros.

Bailing is an error-handling pattern that takes the middle path between unwrap and ?:

• Compared to unwrap: Bail will return, continue, or break instead of panicking.
• Compared to ?: Bail will log or ignore the error instead of propagating it.

The middle path avoids unwanted panics without the ergonomic challenges of propagating errors with ?.

Getting started

This crate provides six macro variants:

• or_return!
• or_return_quiet!
• or_continue!
• or_continue_quiet!
• or_break!
• or_break_quiet!

Along with their tiny aliases: r!, rq!, c!, cq!, b!, and bq!.

The macros support Result, Option, and bool types out of the box. Implement IntoResult to extend this to other types.

Example

use tiny_bail::prelude::*;

// With `tiny_bail`:
fn increment_last(arr: &mut [i32]) {
    *r!(arr.last_mut()) += 1;
}

// Without `tiny_bail`:
fn increment_last_manually(arr: &mut [i32]) {
    if let Some(x) = arr.last_mut() {
        *x += 1;
    } else {
        println!("Bailed at src/example.rs:34:18: `arr.last_mut()`");
        return;
    }
}

Modules

• explicit
  Re-exported macros.
• prelude
  Re-exported macros and tiny aliases.

Macros

• or_break
  Unwrap or break with a warning.
• or_break_quiet
  Unwrap or break quietly.
• or_continue
  Unwrap or continue with a warning.
• or_continue_quiet
  Unwrap or continue quietly.
• or_return
  Unwrap or return with a warning.
• or_return_quiet
  Unwrap or return quietly.

Traits

• IntoResult
  An extension trait for separating success and failure values.