13 releases

0.2.2 Apr 6, 2025
0.2.1 Nov 1, 2024
0.1.9 Feb 7, 2024
0.1.8 Dec 26, 2023
0.1.3 Sep 11, 2022

#984 in Configuration

Download history 1048/week @ 2025-03-08 1871/week @ 2025-03-15 1431/week @ 2025-03-22 1115/week @ 2025-03-29 1161/week @ 2025-04-05 1903/week @ 2025-04-12 1476/week @ 2025-04-19 1321/week @ 2025-04-26 1444/week @ 2025-05-03 1064/week @ 2025-05-10 1441/week @ 2025-05-17 2126/week @ 2025-05-24 1896/week @ 2025-05-31 2399/week @ 2025-06-07 2443/week @ 2025-06-14 1783/week @ 2025-06-21

9,085 downloads per month
Used in mailinator-rs

MIT license

18KB
291 lines

Dot Env Config

use .env as config file and parse environments to config struct.

Usage

derive EnvConfig

use dotenv_config::EnvConfig;
use dotenvy::dotenv;

#[derive(Debug, PartialEq)]
enum Color {
    Red,
    Green,
    Blue,
}

impl std::str::FromStr for Color {
    type Err = &'static str;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        match s {
            "red" => Ok(Color::Red),
            "green" => Ok(Color::Green),
            "blue" => Ok(Color::Blue),
            _ => Err("no match color"),
        }
    }
}

#[derive(Debug, EnvConfig)]
struct Config {
    #[env_config(default = "192.168.2.1")]
    server_addr: String,
    server_mode: bool,
    #[env_config(name = "ZINC_ENABLE", default = true)]
    enable: bool,
    #[env_config(name = "ZINC_NUMBER", default = 123456, help = "this is for demo")]
    num: Option<i64>,
    #[env_config(parse, default = "green")] // or parse=true
    color: Color,
}

fn main() {
    dotenv().ok();
    let cfg = Config::init().unwrap();
    println!("{:#?}", cfg);

    // print config help
    let help = Config::get_help();
    println!("{:#?}", help);
}

attribute env_config

you can use macro attribute set field attribute

  • name: change default environment key
  • default: if not set, used as default value

you can though system environments or .env file config it.

ZINC_ENABLE=false
ZINC_NUMBER=8787878

default load environment key is: structName_fieldName do UpperSnake, like above struct, default config key is:

CONFIG_SERVER_ADDR
CONFIG_SERVER_MODE
ZINC_ENABLE
ZINC_NUMBER

Dependencies

~2–2.7MB
~60K SLoC