oopsie 0.1.0-rc.20

Ergonomic, structured error handling: context selectors, traced errors, and rich colorized reports
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

#![allow(
    clippy::print_stdout,
    clippy::print_stderr,
    reason = "examples print to demonstrate library output"
)]
#![cfg_attr(
    feature = "unstable-error-generic-member-access",
    feature(error_generic_member_access)
)]

//! Convert a live error into a serializable `ErasedError` and emit it as JSON.
//!
//! Run with: `cargo run --example erased_json -p oopsie --features serde`

use oopsie::backtrace::set_override;
use oopsie::erased::ErasedError;
use oopsie::{Contextual as _, RustBacktrace, oopsie};

#[oopsie(traced)]
#[oopsie("upstream service {service} failed with status {status}")]
#[oopsie(
    code = "service::upstream",
    help = "retry with backoff or check the upstream health endpoint"
)]
pub struct UpstreamError {
    service: String,
    status: u16,
    source: std::io::Error,
}

fn call_upstream() -> Result<(), UpstreamError> {
    let io = std::io::Error::new(std::io::ErrorKind::ConnectionRefused, "connection refused");
    Err(UpstreamOopsie {
        service: "billing",
        status: 503u16,
    }
    .build_error(io))
}

fn main() {
    set_override(RustBacktrace::Enabled);

    let err = call_upstream().unwrap_err();

    // `ErasedError` flattens message, source chain, code/help, span trace, and
    // backtrace into a `Serialize` value usable in API responses or logs.
    let erased = ErasedError::from_error(err);
    let json = serde_json::to_string_pretty(&erased).expect("serialize ErasedError");
    println!("{json}");
}