Macro git_version::git_version
source · git_version!() { /* proc-macro */ }
Expand description
Get the git version for the source code.
The following (named) arguments can be given:
-
args
: The arguments to callgit describe
with. Default:args = ["--always", "--dirty=-modified"]
-
prefix
,suffix
: The git version will be prefixed/suffexed by these strings. -
cargo_prefix
,cargo_suffix
: If either is given, Cargo’s version (given by the CARGO_PKG_VERSION environment variable) will be used if git fails instead of giving an error. It will be prefixed/suffixed by the given strings. -
fallback
: If all else fails, this string will be given instead of reporting an error.
Examples
const VERSION: &str = git_version!();
const VERSION: &str = git_version!(args = ["--abbrev=40", "--always"]);
const VERSION: &str = git_version!(prefix = "git:", cargo_prefix = "cargo:", fallback = "unknown");