human-errors 0.2.4

An error library focused on providing your users with relevant advice for any problem.
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

//! Previews the pretty (CLI-formatted) error output.
//!
//! Requires the `pretty` feature. Run with:
//!
//! ```sh
//! cargo run --example pretty --features pretty
//! ```

fn main() {
    let err = build_error();

    // `pretty` renders a richly formatted view of the error, its causal chain
    // and the aggregated advice for the user.
    println!("{}", human_errors::pretty(&err));
}

/// Builds a representative, multi-layered error for demonstration purposes.
fn build_error() -> human_errors::Error {
    human_errors::wrap_user(
        human_errors::wrap_system(
            std::io::Error::new(
                std::io::ErrorKind::PermissionDenied,
                "os error 13: permission denied",
            ),
            "Failed to read the configuration file at /etc/demo/config.yml.",
            &["Ensure the application has permission to read the file."],
        ),
        "We could not load your configuration.",
        &["Check that the --config option points to a readable file."],
    )
}