errcraft 0.1.0

Beautiful, structured, and colorful error handling 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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

//! Simple example demonstrating basic error creation and display.

use errcraft::ErrFrame;

fn read_config(path: &str) -> Result<String, ErrFrame> {
    std::fs::read_to_string(path).map_err(|e| {
        ErrFrame::new("Failed to read configuration file")
            .context("path", path.to_string())
            .context("operation", "read")
            .with_source(e)
    })
}

fn parse_config(content: &str) -> Result<(), ErrFrame> {
    if content.is_empty() {
        return Err(ErrFrame::new("Configuration file is empty")
            .context_text("Expected valid TOML content"));
    }
    Ok(())
}

fn load_and_parse_config(path: &str) -> Result<(), ErrFrame> {
    let content = read_config(path)?;
    parse_config(&content)?;
    Ok(())
}

fn main() {
    println!("=== errcraft Simple Example ===\n");

    // Example 1: Basic error
    let err1 = ErrFrame::new("Something went wrong");
    println!("Example 1: Basic error");
    err1.eprint();
    println!();

    // Example 2: Error with context
    let err2 = ErrFrame::new("Database connection failed")
        .context("host", "localhost")
        .context("port", 5432)
        .context("database", "myapp");
    println!("Example 2: Error with context");
    err2.eprint();
    println!();

    // Example 3: Real file error with chaining
    println!("Example 3: Real file error");
    if let Err(e) = load_and_parse_config("nonexistent.toml") {
        e.eprint();
    }
    println!();

    // Example 4: Error with text context
    let err4 = ErrFrame::new("Upload failed")
        .context("file", "report.pdf")
        .context("size_mb", 50)
        .context_text("File size exceeded the 25MB limit")
        .context_text("Please compress the file and try again");
    println!("Example 4: Error with text context");
    err4.eprint();
}