#version-bump #semver #cargo-version #cargo-command #versioning #help #npm-version

app cargo-semver-tool

A cargo command to help you version your rust project similar to npm-version

4 releases

0.1.5 Feb 13, 2024
0.1.3 Jun 30, 2023
0.1.2 Jun 30, 2023
0.1.1 Jun 30, 2023

#198 in Cargo plugins

Apache-2.0

17KB
265 lines

cargo-semver-tool

build-status

Update the version of your rust project!

Getting Started

$ cargo install cargo-semver-tool

Usage

$ cargo semver --help
A cargo command to help you version your rust project similar to npm-version

Usage: cargo-semver <COMMAND>

Commands:
  get   Return the project's current version
  bump  Bump the project's version
  help  Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version

Available Subcommands

cargo semver get

Usage
$ cargo semver get --help
Return the project's current version

Usage: cargo-semver get

Options:
  -h, --help  Print help

cargo semver bump --help

Usage
Bump the project's version

Usage: cargo-semver bump [OPTIONS] [BUMP]

Arguments:
  [BUMP]
          [default: patch]

          Possible values:
          - major:      Bump the major digit of the version
              1.0.0   -> 2.0.0
              1.1.0   -> 2.0.0
              2.0.0-1 -> 2.0.0
          - minor:      Bump the minor digit of the version
              1.0.0   -> 1.1.0
              1.0.1   -> 1.1.0
              1.1.0-1 -> 1.1.0
          - patch:      Bump the patch digit of the version
              1.0.0   -> 1.0.1
              1.0.0-1 -> 1.0.0
          - premajor:   Bump the major digit of the version as a prerelease
              1.0.0   -> 2.0.0-0
              2.0.0-0 -> 2.0.0-1
          - preminor:   Bump the minor digit of the version as a prerelease
              1.0.0   -> 1.1.0-0
              1.1.0-0 -> 1.1.0-1
          - prepatch:   Bump the patch digit of the version as a prerelease
              1.0.0   -> 1.0.1-0
              1.0.1-0 -> 1.0.1-1
          - prerelease: Bump the prelease version, or behaves like prepatch
              1.1.0   -> 1.1.1-0
              1.1.1-0 -> 1.1.1-1
              1.1.0-5 -> 1.1.0-6
          - release:    Bump the version from a prerelease, or behaves like patch
              1.1.0   -> 1.1.1
              1.1.1-5 -> 1.1.1

Options:
  -d, --dry-run
          Display only, do not write the file

  -h, --help
          Print help (see a summary with '-h')

License: Apache-2.0

Dependencies

~4MB
~71K SLoC