semver

semver

A simple semantic versioning CLI tool with helpers for common semver operations.

Features

• sort - Sort semantic versions in ascending order
• filter - Filter versions matching a semantic version constraint
• latest - Find the highest version from a list

Installation

go build -o semver

Docker

A Docker image is available for running semver in a containerized environment.

Build the image

docker build -t semver:latest .

Run in Docker

# Sort versions
echo -e "3.0.0\n1.5.0\n2.1.0" | docker run --rm -i semver:latest sort

# Filter versions
echo -e "1.0.0\n1.5.0\n2.0.0" | docker run --rm -i semver:latest filter "^1.0.0"

# Find latest version
echo -e "1.0.0\n3.5.2\n2.1.0" | docker run --rm -i semver:latest latest

The Docker image is Alpine-based (16.4MB) and includes bash and jq for scripting purposes.

Pre-built images

Pre-built images are automatically released to GitHub Container Registry (ghcr.io) for every tag.

docker pull ghcr.io/trevex/semver:v0.1.0
docker pull ghcr.io/trevex/semver:latest

Usage

sort

Sort semantic versions from stdin:

echo -e "3.0.0\n1.5.0\n2.1.0" | ./semver sort

Output:

1.5.0
2.1.0
3.0.0

filter

Filter versions matching a constraint. Supports standard semver constraint syntax:

• Exact version: 1.0.0
• Caret: ^1.0.0 (allows patch and minor updates)
• Tilde: ~1.2.0 (allows patch updates only)
• Range: >=1.0.0, <2.0.0

echo -e "0.9.0\n1.0.0\n1.1.0\n1.5.0\n2.0.0" | ./semver filter "^1.0.0"

Output:

1.0.0
1.1.0
1.5.0

Ignoring invalid versions

By default, filter fails if any input line is not a valid semver. Use the --ignore-invalid (or -i) flag to skip invalid lines:

echo -e "1.0.0\ninvalid\n1.5.0\nbad-version\n2.0.0" | ./semver filter "^1.0.0" --ignore-invalid

Output:

1.0.0
1.5.0

latest

Find the highest version from stdin:

echo -e "1.0.0\n3.5.2\n2.1.0\n10.0.0" | ./semver latest

Output:

10.0.0

Piping Commands

Commands can be piped together for powerful version operations:

# Find the latest version matching a constraint
echo -e "1.0.0\n1.1.0\n1.5.0\n2.0.0" | ./semver filter "^1.0.0" | ./semver latest

Output:

1.5.0

Testing

Run the test suite:

go test -v

Dependencies

• github.com/Masterminds/semver/v3 - Semantic versioning library
• github.com/urfave/cli/v3 - CLI framework
• github.com/stretchr/testify - Testing utilities

License

See LICENSE file for details.