audiorouter-core 0.1.5

Core config, validation, device resolution, and dashboard API DTOs for audiorouter
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

//! Error categories for distinguishing exit codes.
//!
//! - [`ErrorKind::Config`] -> exit code 1 (config/validation failure)
//! - [`ErrorKind::Runtime`] -> exit code 2 (runtime / device / I-O error)

/// Error category carried alongside messages to select exit codes.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum ErrorKind {
    /// Config validation or parse failure — exit code 1.
    Config,
    /// Runtime, device, or I-O error — exit code 2.
    Runtime,
}

/// A message tagged with an [`ErrorKind`] so the caller can pick the right exit code.
#[derive(Debug)]
pub struct AppError {
    pub kind: ErrorKind,
    pub message: String,
}

impl AppError {
    pub fn config(msg: impl Into<String>) -> Self {
        Self {
            kind: ErrorKind::Config,
            message: msg.into(),
        }
    }

    pub fn runtime(msg: impl Into<String>) -> Self {
        Self {
            kind: ErrorKind::Runtime,
            message: msg.into(),
        }
    }
}

impl std::fmt::Display for AppError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.write_str(&self.message)
    }
}

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

/// The exit code associated with an [`ErrorKind`].
pub fn exit_code_for(kind: ErrorKind) -> i32 {
    match kind {
        ErrorKind::Config => 1,
        ErrorKind::Runtime => 2,
    }
}