ratto 0.3.1

Ratatui-powered terminal primitives for shell dashboards: flicker-free repaints, progress bars, prompts, and portable time tools
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

pub const OK: i32 = 0;
pub const FAILURE: i32 = 1;
pub const TIMEOUT: i32 = 124;
pub const ABORTED: i32 = 130;

/// Command-level failure carrying its process exit code. Only `main` turns
/// this into `process::exit`; everything else returns `AppResult`.
#[derive(Debug)]
pub enum AppError {
    /// Message printed to stderr, exit 1.
    Fail(anyhow::Error),
    /// Silent, exit 1 (Esc / nothing selected, matching gum).
    NoSelection,
    /// Silent, exit 130 (Ctrl-C).
    Aborted,
    /// "timed out" printed to stderr, exit 124.
    Timeout,
    /// Silent, exit with the child's code (`rat spin`).
    Child(i32),
}

impl AppError {
    pub fn code(&self) -> i32 {
        match self {
            AppError::Fail(_) | AppError::NoSelection => FAILURE,
            AppError::Aborted => ABORTED,
            AppError::Timeout => TIMEOUT,
            AppError::Child(code) => *code,
        }
    }
}

impl From<anyhow::Error> for AppError {
    fn from(err: anyhow::Error) -> Self {
        AppError::Fail(err)
    }
}

pub type AppResult = Result<(), AppError>;

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn code_per_variant() {
        assert_eq!(AppError::Fail(anyhow::anyhow!("boom")).code(), 1);
        assert_eq!(AppError::NoSelection.code(), 1);
        assert_eq!(AppError::Aborted.code(), 130);
        assert_eq!(AppError::Timeout.code(), 124);
        assert_eq!(AppError::Child(7).code(), 7);
    }

    #[test]
    fn from_anyhow_is_fail() {
        let err: AppError = anyhow::anyhow!("boom").into();
        assert_eq!(err.code(), 1);
        assert!(matches!(err, AppError::Fail(_)));
    }

    #[test]
    fn constants() {
        assert_eq!(OK, 0);
        assert_eq!(FAILURE, 1);
        assert_eq!(TIMEOUT, 124);
        assert_eq!(ABORTED, 130);
    }
}