19 releases

0.3.1 Nov 2, 2021
0.3.0 Oct 2, 2021
0.2.2-alpha.13 Oct 2, 2021
0.2.2-alpha.6 Sep 12, 2021
0.1.2-alpha.15 Sep 12, 2021

#418 in Build Utils

MIT license

28KB
551 lines

CI Status crates.io

minver_rs

Implementation of https://github.com/adamralph/minver using Rust

How to use

CLI

The CLI binary allows minver to be run as a regular command.

  1. Install minver_rs using cargo
> cargo install minver_rs
  1. Run minver (Note: Make sure that .cargo\bin is on your PATH)
> minver
1.2.3

Build Util

The build util binary is a tool that can be integrated into your build to automatically update Cargo.toml with the correct version.

  1. Install minver_rs using cargo
> cargo install minver_rs
  1. Set the environment variable MINVER_UPDATE_VERSION
> export MINVER_UPDATE_VERSION=1
  1. Run minver_build_util (Note: Make sure that .cargo\bin is on your PATH)
> minver_build_util

As a build dependency

minver_rs can also be used directly in build.rs.

  1. Add a build dependency on minver_rs
[build-dependencies]
minver_rs = "x.y.z"
  1. (Optional) Update version in Cargo.toml to be 0.0.0. While this is not strictly necessary, it helps to make it apparent that the version is handled automatically by minver.
  2. Add a file called build.rs to your project root.
use minver_rs::build_utils;

fn main() {
    println!("cargo:rerun-if-changed=build.rs");
    build_utils::default_build_action();
}
  1. Set the environment variable MINVER_UPDATE_VERSION
> export MINVER_UPDATE_VERSION=1
  1. Build your crate
> cargo build

Dependencies

~21MB
~445K SLoC