Module plugx_config::parser::env

source ·
Expand description

Environment-Variable configuration parser.

This is only usable if you enabled env Cargo feature.

Example

use plugx_config::parser::{ConfigurationParser, env::ConfigurationParserEnv};
use plugx_input::Input;

let bytes = br#"
FOO__BAR__BAZ=Qux
FOO__BAR__ABC=3.14 # Comments are supported!
FOO__XYZ=false
HELLO='["w", "o", "l", "d"]' # A JSON list
"#;

let parser = ConfigurationParserEnv::new();
// You can set nested key separator like this:
// parser.set_key_separator("__");
let parsed: Input = parser.try_parse(bytes.as_slice()).unwrap();
assert!(
    parsed.map_ref().unwrap().len() == 2 &&
    parsed.map_ref().unwrap().contains_key("foo") &&
    parsed.map_ref().unwrap().contains_key("hello")
);
let foo = parsed.map_ref().unwrap().get("foo").unwrap();
assert!(
    foo.map_ref().unwrap().len() == 2 &&
    foo.map_ref().unwrap().contains_key("bar") &&
    foo.map_ref().unwrap().contains_key("xyz")
);
let bar = foo.map_ref().unwrap().get("bar").unwrap();
assert_eq!(bar.map_ref().unwrap().get("baz").unwrap(), &"Qux".into());
assert_eq!(bar.map_ref().unwrap().get("abc").unwrap(), &3.14.into());
let xyz = foo.map_ref().unwrap().get("xyz").unwrap();
assert_eq!(xyz, &false.into());
let list = ["w", "o", "l", "d"].into();
assert_eq!(parsed.map_ref().unwrap().get("hello").unwrap(), &list);

Structs

Constants