cgn-core 0.1.0

Cognitora shared library: config, errors, hashing, prefix-trie
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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

//! Workspace-wide error type.

use thiserror::Error;

#[derive(Debug, Error)]
pub enum Error {
    #[error("io: {0}")]
    Io(#[from] std::io::Error),

    #[error("config: {0}")]
    Config(String),

    #[error("toml: {0}")]
    Toml(#[from] toml::de::Error),

    #[error("json: {0}")]
    Json(#[from] serde_json::Error),

    #[error("tls: {0}")]
    Tls(String),

    #[error("transport: {0}")]
    Transport(#[from] tonic::transport::Error),

    #[error("rpc: {0}")]
    Status(#[from] tonic::Status),

    #[error("etcd: {0}")]
    Etcd(String),

    #[error("invalid argument: {0}")]
    InvalidArgument(String),

    #[error("not found: {0}")]
    NotFound(String),

    #[error("unavailable: {0}")]
    Unavailable(String),

    #[error("internal: {0}")]
    Internal(String),

    #[error(transparent)]
    Other(#[from] anyhow::Error),
}

pub type Result<T, E = Error> = std::result::Result<T, E>;

/// Map an `Error` to the standard process exit code documented in
/// `docs/reference/exit-codes.md`. All Cognitora binaries call this
/// from their `main()` so the matrix is enforced uniformly.
pub fn exit_code(err: &Error) -> i32 {
    match err {
        Error::Config(_) => 3,
        Error::Toml(_) => 3,
        Error::InvalidArgument(_) => 2,
        Error::Tls(_) => 5,
        Error::Etcd(_) => 4,
        Error::Unavailable(_) => 4,
        Error::NotFound(_) => 4,
        Error::Io(e) if e.kind() == std::io::ErrorKind::AddrInUse => 7,
        Error::Io(_) => 8,
        Error::Transport(_) => 4,
        Error::Status(_) => 4,
        Error::Json(_) => 3,
        Error::Internal(_) | Error::Other(_) => 1,
    }
}

impl From<Error> for tonic::Status {
    fn from(e: Error) -> Self {
        use tonic::Code;
        let code = match &e {
            Error::InvalidArgument(_) => Code::InvalidArgument,
            Error::NotFound(_) => Code::NotFound,
            Error::Unavailable(_) => Code::Unavailable,
            Error::Status(s) => return s.clone(),
            _ => Code::Internal,
        };
        tonic::Status::new(code, e.to_string())
    }
}