#version-bump #cargo-toml #semver #cargo #cargo-subcommand

app cargo-semver

Cargo subcommand to update the version in your Cargo.toml file - SemVer style

3 releases

1.0.0-alpha.3 Jan 18, 2021

#602 in Cargo plugins

41 downloads per month
Used in yapg

MIT license

17KB
297 lines

cargo-semver

crates.io codecov

cargo-semver is a cargo subcommand to help you read and update the version in your Cargo.toml file.

$ cargo semver get
1.0.0

$ cargo semver bump patch
1.0.1

Important: Running this CLI writes to Cargo.toml. Make sure to validate the version before commit.

Installation

$ cargo install cargo-semver

Usage

# get the current version
$ cargo semver get

# bump the version with an optional pre-release
$ cargo semver bump [TYPE] [PRE-RELEASE]

# set a specific version
$ cargo set [VERSION]

Update version

You can update the version in your Cargo.toml file using one of the subcommands:

$ cargo semver bump major
2.0.0

$ cargo semver bump minor
2.1.0

$ cargo semver bump patch
2.1.1

$ cargo semver bump pre alpha
2.1.1-alpha.1

If you want to bump the version and add a pre-release version:

$ cargo semver bump major alpha
2.0.0-alpha.1

Updating the pre-release version

There are multiple ways of updating the pre-release version:

$ cargo semver bump major alpha
2.0.0-alpha.1

$ cargo semver bump pre alpha
2.0.0-alpha.2

$ cargo semver bump pre
2.0.0-alpha.3

$ cargo semver bump pre beta
2.0.0-beta.1

Set a specific version

If you want to set an exact version, use the set command:

$ cargo semver set 2.1.3-beta.3
2.1.3-beta.3

License

cargo-semver is provided under the MIT License. See LICENSE for details.

Dependencies

~7MB
~114K SLoC