rustc_tools_util/README.md

   1 # rustc_tools_util
   2
   3 A small tool to help you generate version information
   4 for packages installed from a git repo
   5
   6 ## Usage
   7
   8 Add a `build.rs` file to your repo and list it in `Cargo.toml`
   9 ````
  10 build = "build.rs"
  11 ````
  12
  13 List rustc_tools_util as regular AND build dependency.
  14 ````
  15 [dependencies]
  16 rustc_tools_util = "0.1"
  17
  18 [build-dependencies]
  19 rustc_tools_util = "0.1"
  20 ````
  21
  22 In `build.rs`, generate the data in your `main()`
  23 ````rust
  24 fn main() {
  25     println!(
  26         "cargo:rustc-env=GIT_HASH={}",
  27         rustc_tools_util::get_commit_hash().unwrap_or_default()
  28     );
  29     println!(
  30         "cargo:rustc-env=COMMIT_DATE={}",
  31         rustc_tools_util::get_commit_date().unwrap_or_default()
  32     );
  33 }
  34
  35 ````
  36
  37 Use the version information in your main.rs
  38 ````rust
  39 use rustc_tools_util::*;
  40
  41 fn show_version() {
  42     let version_info = rustc_tools_util::get_version_info!();
  43     println!("{}", version_info);
  44 }
  45 ````
  46 This gives the following output in clippy:
  47 `clippy 0.0.212 (a416c5e 2018-12-14)`
  48
  49
  50 ## License
  51
  52 Copyright 2014-2018 The Rust Project Developers
  53
  54 Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
  55 http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
  56 <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
  57 option. All files in the project carrying such notice may not be
  58 copied, modified, or distributed except according to those terms.