Rust程序如何从其Cargo包中访问元数据？

Question

如何从包中的Rust代码访问Cargo包的元数据（例如版本）？在我的情况下，我正在构建一个命令行工具，我希望有一个标准的--version标志，我希望实现从Cargo.toml读取包的版本，所以我不必将它维持在两个地方。我可以想象还有其他人可能想要从程序中访问Cargo元数据。

Answer 1

Cargo通过环境变量将一些元数据传递给编译器，其中的列表可以在Cargo documentation pages中找到。

编译器环境由货物代码中的fill_env填充。自早期版本以来，此代码变得更加复杂，并且整个变量列表不再明显，因为它可以是动态的。但是，至少在那里设置了以下变量（从文档列表中）：

CARGO_MANIFEST_DIR
CARGO_PKG_AUTHORS
CARGO_PKG_DESCRIPTION
CARGO_PKG_HOMEPAGE
CARGO_PKG_NAME
CARGO_PKG_REPOSITORY
CARGO_PKG_VERSION
CARGO_PKG_VERSION_MAJOR
CARGO_PKG_VERSION_MINOR
CARGO_PKG_VERSION_PATCH
CARGO_PKG_VERSION_PRE

您可以使用env!()宏访问环境变量。要插入程序的版本号，您可以执行以下操作：

const VERSION: &'static str = env!("CARGO_PKG_VERSION");

// ...

println!("MyProgram v{}", VERSION);

如果你想要你的程序甚至没有Cargo编译，你可以使用option_env!()：

const VERSION: Option<&'static str> = option_env!("CARGO_PKG_VERSION");

// ...

println!("MyProgram v{}", VERSION.unwrap_or("unknown"));

Answer 2

built-crate有助于在没有所有样板的情况下序列化许多Cargo的环境。