hen 0.10.0

Run API collections from the command line.
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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

use std::fmt::{self, Display, Formatter};

use pest::RuleType;

/// Alias for results that return a `HenError`.
pub type HenResult<T> = Result<T, HenError>;

/// High-level classification for hen errors to aid structured reporting.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum HenErrorKind {
    Cli,
    Input,
    Io,
    Parse,
    Planner,
    Execution,
    Benchmark,
    Prompt,
}

impl HenErrorKind {
    pub fn label(self) -> &'static str {
        match self {
            HenErrorKind::Cli => "CLI",
            HenErrorKind::Input => "Input",
            HenErrorKind::Io => "IO",
            HenErrorKind::Parse => "Parse",
            HenErrorKind::Planner => "Planner",
            HenErrorKind::Execution => "Execution",
            HenErrorKind::Benchmark => "Benchmark",
            HenErrorKind::Prompt => "Prompt",
        }
    }
}

/// Application error with a short summary and optional detail lines.
#[derive(Debug, Clone)]
pub struct HenError {
    kind: HenErrorKind,
    summary: String,
    details: Vec<String>,
    exit_code: i32,
}

impl HenError {
    /// Construct a new error with the provided kind and summary line.
    pub fn new(kind: HenErrorKind, summary: impl Into<String>) -> Self {
        Self {
            kind,
            summary: summary.into(),
            details: Vec::new(),
            exit_code: 1,
        }
    }

    /// Attach a detail line to the error for additional context.
    pub fn with_detail(mut self, detail: impl Into<String>) -> Self {
        self.details.push(detail.into());
        self
    }

    /// Override the process exit code returned for this error.
    pub fn with_exit_code(mut self, code: i32) -> Self {
        self.exit_code = code;
        self
    }

    pub fn kind(&self) -> HenErrorKind {
        self.kind
    }

    pub fn exit_code(&self) -> i32 {
        self.exit_code
    }
}

impl Display for HenError {
    fn fmt(&self, f: &mut Formatter<'_>) -> fmt::Result {
        writeln!(f, "[{}] {}", self.kind.label(), self.summary)?;
        for detail in &self.details {
            writeln!(f, "  - {}", detail)?;
        }
        Ok(())
    }
}

impl std::error::Error for HenError {}

/// Render an error to stderr using the structured format.
pub fn print_error(err: &HenError) {
    eprint!("{}", err);
}

impl<T> From<pest::error::Error<T>> for HenError
where
    T: RuleType + fmt::Debug,
{
    fn from(err: pest::error::Error<T>) -> Self {
        HenError::new(HenErrorKind::Parse, "Failed to parse hen file").with_detail(err.to_string())
    }
}