Skip to content

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

License

Notifications You must be signed in to change notification settings

filipstefansson/cargo-semver

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 --vers 1.0.0-alpha.3

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.

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages