ortho_config 0.9.0

A configuration management library for Rust, inspired by esbuild.
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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

//! Nested environment-key mapping tests for subcommand loading.

use anyhow::{Result, anyhow, ensure};
use clap::Parser;
use serde::{Deserialize, Serialize};

use super::util::with_merged_subcommand_cli;

#[derive(Debug, Deserialize, Serialize, Default, PartialEq, Parser)]
#[command(name = "test")]
struct NestedCfg {
    #[serde(default)]
    #[arg(skip)]
    nested: Nested,
}

#[derive(Debug, Deserialize, Serialize, Default, PartialEq)]
struct Nested {
    host: Option<String>,
    port: Option<u16>,
}

#[derive(Debug, Deserialize, Serialize, Default, PartialEq, Parser)]
#[command(name = "test")]
struct DeepNestedCfg {
    #[serde(default)]
    #[arg(skip)]
    deep: DeepLevel,
}

#[derive(Debug, Deserialize, Serialize, Default, PartialEq)]
struct DeepLevel {
    #[serde(default)]
    nest: DeepNest,
}

#[derive(Debug, Deserialize, Serialize, Default, PartialEq)]
struct DeepNest {
    host: Option<String>,
}

/// Environment variables with double underscores map to nested fields, and
/// defaults apply when values are absent.
#[rstest::rstest]
#[case(
    Some(("APP_CMDS_TEST_NESTED__HOST", "env")),
    Some(("APP_CMDS_TEST_NESTED__PORT", "8080")),
    Some("env"),
    Some(8080u16)
)]
#[case(None, None, None, None)]
fn env_values_support_nesting_cases(
    #[case] host_kv: Option<(&str, &str)>,
    #[case] port_kv: Option<(&str, &str)>,
    #[case] expect_host: Option<&str>,
    #[case] expect_port: Option<u16>,
) -> Result<()> {
    let cfg: NestedCfg = with_merged_subcommand_cli(
        |j| {
            if let Some((k, v)) = host_kv {
                j.set_env(k, v);
            }
            if let Some((k, v)) = port_kv {
                j.set_env(k, v);
            }
            Ok(())
        },
        &NestedCfg::default(),
    )
    .map_err(|err| anyhow!(err))?;
    ensure!(
        cfg.nested.host.as_deref() == expect_host,
        "expected host {:?}, got {:?}",
        expect_host,
        cfg.nested.host
    );
    ensure!(
        cfg.nested.port == expect_port,
        "expected port {:?}, got {:?}",
        expect_port,
        cfg.nested.port
    );
    Ok(())
}

/// Tests multi-level splitting of environment variable keys.
///
/// # Examples
///
/// ```
/// env_values_support_deeper_nesting(
///     Some(("APP_CMDS_TEST_DEEP__NEST__HOST", "deep")),
///     Some("deep"),
/// );
/// env_values_support_deeper_nesting(None, None);
/// ```
#[rstest::rstest]
#[case(Some(("APP_CMDS_TEST_DEEP__NEST__HOST", "deep")), Some("deep"))]
#[case(None, None)]
fn env_values_support_deeper_nesting(
    #[case] kv: Option<(&str, &str)>,
    #[case] expect_host: Option<&str>,
) -> Result<()> {
    let cfg: DeepNestedCfg = with_merged_subcommand_cli(
        |j| {
            if let Some((k, v)) = kv {
                j.set_env(k, v);
            }
            Ok(())
        },
        &DeepNestedCfg::default(),
    )
    .map_err(|err| anyhow!(err))?;
    ensure!(
        cfg.deep.nest.host.as_deref() == expect_host,
        "expected host {:?}, got {:?}",
        expect_host,
        cfg.deep.nest.host
    );
    Ok(())
}