envious cover image

Bors enabled Crates.io Docs.rs

envious allows you to deserialize your serde enabled structs from environment variables.

See it in action:

```rust,no_run use serde::{Deserialize, Serialize};

[derive(Serialize, Deserialize, Debug)]

enum StaircaseOrientation { Left, Right, }

[derive(Serialize, Deserialize, Debug)]

struct Config { targettemp: f32, automatedoors: bool,

staircase_orientation: StaircaseOrientation,

}

let config: Config = envious::from_env(envious::Prefix::None).expect("Could not deserialize from env"); ```

With the following environment variables:

bash EXPORT target_temp=25.0 EXPORT automate_doors=true EXPORT staircase_orientation=Left

it will parse it from the environment and give you a Rust struct you can use in your application.

Note: The environment variables are case sensitive! This is due to how serde works internally. If you want your structs to use SCREAMINGSNAKECASE, then be sure to use the #[serde(rename_all = "SCREAMING_SNAKE_CASE"] annotation on all concerned structs.

License

envious is licensed under MIT or Apache 2.0, as you wish.

Contributing

To contribute to envious you can: