const_env

注意：这是一个小的分支，它增加了一个用于检索环境变量值的表达式的宏。它应该被上传到上游，这个crate是临时的，不会更新。

• 动机
• 用法
• 支持类型
• 限制
• 替代方案

动机

你的目标：你希望在编译时根据环境变量定义代码中的各种常量。

你的问题：在今天的Rust中，这仅适用于&'static str常量。

const MY_STR: &'static str = env!("SOME_ENV");

你不能类似地初始化其他类型，例如常量u32、bool或其他原始类型。参见问题和解决方案。最终，一旦支持在const fn中运行parse和unwrap，你将能够这样做，但到目前为止，这个crate提供了一种你可以今天使用的简单解决方案。

用法

添加依赖项。

[dependencies]
const_env = "0.1"

在文件顶部导入from_env!宏。

use const_env::from_env;

使用宏在构建时根据环境变量覆盖常量的值。

#[from_env]
const FOO: u32 = 123;

// This test will PASS if invoked as `FOO=456 cargo test`
#[test]
fn test() {
    assert_eq!(456, FOO);
}

默认情况下，该宏查找与它附加的常量同名的环境变量。

// Use `FOO=true cargo build` to configure the value.
#[from_env]
const FOO: bool = false;

但您也可以显式指定一个名称。

// Use `BAR=true cargo build` to configure the value.
#[from_env("BAR")]
const FOO: bool = false;

您在源代码中分配的表达式在环境变量不存在时作为默认值。

// If env var FOO is not set then the FOO constant will have the default value of '🦀'.
#[from_env]
const FOO: char = '🦀';

支持const和static声明。

// Both of these may be set by `FOO=abc BAZ=def cargo build`.
#[from_env]
const FOO: &'static str = "hello";
#[from_env("BAZ")]
static BAR: &'static [u8] = b"world";

支持类型

字符串！

#[from_env]
const FOO: &'static str = "hello";

// example: `FOO=abc cargo build`
// results in:
const FOO: &'static str = "abc";

字节字符串！

#[from_env]
const FOO: &'static [u8] = b"hello";

// example: `FOO=world cargo build`
// results in:
const FOO: &'static [u8] = b"world";

字节！

#[from_env]
const FOO: u8 = b'⚙';

// example: `FOO=🦀 cargo build`
// results in:
const FOO: u8 = b'🦀';

字符！

#[from_env]
const FOO: char = '⚙';

// example: `FOO=🦀 cargo build`
// results in:
const FOO: car = '🦀';

各种形状和大小的整数！

#[from_env]
const FOO: u32 = 123;
#[from_env]
const BAR: i64 = 456;
#[from_env]
const BAZ: usize = 0;

// example: `FOO=321 BAR=-456 BAZ=1usize cargo build`
// results in:
const FOO: u32 = 321;
const BAR: i64 = -456;
const BAZ: usize = 1usize;

各种形状和大小的浮点数！

#[from_env]
const FOO: f32 = 123.0;
#[from_env]
const BAR: f64 = 456.0;
#[from_env]
const BAZ: f32 = 0.0;

// example: `FOO=321.0 BAR=-456.0 BAZ=1f32 cargo build`
// results in:
const FOO: f32 = 321.0;
const BAR: f64 = -456.0;
const BAZ: f32 = 1f32;

布尔值！

#[from_env]
const FOO: bool = false;

// example: `FOO=true cargo build`
// results in:
const FOO: bool = true;

已知限制

• 仅支持顶层 const 和 static 声明。

替代方案

• 编写一个 build.rs 脚本，该脚本查看环境变量并根据它们生成代码。这与这个crate的工作原理在概念上类似，不同之处在于这个crate使用过程宏而不是构建脚本。
• 等待 const fn 完成，尤其是 控制流，这样你就可以在给常量变量赋值时使用 env!("FOO").parse().unwrap()。