haf / semver

gem: "semver2" fork. simple command line util & ruby module for managing versions according to http://semver.org

SemVer2 3.4.x gem, following semver.org 2.0.0

Sponsored by qvitoo – A.I. bookkeeping.

quickstart on the command line

install it

gem install semver2

use it

# Find the .semver file and print a formatted string from this.
semver                    # => v2.3.4

# Initialize the .semver file.
semver init

# Print the tag for the current .semver file.
semver tag                # => v0.0.0

semver inc minor          # => v0.1.0
semver pre 'alpha.45'     # => v0.1.0-alpha.45
semver meta 'md5.abc123'  # => v0.1.0-alpha.45+md5.abc123
semver format "%M.%m"     # => 0.1
git tag -a `semver tag`
say 'that was easy'

quickstart for ruby

require 'semver'
v = SemVer.find
v.major                     # => "0"
v.major += 1
v.major                     # => "1"
v.prerelease = 'alpha.46'
v.metadata = 'md5.abc123'
v.format "%M.%m.%p%s%d"     # => "1.1.0-alpha.46+md5.abc123"
v.to_s                      # => "v1.1.0-alpha.46+md5.abc123"
v.save

parsing in ruby

 require 'semver'
 v = SemVer.parse 'v1.2.3-rc.56'
 v = SemVer.parse_rubygems '2.0.3.rc.2'

git integration

git config --global alias.semtag '!git tag -a $(semver tag) -m "tagging $(semver tag)"'

existing 'SemVer' class from other gem?

You can now do this:

require 'xsemver'
v = XSemVer::SemVer.find
# ...
v.save

creds

• Franco Lazzarino
• Henrik Feldt
• James Childress