#string #figment #string-key #parsed #env #variables

figment_string

Forces figment config types to be parsed as strings

1 unstable release

0.1.0 Nov 8, 2023

#597 in Configuration

Apache-2.0

7KB
91 lines

figment_string

Forces data parsed by a figment::Provider to be parsed as a string. See this GitHub issue and the figment::Providers::Env documentation for some background.

Ever see this error?

% env NAME=8080 cargo run
Error: invalid type: found unsigned int `8080`, expected a string for key "NAME"
 in environment variable(s)

Well, now you can do this, and it will work even with numbers or booleans or whatever as input:

# use figment::{Figment, providers::Env};
# use serde::Deserialize;

#[derive(Deserialize)]
struct Config {
   #[serde(deserialize_with = "figment_string::deserialize_as_string")]
   name: String,
}

fn main() {
    temp_env::with_var("NAME", Some("8080"), || {
        let config: Config = Figment::new()
            .merge(figment::providers::Env::raw())
            .extract()
            .unwrap();
        println!("Hello, {}!", config.name);
    });
}

Dependencies

~110–340KB