error-battery-pack 0.6.1

Error handling done well — anyhow for apps, thiserror for libraries
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
51
52
53
54
55
56
57
58
59
60
61
62

//! Error context chains with anyhow.
//!
//! Run with: `cargo run --example context-chain -p error-battery-pack`
//!
//! Each layer in the call stack adds context, producing output like:
//!
//! ```text
//! failed to start server
//!
//! Caused by:
//!     0: failed to load config from "server.toml"
//!     1: invalid value for field "port"
//!     2: invalid digit found in string
//! ```

use anyhow::{Context, Result, bail};

fn parse_field(value: &str) -> Result<u16> {
    let port: u16 = value.trim().parse()?;

    if port == 0 {
        bail!("port must not be zero");
    }

    Ok(port)
}

fn load_config(_path: &str) -> Result<u16> {
    // Simulate reading a config file with a bad port value
    let raw_config = "port = notanumber";

    let port_str = raw_config
        .strip_prefix("port = ")
        .context("missing 'port' field")?;

    parse_field(port_str).context("invalid value for field \"port\"")
}

fn start_server() -> Result<()> {
    let path = "server.toml";
    let port =
        load_config(path).with_context(|| format!("failed to load config from \"{path}\""))?;

    println!("listening on port {port}");
    Ok(())
}

fn main() {
    if let Err(e) = start_server().context("failed to start server") {
        // The {:#} formatter shows the full chain on one line:
        //   failed to start server: failed to load config from "server.toml": ...
        println!("One-line:   {e:#}");

        // The {:?} formatter shows the chain vertically:
        //   failed to start server
        //   Caused by:
        //       0: failed to load config...
        //       1: invalid value for field "port"
        //       2: invalid digit found in string
        println!("\nFull chain:\n{e:?}");
    }
}