semver

Semantic Versioning utility.

Description

The semver utility is a text filter for Semantic Version strings. It searches text from the standard input, selects any Semantic Versions that are present, and writes them to the standard output. It can optionally sort or tabulate the selected versions.

A version string will be selected within the text stream if the following criteria are met:

• version is a valid Semantic Version.
• version is a whole line. (This can be modified with the -w option.)

Install

Homebrew

brew tap chriskilding/semver
brew install semver

From source

Dependencies:

• Perl 5+ (pre-installed on: macOS, Debian, openSUSE)
• Bats (test)

make
make test # optional
make install

Usage

semver [-hqstw]

Options:

• -h --help Show the help screen.
• -q --quiet Quiet - suppress normal output.
• -s --sort Sort the matched versions in precedence order (low-to-high).
• -t --tabulate Tabulate the matched versions (separator: '\t').
• -w --word-match Select words that match the semver pattern. (Equivalent to the grep(1) --word-regexp option.)

Most options can be combined. For example, semver -stw will word-match occurrences of semvers, sort them, and print them in tabulated form.

Manual

man semver

Examples

Select lines that are version strings:

semver < example.txt

Calculate the next Git tag:

# ++major
git tag | semver -st | tail -n 1 | awk -F '\t' '{ print ++$1 "." 0 "." 0 }'

# ++minor
git tag | semver -st | tail -n 1 | awk -F '\t' '{ print $1 "." ++$2 "." 0 }'

# ++patch
git tag | semver -st | tail -n 1 | awk -F '\t' '{ print $1 "." $2 "." ++$3 }'

Cut out the major, minor, and patch components of a version:

semver -t <<< '1.2.3-alpha+1' | cut -f 1-3

Download all artifacts in a version range:

v='0.0.1'
while curl -fs "https://example.com/artifact/$v.tar.gz" > "$v.tar.gz"; do
    v=$(semver -t <<< "$v" | awk -F '\t' '{ print $1 "." $2 "." ++$3 }')
done

Find the current Git tag:

git tag | semver -s | tail -n 1

Format versions as CSV:

semver -tw < example.txt | tr '\t' ','

Validate a candidate version string:

semver -q <<< '1.2.3' && echo 'ok'

Functions

These Bash helper functions can make complex versioning operations easier.

#!/usr/bin/env bash

function ++major {
    semver -t <<< "$1" | awk -F '\t' '{ print ++$1 "." 0 "." 0 }'
}

function ++minor {
    semver -t <<< "$1" | awk -F '\t' '{ print $1 "." ++$2 "." 0 }'
}

function ++patch {
    semver -t <<< "$1" | awk -F '\t' '{ print $1 "." $2 "." ++$3 }'
}

Examples:

++major '1.2.3'   #=> 2.0.0
++minor '1.2.3'   #=> 1.3.0
++patch '1.2.3'   #=> 1.2.4