vergen's Introduction

vergen

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

Current Release

Example Usage

See the documentation at docs.rs for example usage

Release 5 Breaking Changes

The main entry point for use has changed from gen to vergen
The old ConstantsFlags has been removed in lieu of Config.

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`	x86_64-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`	x86_64-unknown-linux-gnu

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.

Recommend Projects