semver-cli ==========

semver-cli is a simple command line tool to compare and manipulate version strings.

It is basically a cli wrapper around the excellent Masterminds semver library, with lots of help from the also excellent Kingpin

usage: semver [<flags>] <command> [<args> ...]
Command-line semver tools. On error, print to stderr and exit -1.
Flags:       --help     Show context-sensitive help (also try --help-long and --help-man).   -v, --verbose  Verbose mode.
Commands:   help [<command>...]     Show help.
satisfies <VERSION> <CONSTRAINTS>     Test if a version satisfies a constraint. Exit 0 if satisfies, 1 if not. If verbose, print an explanation to stdout.
greater <A> <B>     Compare two versions. Exit 0 if the first is greater, 1 if not. If verbose, print greater to stdout.
lesser <A> <B>     Compare two versions. Exit 0 if the first is lesser, 1 if not. If verbose, print lesser to stdout.
equal <A> <B>     Compare two versions. Exit 0 if they are equal, 1 if not.
inc <COMPONENT> <VERSION>     Increment major, minor, or patch component.
get <COMPONENT> <VERSION>     Get major, minor, patch, prerelease or metadata component.
set <COMPONENT> <VERSION> <VALUE>     Set prerelease or metadata component.

Example

Deploy only when the CI tag is within constraints and is greater than what is currently released. For example, with constraints 1.* and a released version of 1.4, a version of 1.5 would be released but a version of 2.0 or 1.2 would not.

#!/bin/bash
CONSTRAINTS=$(jq .labels.constraints manifest.json) RELEASED=$(jq .image manifest.json | cut -d: -f 2)
semver satisfies "$CI_TAG" "$CONSTRAINTS" || exit 1 semver greater   "$CI_TAG" "$RELEASED"    || exit 1
deploy