oopsie 💥

Structured, context-rich error handling for Rust — define your error type once, attach it to any Result with .context(...), and render colorized diagnostic reports with automatic backtraces and span traces.

oopsie is 0.x: the public API may still change between minor releases.

A colorized oopsie error report — error code, source chain, and a filtered backtrace

📦 Install

cargo add oopsie

🚀 Quick start

use oopsie::prelude::*;

#[oopsie::oopsie(traced)]
pub enum AppError {
    #[oopsie("Connection to {host} failed")]
    Connect { host: String, source: std::io::Error },
}

fn connect(host: &str) -> Result<(), AppError> {
    std::net::TcpStream::connect(host)
        .context(app_oopsies::Connect { host })?;
    Ok(())
}

fn main() -> oopsie::Report<AppError> {
    oopsie::Report::run(|| connect("127.0.0.1:5432"))
}

#[oopsie] generates a context selector per variant — here app_oopsies::Connect, in a module named after the type (AppError → app_oopsies) — alongside Display, Debug, and Error impls. .context(selector) attaches your typed error to any Result or Option. traced adds a captured backtrace (and a span trace with the tracing feature) plus an automatic error code, and Report renders the result — including panics, via its hook — as the colorized output shown above.

Unlike thiserror, the attachment points and the renderer come built in; unlike anyhow / eyre, your errors stay strongly typed.

Crates

Crate	What it is
`oopsie`	The facade — `#[oopsie]`, `Report`, panic hook, prelude. Start here.
`oopsie-core`	Lower-level types (`Backtrace`, `SpanTrace`, `Diagnostic`, `Welp`), used through the facade.
`oopsie-macros`	The `#[oopsie]` attribute and `Oopsie` derive.

Feature flags are documented in the crate docs.

Development

The MSRV is 1.89. A nightly toolchain is pinned in rust-toolchain.toml for the snapshot tests and the unstable-feature lanes — you don't need it to use the crate.

just test    # snapshot-bearing combos (stable + nightly) plus doctests
just clippy  # lint both channels with -D warnings
cargo fmt    # format

Snapshot tests only match on the blessed feature combos; run just test-bless after a change that legitimately shifts one.

License