Struct dinglebit_config::env::Environment

pub struct Environment { /* fields omitted */ }

Implementations

impl Environment

pub fn new(prefix: &str) -> Self

Create a new environment configuration which will prefix keys with the given prefix and an underscore (e.g. prefix = “foo” => “foo_*”). An empty prefix will not prepend anything.

Getting a value from the environment will try to make the key more environment-variable-like . ‘.’ and ‘/’ are replaced with ‘_’ and everything is upper-cased. If the prefix is ‘foo’, then a get for ‘my.app.secret’ would look for ‘FOO_MY_APP_SECRET’.

Trait Implementations

impl Config for Environment

fn get(&self, key: &str) -> Option<String>

Get a value from the environment using the given key. ‘.’ and ‘/’ are replaced with ‘_’ and everything is upper-cased. If the prefix is ‘foo’, then a get for ‘my.app.secret’ would look for ‘FOO_MY_APP_SECRET’.

fn must_get(&self, key: &str) -> String

Similar to get but panics if there is no value.

fn string(&self, key: &str) -> String

Get the value as a string or panics if one isn’t found.

fn int(&self, key: &str) -> i64

Get the value as an integer or panics if one isn’t found or cannot be parsed.

fn float(&self, key: &str) -> f64

Get the value as a float or panics if one isn’t found or cannot be parsed.

fn bool(&self, key: &str) -> bool

Get the value as a bool or panics if one isn’t found or cannot be parsed. The following case-insensitive values are considered true: t, true, 1, y, yes. All other values are considered false.

fn duration(&self, key: &str) -> Duration

Get the value as a duration or panics if one isn’t found or can’t be parsed. Thre doesn’t appear to be a parsing function for a duration, so it attempts to convert to an integer and use that as the number of seconds.

fn datetime(&self, key: &str) -> DateTime<Utc>

Get the value as a duration or panics if one isn’t found or it can’t be parsed. It uses RFC339 to parse it.

fn list(&self, key: &str) -> Vec<String>

Get a list or panics if one isn’t found. The list should be a comma-delimited list surrouned by brackets (e.g. [1, 2, 3] => vec![“1”, “2”, “3”].

fn map(&self, key: &str) -> HashMap<String, String>

Get a map or panics if one isn’t found. The list should be a comma-delimited list surrouned by braces with key/value pairs associated with => (e.g. {a=>1, b=>2, c=>3} => ((a,1), (b,2), (c,3))).

impl Debug for Environment

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq<Environment> for Environment

fn eq(&self, other: &Environment) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Environment) -> bool

This method tests for !=.

impl StructuralPartialEq for Environment