基本

export name=paolo
export favourite_number=42

use env_settings_derive::EnvSettings;

#[derive(EnvSettings)]
struct MyStruct {
    name: String,

    favourite_number: u8,
}

fn main() {
    let my_struct = MyStruct::from_env().unwrap();
    assert_eq!(my_struct.name, "paolo".to_string());
    assert_eq!(my_struct.favourite_number, 42);

    let name = "luca";
    let my_struct = MyStruct::new(Some(name.to_string()), None).unwrap();
    assert_eq!(my_struct.name, name);
    assert_eq!(my_struct.favourite_number, 42);
}

高级

echo "MY_STRUCT_FAVOURITE_NUMBER=42\n" > .env
export MY_BIRTH_DATE=01/01/1970

use env_settings_derive::EnvSettings;

#[derive(EnvSettings)]
#[env_settings(case_insensitive, file_path = ".env", prefix="MY_STRUCT_")]
struct MyStruct {
    #[env_settings(default = "paolo")]
    name: String,

    favourite_number: u8,

    #[env_settings(variable = "MY_BIRTH_DATE")]
    birth_date: String,

    birth_place: Option<String>,

    #[env_settings(skip)]
    friends: Vec<String>,
}

fn main() {
    let friends = vec!["luca".to_string()];
    let my_struct = MyStruct::from_env(friends.clone()).unwrap();
    assert_eq!(my_struct.name, "paolo".to_string());
    assert_eq!(my_struct.favourite_number, 42);
    assert_eq!(my_struct.birth_date, "01/01/1970");
    assert_eq!(my_struct.birth_place, None);
    assert_eq!(my_struct.friends, friends);

    let name = "luca";
    let my_struct = MyStruct::new(
        Some(name.to_string()),
        None,
        None,
        Some("london".to_string()),
        friends.clone(),
    ).unwrap();
    assert_eq!(my_struct.name, name);
    assert_eq!(my_struct.favourite_number, 42);
    assert_eq!(my_struct.birth_date, "01/01/1970");
    assert_eq!(my_struct.birth_place, Some("london".to_string()));
    assert_eq!(my_struct.friends, friends);
}

参数

结构体

当前支持的用于结构体的参数包括

• case_insensitive：是否应使环境变量匹配不区分大小写。默认情况下，匹配区分大小写。
• delay：是否将环境变量的查找从编译时间延迟到运行时间。默认情况下，在编译时执行查找
• file_path：要读取以添加一些环境变量的文件路径（例如，.env）。默认情况下，未设置
• prefix：在匹配环境变量之前添加到结构体字段名称的前缀。默认情况下，未设置

字段

当前支持的字段参数有

• default：如果未找到环境变量，则使用的默认值。默认情况下，未设置
• skip：是否跳过环境变量的解析。如果指定的类型没有实现 std::str::FromStr，则这是必要的。
• variable：用于查找的环境变量。默认情况下，为字段的名称

变量解析层次结构

1. 传递给 new 方法（如果使用 new）的参数。
2. 环境变量
3. 从文件中加载的变量（例如 .env）
4. 默认值

贡献

在开始贡献之前，请阅读

• 行为准则
• 贡献
• 治理
• 安全
• 支持

运行测试

在测试时运行

cargo test -- --test-threads=1

以防止测试相互竞争访问同一文件

许可

本项目受 MIT 或 Apache 2.0 许可证的约束。