semver-cli ·

A Rust CLI application for working with the semver specification

Motivation

node-semver can be noticeably slow if you're doing many parses. How much faster could it be if we just used some existing glue from rust's ecosystem?

I wrote a script that would parse my git history (to generate a CHANGELOG.md from commits + tags), eg:

bash changelog.sh 124cef4 57175e39d4e2c49a618668ac155f85b3585835b7 > CHANGELOG.md

time command execution on the above script (implemented with node-semver):

real    1m7.698s
user    0m45.112s
sys     0m14.046s

time command execution on the same script (using a debug version of this implementation):

real    0m13.831s
user    0m3.530s
sys     0m4.337s

time command execution on a --release build:

real    0m10.202s
user    0m2.527s
sys     0m3.627s

Fast!

Installation

cargo install semver-cli

Disclaimer

This still very much a work in progress, see: Todo

Usage

validate:

semver-cli 2.3.2
2.3.2

invalidate:

semver-cli 100
-> no output

increment:

semver-cli 2.3.1 --increment
2.3.2
semver-cli 2.3.1 --increment=minor
2.4.0
semver-cli 2.3.1 --increment=major
3.0.0

Todo

• increment
• range
• preid
• loose
• include-prerelease
• coerce

(feature parity with https://github.com/npm/node-semver)

License

MIT licensed