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 default (plain-text) error output.
//!
//! Run with:
//!
//! ```sh
//! cargo run --example default
//! ```

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

    // The `Display` implementation (and `Error::message`) produces the
    // default, human-readable representation of the error.
    println!("{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."],
    )
}