aerro 0.3.0

Cross-service gRPC error framework for Rust.
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

//! Same typed error encoded at three exposure tiers; observe what each tier
//! ships to its audience.

use aerro::wire::encode::EncodeOptions;
use aerro::{Exposure, IntoStatus};

#[derive(Debug, aerro::Aerro)]
pub enum Db {
    #[aerro(
        category = System,
        code = Internal,
        error = "db.unreachable: {host}"
    )]
    Unreachable { host: String },
}

fn show(label: &str, exposure: Exposure) {
    let err = Db::Unreachable {
        host: "prod-shard-42.internal".into(),
    };
    let st = err.into_status(&EncodeOptions {
        exposure,
        max_frames: 16,
    });
    println!(
        "{label} (Exposure::{:?}): code={:?} message={:?} details_bytes={}",
        exposure,
        st.code(),
        st.message(),
        st.details().len()
    );
}

fn main() {
    show("Internal", Exposure::Internal);
    show("Trusted ", Exposure::Trusted);
    show("Public  ", Exposure::Public);
}