Crates.io | git-testament |
lib.rs | git-testament |
version | 0.2.5 |
source | src |
created_at | 2019-04-02 21:07:56.568672 |
updated_at | 2023-09-20 07:47:38.165954 |
description | Record git working tree status when compiling your crate |
homepage | |
repository | https://github.com/kinnison/git-testament/ |
max_upload_size | |
id | 125442 |
size | 33,537 |
git-testament
is a library to embed a testament as to the state of a git
working tree during the build of a Rust program. It uses the power of procedural
macros to embed commit, tag, and working-tree-state information into your program
when it is built. This can then be used to report version information.
use git_testament::{git_testament, render_testament};
git_testament!(TESTAMENT);
fn main() {
println!("My version information: {}", render_testament!(TESTAMENT));
}
In the case that your build is not being done from a Git repository, you still
want your testament to be useful to your users. Reproducibility of the binary
is critical in that case. The Reproducible Builds team have defined
a mechanism for this known as SOURCE_DATE_EPOCH
which is an environment
variable which can be set to ensure the build date is fixed for reproducibilty
reasons. If you have no repo (or a repo but no commit) then git_testament!()
will use the SOURCE_DATE_EPOCH
environment variable (if present and parseable
as a number of seconds since the UNIX epoch) to override now
.
no_std
scenariosThis crate does not link to anything in the standard library, but it does rely by default
on the alloc
library being available. Disabling the alloc
feature allows the crate to work
in no_std
environments where the alloc
library is not available.
You can still generate a GitTestament
struct though it'll be less easy to work with.
Instead it'd be recommended to use the git_testament_macros!()
macro instead
which provides a set of macros which produce string constants to use.
This is less flexible/capable but can sometimes be easier to work with in these kinds of situations.