scsys-config 0.3.2

common configuration routines and schemas used throughout the ecosystem
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

/*
    Appellation: mode <module>
    Contrib: FL03 <jo3mccain@icloud.com>
*/

/// [Mode] enumerates the possible runtime modes of the application.
#[derive(
    Clone,
    Copy,
    Debug,
    Default,
    Eq,
    Hash,
    Ord,
    PartialEq,
    PartialOrd,
    strum::AsRefStr,
    strum::Display,
    strum::EnumCount,
    strum::EnumIs,
    strum::EnumIter,
    strum::EnumString,
    strum::VariantArray,
    strum::VariantNames,
)]
#[cfg_attr(feature = "clap", derive(clap::ValueEnum))]
#[cfg_attr(
    feature = "serde",
    derive(serde::Deserialize, serde::Serialize),
    serde(rename_all = "lowercase")
)]
#[strum(serialize_all = "lowercase")]
pub enum Mode {
    #[default]
    #[cfg_attr(feature = "clap", clap(name = "debug"))]
    #[cfg_attr(feature = "serde", serde(alias = "dev", alias = "development"))]
    Debug,
    #[cfg_attr(feature = "clap", clap(name = "release"))]
    #[cfg_attr(feature = "serde", serde(alias = "prod", alias = "production"))]
    Release,
}

impl Mode {
    #[cfg(feature = "std")]
    pub fn from_env() -> Self {
        Self::from_env_with_varname("APP_MODE")
    }
    #[cfg(feature = "std")]
    pub fn from_env_with_varname(var: &str) -> Self {
        use core::str::FromStr;
        std::env::var(var)
            .map(|m| Self::from_str(&m).ok())
            .ok()
            .flatten()
            .unwrap_or_default()
    }

    pub fn debug() -> Self {
        Self::Debug
    }

    pub fn release() -> Self {
        Self::Release
    }
}