A utility to calculate the level of change and the next semantic version number based on the conventional commits since the last version tag.
- Calculate next semantic version number
- Calculate the level to change for next semantic version number
- Support basic semantic version components: Major, Minor, and Patch
- Check for required files (e.g. CHANGELOG.md)
- Set level of change (Breaking, Feature, Fix, Other) at which required files are required
- Check that any changes made meet a specified level
- Support pre-release versions (alpha, beta, rc)
- Update to release version (removing pre-release identifiers)
- Handle case where no tag is found
Install the CLI using cargo install.
cargo install nextsv
Run in your project directory and check the version
$ nextsv --version
nextsv 0.8.16
Running the application provides the level for the next semantic version change.
$ nextsv
[2022-08-03T06:33:54Z INFO nextsv] Calculating the next version level
minor
Help provides all the options
$ nextsv -h
jerusdp <jrussell@jerus.ie>
Next semantic version calculator
USAGE:
nextsv [OPTIONS]
OPTIONS:
-f, --force <FORCE> Force the calculation of the version number [possible values: major,
minor, patch, first]
-h, --help Print help information
--level Report the level of the version number change
--number Report the version number
-p, --prefix <PREFIX> Prefix string to identify version number tags [default: v]
-q, --quiet Pass many times for less log output
-v, --verbose Pass many times for more log output
-V, --version Print version information
$
A clean response of the level to update is reported using the -q flag.
$ nextsv -q
minor
This can be used with cargo release
to update and publish a new release.
cargo release $(nextsv -q)
Further details on usage scenarios can be found here.
To use the library add the crate to dependencies in the project's Cargo.toml.
[dependencies]
nextsv = "0.8.16"