vergen

Generate build, git, rustc, cargo, and sysinfo related cargo:rustc-env instructions via build.rs for use in your code via the env! macro or option_env! macro.

Sponsors

Special thanks to the sponsors of this project * tyretool

Release 6.0 Breaking Changes

• The Copy implementation was dropped from the Config struct to allow the base git directory to be specified. This is a breaking API change necessitating a new major release.

  Current Release

Example Usage

See the documentation at docs.rs for example usage

Environment Variables

A full list of environment variables that can be generated are listed in the following table.

| Variable | Sample | | ------- | ------ | | VERGEN_BUILD_DATE | 2021-02-25 | | VERGEN_BUILD_TIME | 23:28:39.493201 | | VERGEN_BUILD_TIMESTAMP | 2021-02-25T23:28:39.493201+00:00 | | VERGEN_BUILD_SEMVER | 5.0.0 | | VERGEN_GIT_BRANCH | feature/fun | | VERGEN_GIT_COMMIT_DATE | 2021-02-24 | | VERGEN_GIT_COMMIT_TIME | 20:55:21 | | VERGEN_GIT_COMMIT_TIMESTAMP | 2021-02-24T20:55:21+00:00 | | VERGEN_GIT_SEMVER | 5.0.0-2-gf49246c | | VERGEN_GIT_SHA | f49246ce334567bff9f950bfd0f3078184a2738a | | VERGEN_RUSTC_CHANNEL | nightly | | VERGEN_RUSTC_COMMIT_DATE | 2021-02-24 | | VERGEN_RUSTC_COMMIT_HASH | a8486b64b0c87dabd045453b6c81500015d122d6 | | VERGEN_RUSTC_HOST_TRIPLE | x8664-apple-darwin | | VERGEN_RUSTC_LLVM_VERSION | 11.0 | | VERGEN_RUSTC_SEMVER | 1.52.0-nightly | | VERGEN_CARGO_FEATURES | git,build | | VERGEN_CARGO_PROFILE | debug | | VERGEN_CARGO_TARGET_TRIPLE | x8664-unknown-linux-gnu | | VERGEN_SYSINFO_NAME | Manjaro Linux | | VERGEN_SYSINFO_OS_VERSION | Linux Manjaro Linux | | VERGEN_SYSINFO_USER | Yoda | | VERGEN_SYSINFO_TOTAL_MEMORY | 33 GB | | VERGEN_SYSINFO_CPU_VENDOR | Authentic AMD | | VERGEN_SYSINFO_CPU_CORE_COUNT | 8 | | VERGEN_SYSINFO_CPU_NAME | cpu0,cpu1,cpu2,cpu3,cpu4,cpu5,cpu6,cpu7 | | VERGEN_SYSINFO_CPU_BRAND | AMD Ryzen Threadripper 1900X 8-Core Processor | | VERGEN_SYSINFO_CPU_FREQUENCY | 3792 |

Contributing

See the documentation at CONTRIBUTING.md

License

Licensed under either of * Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0) * MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT) at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.