voidconf 0.0.1

Config management for dummies like me.
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

use derive_more::{Display, Error};
use miette::Diagnostic;

/// Config errors from [`voidconf`].
#[derive(Clone, Display, Debug, Error, Diagnostic, PartialEq, Eq)]
pub enum ConfError {
    /// Expected key is not defined.
    #[error]
    #[display("expected key not found: {key}")]
    #[diagnostic()]
    KeyNotFound { key: String },

    /// Required value is not defined for a defined key.
    #[error]
    #[display("expected val not found with key: {key}")]
    #[diagnostic()]
    ValNotFound { key: String },

    //TODO extract data from parse error
    /// Type-safe value parsing failed.
    #[error]
    #[display("failed to parse val as given type: {key} = {val}")]
    #[diagnostic()]
    ValParseFailed { key: String, val: String },

    /// Environment variable lookup failed.
    #[error]
    #[display("failed to lookup env var: {key}")]
    #[diagnostic()]
    EnvLookupFailed {
        key: String,
        #[error(source)]
        source: std::env::VarError,
    },
}

impl ConfError {
    pub fn key_not_found(key: impl Into<String>) -> Self {
        Self::KeyNotFound { key: key.into() }
    }

    pub fn val_not_found(key: impl Into<String>) -> Self {
        Self::ValNotFound { key: key.into() }
    }

    pub fn val_parse_failed(key: impl Into<String>, val: impl Into<String>) -> Self {
        Self::ValParseFailed {
            key: key.into(),
            val: val.into(),
        }
    }

    pub fn env_lookup_failed(key: impl Into<String>, source: std::env::VarError) -> Self {
        Self::EnvLookupFailed {
            key: key.into(),
            source,
        }
    }
}