ever

向程序添加了打印构建信息的特性，使用最少的样板代码。

1. 在程序 main 函数顶部调用 ever!()。

use ever::ever;

fn main() {
    ever!();

    println!("Hello, world!");
}

2. 在启动程序时设置环境变量 EVER 为 1。构建信息将被打印，程序以状态 1 退出。

$ EVER=1 ./your_program
your_program 0.1.0 (debug):

    date:     Sat Dec  5 11:17:09 2020 +0900
    commit:   49fec228607448df6fcb8950171441a1f56c2e7b-dirty
    user:     yushiomote
    host:     your_host
    builddir: /home/yushiomote/your_program
    rustc:    1.48.0 (7eac88abb 2020-11-16)

如果您想更改环境变量名称，请将其作为参数传递。

ever!("MY_VERSION");

$ MY_VERSION=1 ./your_program

输出 Cargo.lock

通过设置环境变量为 dump_lock，程序将输出构建过程中使用的 Cargo.lock 的内容。

$ EVER=dump_lock ./your_program
# This file is automatically @generated by Cargo.
# It is not intended for manual editing.
[[package]]
    name = "autocfg"
    version = "1.0.1"
    source = "registry+https://github.com/rust-lang/crates.io-index"
...

单个参数

提供获取单个参数的宏。

use ever::{build_commit_hash, build_dir, build_date};

fn main() {
    println!("build_commit_hash: {}", build_commit_hash!());
    println!("build_dir: {}", build_dir!());
    println!("build_date: {}", build_date!());
}

这些宏返回的所有类型都是 &'static str。

注意

仅在调用 ever 宏的源文件被编译时，才会检索构建信息。