vmlib 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2ee5054308d7ff971afe60377aff456feb410ccc
-  data.tar.gz: 6abf38e737a186e617337a812ce0b7795fa13af5
+  metadata.gz: f1234c2c56688c3796a8099567295462c049abea
+  data.tar.gz: e3fe4d2e0dfff686ecd8d461afff583b2dab1641
 SHA512:
-  metadata.gz: f323ee88c8b9679e2503338a936e244fca2db1602e001decf1503a2442b1bda784e40cacc22d225ef6e0595bcd991c7edac0a7c65ea4b6a5598b30768b2193a9
-  data.tar.gz: 093c81e62e7b55d9e98085957d166eca86dc90654be7cfb8478caefd6634dc86a9648a5fd5723b5e2e731136e9d34a928906ec3c4d4380ac6ba344123e951d94
+  metadata.gz: 92e567aed02872b0000f97049a4dae7f10b94d8556eab8ee9ebd47c88661a42199351da72677b936c172e25c8cf747efd1f3cc4712c2f86cd5998066e674037a
+  data.tar.gz: 7296242755d93a2cd46f69fa092a8883d548e86258384b7fea0d21b3cdc2162e5f38868ecda3d178ae57260eec2d2b1f4228b6baeb15bd045fabecca7b080bf9

data/.ruby-version

@@ -0,0 +1 @@
+1.9.3

data/README.md

@@ -3,7 +3,7 @@ Version Manager Library
 
 The Version manager library (VMLib) is a generic library to handle
 semantic versioning as specified at <http://semver.org>. In addition to
-complying with semantic versioning v2.0.0-rc.1, it adds additional API
+complying with semantic versioning v2.0.0, it adds additional API
 calls to bump the major, minor and patch versions as well as handle
 distinct types of releases (development, alpha, beta, release candidate,
 final as well as a custom type)

data/Version

@@ -1 +1 @@
-vmlib 1.0.1
+vmlib 1.1.0

data/bin/vmlib

@@ -90,16 +90,24 @@ module VMLib
 
     #########################################################################
     # Updates all the source files with the bumped version
-    # Also writes the changes to the git repository
+    # Accepts an optional format string. If not specified, uses %M.%m.%p%r%b
     #########################################################################
     when 'update' # update
-      sfile = Source.new
+      # Allow the user to specify the format
+      foption = ARGV.shift || '"%M.%m.%p%r%b"'
+
+      sfile = Source.new(foption)
       sfile.update
+      
+    #########################################################################
+    # Writes all local changes to the git repository. SHOULD be preceded
+    # immediately by an update command.
+    #########################################################################
+    when 'commit' # commit
       version = File.new.read.tag
 
       puts "Committing changed files in #{version}"
       system("git commit -am 'Bumped version to #{version}'")
-      
 
     #########################################################################
     # Display the version as a format
@@ -136,8 +144,8 @@ module VMLib
       #if fstr.nil?
         puts <<EOM
 #{$0} is a utility to help manage project versions in accordance with
-the Semantic Versioning specifications v2.0.0-rc.1. The specifications
-can be found at http://semver.org
+the Semantic Versioning specifications v2.0.0. The specifications can
+be found at http://semver.org
 
 Usage: #{$0} <command> [arguments]
 
@@ -165,7 +173,9 @@ Supported commands are:
 
     update                Updates source files with the (new) version
                           information and also writes the changes to
-                          the git repository.
+                          the git repository. You may optionally specify
+                          a format string, failing which it will use the
+                          default format string of "%M.%m.%p%r%b"
 
     format                Formats the version information as a string.
                           You can specify an optional format string

data/lib/vmlib/base.rb

@@ -208,6 +208,7 @@ module VMLib
       true
     end
 
+
   end
 
 

data/lib/vmlib/bump.rb

@@ -52,7 +52,7 @@ module VMLib
       when :rel_type_custom
         lastfield = @relcustom.pop
         if lastfield.kind_of? Integer
-          @relcustom.push (lastfield + 1)
+          @relcustom.push lastfield + 1
         else
           @relcustom.push lastfield
           raise Errors::BumpError, "cannot bump a non-numeric prerelease field"

data/lib/vmlib/class.rb

@@ -0,0 +1,57 @@
+###############################################################################
+# VMLib class attributes
+###############################################################################
+# Copyright (C) 2013 Nirenjan Krishnan
+# All rights reserved.
+###############################################################################
+
+;
+
+module VMLib
+
+  # This is the primary version number class for the version manager library
+  class Version
+
+    #==================================================================
+    # Compare build operator - this is false by default
+    #==================================================================
+    @@compare_build = false
+
+    def self.compare_build= (val) #:nodoc:
+      unless val == true or val == false
+        raise Errors::ParameterError, "invalid value #{val}"
+      end
+
+      @@compare_build = val
+    end
+
+    # Specify whether to compare build metadata or not between two versions
+    def self.compare_build
+      @@compare_build
+    end
+
+    #==================================================================
+    # Prerelease parser - this is enabled by default
+    #==================================================================
+    @@enable_prerelease_parser = true
+
+    def self.enable_prerelease_parser= (val) #:nodoc:
+      unless val == true or val == false
+        raise Errors::ParameterError, "invalid value #{val}"
+      end
+
+      @@enable_prerelease_parser = val
+    end
+
+    # Specify whether to use the prerelease parser or not. Disabling this
+    # will cause an error to be thrown in the following cases:
+    # * Calling the bump_release_type functionality
+    # * Calling bump_prerelease with a non-numeric identifier at the end
+    def self.enable_prerelease_parser
+      @@enable_prerelease_parser
+    end
+
+  end
+
+
+end

data/lib/vmlib/compare.rb

@@ -90,13 +90,15 @@ module VMLib
       cmp = -1 if cmp == 1 and other_pre.length == 0
       return cmp unless cmp == 0
 
-      # Check build arrays
-      myown_bld = self.build.split('.')
-      convert_to_integer(myown_bld)
-      other_bld = other.build.split('.')
-      convert_to_integer(other_bld)
-      cmp = compare_arrays(myown_bld, other_bld)
-      return cmp unless cmp == 0
+      # Check build arrays, but only if specified
+      # As with the parser, leave identifiers as strings so they can
+      # be compared lexically
+      if (@@compare_build)
+        myown_bld = self.build.split('.')
+        other_bld = other.build.split('.')
+        cmp = compare_arrays(myown_bld, other_bld)
+        return cmp unless cmp == 0
+      end
 
       return 0
     end

data/lib/vmlib/parse.rb

@@ -103,6 +103,11 @@ module VMLib
           @reltype = :rel_type_custom
         end
 
+        # The user may have disabled the prerelease parser
+        unless (@@enable_prerelease_parser)
+          @reltype = :rel_type_custom
+        end
+
         # Done parsing, clear the relcustom array if it's not a custom type
         @relcustom = [] unless @reltype == :rel_type_custom
         convert_to_integer(@relcustom)
@@ -130,7 +135,8 @@ module VMLib
 
         # Done parsing, clear the array if it's not a custom type
         @buildcustom = [] unless @buildtype == :bld_type_custom
-        convert_to_integer(@buildcustom)
+        # Converting to integer breaks some of the sample test cases on
+        # semver.org. Therefore, we will leave the strings as is.
       else # if !match
         # It may be an empty string, so set the buildtype to final in that case
         if str.empty?
@@ -147,6 +153,8 @@ module VMLib
     # With the exception of the root parse function
     public
 
+    # Parse a string containing the project name and version number into
+    # its individual components
     def parse(ver)
       unless ver.kind_of? String
         raise Errors::ParameterError, "expected a string to be parsed"
@@ -160,9 +168,10 @@ module VMLib
       if match
         @name = match[:name]
         ver = ver.sub(NAME_REGEX, '')
-      #else
-      # Sometimes we may not get a name to be parsed. If that's the case
-      # then simply ignore it.
+      else
+        # Sometimes we may not get a name to be parsed. If that's the case
+        # then ensure we clear the name field.
+        @name = ''
       end
 
       # Match the major, minor and patch versions

data/lib/vmlib/source.rb

@@ -13,7 +13,7 @@ module VMLib
   class Source
 
     # Set up the tree to find the root of the source repository
-    def initialize(dir = nil)
+    def initialize(vformat = '"%M.%m.%p%r%b"', dir = nil)
       # Find the primary version file and get the root path
       version = File.new.find_file(dir)
       root = ::File.dirname(version)
@@ -27,7 +27,7 @@ module VMLib
       verdata = ::File.read(version)
       v = Version.new
       v.parse verdata
-      @verstring = v.format '"%M.%m.%p%r%b"'
+      @verstring = v.format vformat
     end
 
     # Update the specified file

data/lib/vmlib/version.rb

@@ -7,6 +7,11 @@
 
 module VMLib
 
-  VERSION = "1.0.1" #:nodoc:
+  VERSION = "1.1.0" #:nodoc:
 
+  # This function is used by the gemspec file to generate a
+  # gem version number that corresponds to %M.%m.%p format
+  def VMLib.gem_version #:nodoc:
+    /\d+\.\d+\.\d+/.match(VERSION).to_s
+  end
 end

data/lib/vmlib.rb

@@ -5,6 +5,9 @@
 # All rights reserved.
 ###############################################################################
 
+# Class attributes
+require 'vmlib/class'
+
 # Version processing
 require 'vmlib/base'
 require 'vmlib/bump'

data/test/test_version_basic.rb

@@ -104,6 +104,32 @@ module VMLib
         assert_equal '0.0.0', version.to_s
       end
 
+
+      # Test the build assignment
+      def test_build
+        version = VMLib::Version.new
+        version.build = '1'
+        assert_equal '0.0.0-0+1', version.to_s
+
+        version.prerelease = ''
+        assert_equal '0.0.0+1', version.to_s
+
+        version.build = 'foo.bar.baz'
+        assert_equal '0.0.0+foo.bar.baz', version.to_s
+
+        # Verify that the build identifiers get treated as strings,
+        # basically checking that we don't strip leading zeroes in fields
+        # with only digits
+        version.build = '001'
+        assert_equal '0.0.0+001', version.to_s
+
+        version.build = '20130313144700'
+        assert_equal '0.0.0+20130313144700', version.to_s
+
+        version.build = 'exp.sha.5114f85'
+        assert_equal '0.0.0+exp.sha.5114f85', version.to_s
+      end
+
     end
 
 

data/test/test_version_bump.rb

@@ -0,0 +1,207 @@
+###############################################################################
+# VMLib bump test cases
+###############################################################################
+# Copyright (C) 2013 Nirenjan Krishnan
+# All rights reserved.
+###############################################################################
+
+require 'test/unit'
+require 'vmlib'
+
+module VMLib
+
+  module Tests #:nodoc:
+
+    class TestBump < ::Test::Unit::TestCase   #:nodoc:
+
+      # Test bumping the patch version
+      def test_bump_patch
+        version = VMLib::Version.new
+        assert_equal '0.0.0-0', version.to_s
+
+        version.bump_patch
+        assert_equal '0.0.1-0', version.to_s
+
+        version.prerelease = ''
+        version.bump_patch
+        assert_equal '0.0.2', version.to_s
+      end
+
+    
+      # Test bumping the minor version
+      # Once with a zero patch, and again with a non-zero patch
+      def test_bump_minor
+        version = VMLib::Version.new
+        assert_equal '0.0.0-0', version.to_s
+
+        version.bump_minor
+        assert_equal '0.1.0-0', version.to_s
+
+        version.patch = 4
+        assert_equal '0.1.4-0', version.to_s
+
+        # Does bumping the minor version reset the patch to zero?
+        version.bump_minor
+        assert_equal '0.2.0-0', version.to_s
+
+        # Does bumping the minor version leave the prerelease unaffected?
+        version.prerelease = 'rc.0'
+        version.bump_minor
+        assert_equal '0.3.0-rc.0', version.to_s
+      end
+
+
+      # Test bumping the major version
+      # Test with zero, and non-zero patch & minor versions
+      def test_bump_major
+        version = VMLib::Version.new
+        version.prerelease = ''
+        version.bump_major
+        assert_equal '1.0.0', version.to_s
+
+        version.patch = 1
+        assert_equal '1.0.1', version.to_s
+
+        # Does bumping the major version reset the patch to zero?
+        version.bump_major
+        assert_equal '2.0.0', version.to_s
+
+        version.minor = 2
+        assert_equal '2.2.0', version.to_s
+
+        # Does bumping the major version reset the minor version to zero?
+        version.bump_major
+        assert_equal '3.0.0', version.to_s
+
+        version.minor = 1
+        version.patch = 4
+        assert_equal '3.1.4', version.to_s
+
+        # Does bumping the major version reset minor & patch to zero?
+        version.bump_major
+        assert_equal '4.0.0', version.to_s
+      end
+
+
+      # Test bumping a dev version
+      def test_bump_pre_dev
+        version = VMLib::Version.new
+        version.bump_prerelease
+        assert_equal '0.0.0-1', version.to_s
+
+        version.bump_prerelease
+        assert_equal '0.0.0-2', version.to_s
+      end
+
+      
+      # Test bumping dev to alpha and bumping alpha versions
+      def test_bump_pre_alpha
+        version = VMLib::Version.new
+        # Does type bumping a development version go to alpha?
+        version.bump_release_type
+        assert_equal '0.0.0-a.1', version.to_s
+
+        version.bump_prerelease
+        assert_equal '0.0.0-a.2', version.to_s
+      end
+
+
+      # Test bumping dev to alpha to beta & bumping beta versions
+      def test_bump_pre_beta
+        version = VMLib::Version.new
+        version.bump_release_type
+        assert_equal '0.0.0-a.1', version.to_s
+
+        # Does type bumping an alpha version go to beta?
+        version.bump_release_type
+        assert_equal '0.0.0-b.1', version.to_s
+
+        version.bump_prerelease
+        assert_equal '0.0.0-b.2', version.to_s
+      end
+
+
+      # Test bumping dev to alpha to beta to rc & bumping rc versions
+      def test_bump_pre_rc
+        version = VMLib::Version.new
+        version.bump_release_type
+        assert_equal '0.0.0-a.1', version.to_s
+
+        version.bump_release_type
+        assert_equal '0.0.0-b.1', version.to_s
+
+        # Does type bumping a beta version go to release candidate?
+        version.bump_release_type
+        assert_equal '0.0.0-rc.1', version.to_s
+
+        version.bump_prerelease
+        assert_equal '0.0.0-rc.2', version.to_s
+      end
+
+
+      # Test bumping dev to alpha to beta to rc to final & bumping final
+      def test_bump_pre_final
+        version = VMLib::Version.new
+        version.bump_release_type
+        assert_equal '0.0.0-a.1', version.to_s
+
+        version.bump_release_type
+        assert_equal '0.0.0-b.1', version.to_s
+
+        version.bump_release_type
+        assert_equal '0.0.0-rc.1', version.to_s
+
+        # Does type bumping a release candidate go to final?
+        version.bump_release_type
+        assert_equal '0.0.0', version.to_s
+
+        # Bumping type from final raises BumpError
+        assert_raise(VMLib::Errors::BumpError) do
+          version.bump_release_type
+        end
+
+        # Bumping from final raises BumpError
+        assert_raise(VMLib::Errors::BumpError) do
+          version.bump_prerelease
+        end
+      end
+
+
+      # Test bumping a custom type
+      def test_bump_pre_custom
+        version = VMLib::Version.new
+        
+        # Does bumping a custom prerelease string increment the last field
+        # (if numeric)?
+        version.prerelease = 'foo.9'
+        assert_equal '0.0.0-foo.9', version.to_s
+
+        version.bump_prerelease
+        assert_equal '0.0.0-foo.10', version.to_s
+
+        version.prerelease = '1.2.3.4.5.6.7.8.9'
+        assert_equal '0.0.0-1.2.3.4.5.6.7.8.9', version.to_s
+
+        version.bump_prerelease
+        assert_equal '0.0.0-1.2.3.4.5.6.7.8.10', version.to_s
+
+        # Error raised when bumping a non-numeric final field
+        version.prerelease = 'foo'
+        assert_raise(VMLib::Errors::BumpError) do
+          version.bump_prerelease
+        end
+
+        version.prerelease = '1.2.3.4.5.foo'
+        assert_raise(VMLib::Errors::BumpError) do
+          version.bump_prerelease
+        end
+      end
+
+
+    end
+
+
+  end
+
+
+end

data/test/test_version_compare.rb

@@ -0,0 +1,190 @@
+###############################################################################
+# VMLib version comparision test cases
+###############################################################################
+# Copyright (C) 2013 Nirenjan Krishnan
+# All rights reserved.
+###############################################################################
+
+require 'test/unit'
+require 'vmlib'
+
+module VMLib
+
+  module Tests #:nodoc:
+
+    class TestCompare < ::Test::Unit::TestCase   #:nodoc:
+
+      # Test comparing two versions with different major, minor & patch
+      def test_compare_regular
+        version1 = VMLib::Version.new
+        version2 = VMLib::Version.new
+
+        # Test if having identical version strings is working
+        assert_equal 0, version1 <=> version2
+
+        # Test if having different major versions shows up correctly
+        version1.major = 1
+        assert_equal 1, version1 <=> version2
+
+        # Test if having different minor versions shows up correctly
+        version2.major = 1
+        version2.minor = 1
+        assert_equal -1, version1 <=> version2
+
+        # Test if having different patch versions shows up correctly
+        version1.minor = 1
+        version2.patch = 10
+        assert_equal -1, version1 <=> version2
+
+        # Test if setting the versions to identical one shows up as equal
+        version1.patch = 10
+        assert_equal 0, version1 <=> version2
+
+        # Test using digits of different length in the patch
+        version2.patch = 9
+        assert_equal 1, version1 <=> version2
+      end
+
+      # Test comparing two versions with different prerelease info
+      def test_compare_prerelease
+        version1 = VMLib::Version.new
+        version2 = VMLib::Version.new
+
+        # Test that a prerelease sorts lower than non-prerelease version
+        version1.prerelease = ''
+        assert_equal 1, version1 <=> version2
+
+        # Test that two dev releases sort in order
+        version1.prerelease = '1'
+        assert_equal 1, version1 <=> version2
+
+        # Test that a dev and an alpha sort with dev lower
+        version1.bump_release_type
+        assert_equal 1, version1 <=> version2
+
+        # Test that a dev and a beta sort with dev lower
+        version1.bump_release_type
+        assert_equal 1, version1 <=> version2
+
+        # Test that a dev and a rc sort with dev lower
+        version1.bump_release_type
+        assert_equal 1, version1 <=> version2
+
+        # Test that an alpha and alpha are sorted in order
+        version1.prerelease = 'alpha.1'
+        version2.prerelease = 'alpha.1'
+        assert_equal 0, version1 <=> version2
+
+        version1.prerelease = 'alpha.2'
+        assert_equal 1, version1 <=> version2
+
+        # Test that an alpha and a beta sort with alpha lower
+        version1.bump_release_type
+        assert_equal 1, version1 <=> version2
+
+        # Test that an alpha and a rc sort with alpha lower
+        version1.bump_release_type
+        assert_equal 1, version1 <=> version2
+
+        # Test that a beta and beta are sorted in order
+        version1.prerelease = 'beta.1'
+        version2.prerelease = 'beta.1'
+        assert_equal 0, version1 <=> version2
+
+        version1.prerelease = 'beta.2'
+        assert_equal 1, version1 <=> version2
+
+        # Test that a beta and a rc sort with beta lower
+        version1.bump_release_type
+        assert_equal 1, version1 <=> version2
+
+        # Test that a rc and rc are sorted in order
+        version1.prerelease = 'rc.1'
+        version2.prerelease = 'rc.1'
+        assert_equal 0, version1 <=> version2
+
+        version1.prerelease = 'rc.2'
+        assert_equal 1, version1 <=> version2
+      end
+
+
+      # Test that a custom prerelease sorts the same way as a defined one
+      def test_compare_custom_prerelease
+        version1 = VMLib::Version.new
+        version2 = VMLib::Version.new
+
+        version1.prerelease = 'foo.bar.baz'
+        version2.prerelease = 'foo.bar.baz'
+        assert_equal 0, version1 <=> version2
+        
+        # Test that two alphanumeric prerelease strings get sorted lexically
+        version1.prerelease = 'foo.bas.baz'
+        assert_equal 1, version1 <=> version2
+
+        version1.prerelease = 'foo.bars.baz'
+        assert_equal 1, version1 <=> version2
+
+        # Test that numeric identifiers get compared numerically
+        version1.prerelease = 'foo.123'
+        version2.prerelease = 'foo.21'
+        assert_equal 1, version1 <=> version2
+
+        # Test sample test cases from mojombo/semver#100
+        version1.prerelease = 'a.3.b.54'
+        version2.prerelease = 'a.2.b.55'
+        assert_equal 1, version1 <=> version2
+
+        version1.prerelease = 'a.b.2'
+        version2.prerelease = 'a.1.b'
+        assert_equal 1, version1 <=> version2
+
+        version1.prerelease = 'a.99.c.1'
+        version2.prerelease = 'a.1.b.2'
+        assert_equal 1, version1 <=> version2
+
+        version1.prerelease = 'a.b'
+        version2.prerelease = 'a.1.b.2'
+        assert_equal 1, version1 <=> version2
+
+        # Test that longer identifiers sort higher than shorter ones
+        version1.prerelease = 'a.1.b.2.c'
+        assert_equal 1, version1 <=> version2
+      end
+
+
+      # Test that build metadata is ignored in sorts unless explicitly enabled
+      def test_compare_build
+        version1 = VMLib::Version.new
+        version2 = VMLib::Version.new
+
+        version1.build = '5c08ad0'
+        version2.build = '44cbb6c'
+        assert_equal 0, version1 <=> version2
+
+        VMLib::Version.compare_build = true
+        assert_equal 1, version1 <=> version2
+
+        # Test that having a build metadata sorts higher than none
+        version2.build = ''
+        assert_equal 1, version1 <=> version2
+        
+        version2.build = '5c08ad0'
+        assert_equal 0, version1 <=> version2
+        
+        # Test that longer build meta data sorts higher than shorter
+        version1.build = '5c08ad0.20130618'
+        assert_equal 1, version1 <=> version2
+
+        # Test that numeric identifiers sort lexically
+        version2.build = '5c08ad0.102467890'
+        assert_equal 1, version1 <=> version2
+      end
+
+
+    end
+
+
+  end
+
+
+end

data/test/test_version_format.rb

@@ -0,0 +1,209 @@
+###############################################################################
+# VMLib version formatting test cases
+###############################################################################
+# Copyright (C) 2013 Nirenjan Krishnan
+# All rights reserved.
+###############################################################################
+
+require 'test/unit'
+require 'vmlib'
+
+module VMLib
+
+  module Tests #:nodoc:
+
+    class TestFormat < ::Test::Unit::TestCase   #:nodoc:
+
+      
+      # Test if printing the name comes out correctly
+      def test_format_name
+        version = VMLib::Version.new
+        # Test if an empty name corresponds to an empty string
+        assert_equal '', version.format('%n')
+
+        # Test if a valid name corresponds to the name plus a space
+        version.name = 'foo'
+        assert_equal 'foo ', version.format('%n')
+        assert_equal 'foo bar', version.format('%nbar')
+        assert_equal 'foo  bar', version.format('%n bar')
+      end
+
+
+      # Test if printing the major version comes out correctly
+      def test_format_major
+        version = VMLib::Version.new
+        assert_equal '0', version.format('%M')
+        
+        version.major = 42
+        assert_equal '42', version.format('%M')
+      end
+
+
+      # Test if printing the minor version comes out correctly
+      def test_format_minor
+        version = VMLib::Version.new
+        assert_equal '0', version.format('%m')
+        
+        version.minor = 13
+        assert_equal '13', version.format('%m')
+      end
+
+
+      # Test if printing the patch version comes out correctly
+      def test_format_patch
+        version = VMLib::Version.new
+        assert_equal '0', version.format('%p')
+        
+        version.patch = 16
+        assert_equal '16', version.format('%p')
+      end
+
+
+      # Test if printing the prerelease version comes out correctly
+      def test_format_prerelease
+        version = VMLib::Version.new
+        
+        # Test that an empty prerelease corresponds to an empty string
+        version.prerelease = ''
+        assert_equal '', version.format('%r')
+
+        # Test that a dev release corresponds to a -# string
+        version.prerelease = '0'
+        assert_equal '-0', version.format('%r')
+        version.prerelease = '1'
+        assert_equal '-1', version.format('%r')
+
+        # Test that an alpha prerelease corresponds to a -a.# string
+        version.prerelease = 'alpha.1'
+        assert_equal '-a.1', version.format('%r')
+        version.prerelease = 'a.2'
+        assert_equal '-a.2', version.format('%r')
+
+        # Test that a beta prerelease corresponds to a -b.# string
+        version.prerelease = 'beta.3'
+        assert_equal '-b.3', version.format('%r')
+        version.prerelease = 'b.4'
+        assert_equal '-b.4', version.format('%r')
+
+        # Test that a rc prerelease corresponds to a -rc.# string
+        version.prerelease = 'rc.5'
+        assert_equal '-rc.5', version.format('%r')
+
+        # Test that a custom prerelease prints as entered
+        version.prerelease = 'foo.bar.baz'
+        assert_equal '-foo.bar.baz', version.format('%r')
+        version.prerelease = '1.2.3.4.5.6.7.8.9.0'
+        assert_equal '-1.2.3.4.5.6.7.8.9.0', version.format('%r')
+
+        # Verify that numeric fields are stripped of leading zeroes
+        version.prerelease = '1.2.3.4.5.6.7.8.9.09'
+        assert_equal '-1.2.3.4.5.6.7.8.9.9', version.format('%r')
+
+      end
+
+
+      # Test if printing the prerelease version comes out correctly
+      def test_format_build
+        version = VMLib::Version.new
+
+        # Test that an emtpy build corresponds to an empty string
+        version.build = ''
+        assert_equal '', version.format('%b')
+
+        # Test that a custom build prints exactly as entered
+        version.build = '001'
+        assert_equal '+001', version.format('%b')
+
+        version.build = '20130313144700'
+        assert_equal '+20130313144700', version.format('%b')
+
+        version.build = 'exp.sha.5114f85'
+        assert_equal '+exp.sha.5114f85', version.format('%b')
+      end
+
+
+      # Test if the tag format comes out as expected
+      def test_format_tag
+        version = VMLib::Version.new 'foo', 1, 2, 3, 'rc.1', 'sha.5114f85'
+
+        # Make sure all fields are included in the tag
+        assert_equal 'v1.2.3-rc.1+sha.5114f85', version.tag
+
+        # Changing the build should reflect in the tag
+        version.build = 'sha.0012312'
+        assert_equal 'v1.2.3-rc.1+sha.0012312', version.tag
+
+        # Removing the build should reflect in the tag
+        version.build = ''
+        assert_equal 'v1.2.3-rc.1', version.tag
+
+        # Changing the prerelease should reflect in the tag
+        version.prerelease = 'alpha.02'
+        assert_equal 'v1.2.3-a.2', version.tag
+
+        # Removing the prerelease should reflect in the tag
+        version.prerelease = ''
+        assert_equal 'v1.2.3', version.tag
+
+        # Having a build metadata and no prerelease should reflect in the tag
+        version.build = 'sha.12ab32d'
+        assert_equal 'v1.2.3+sha.12ab32d', version.tag
+      end
+
+
+      # Test if the to_s function works as expected
+      def test_format_to_s
+        version = VMLib::Version.new 'foo', 1, 2, 3, 'rc.1', 'sha.5114f85'
+
+        # Make sure all fields are included in the to_s
+        assert_equal 'foo 1.2.3-rc.1+sha.5114f85', version.to_s
+
+        # Changing the name should reflect in the to_s
+        version.name = 'bar'
+        assert_equal 'bar 1.2.3-rc.1+sha.5114f85', version.to_s
+
+        # Changing the major number should reflect in the to_s
+        version.major = 4
+        assert_equal 'bar 4.2.3-rc.1+sha.5114f85', version.to_s
+
+        # Changing the minor number should reflect in the to_s
+        version.minor = 5
+        assert_equal 'bar 4.5.3-rc.1+sha.5114f85', version.to_s
+
+        # Changing the patch number should reflect in the to_s
+        version.patch = 6
+        assert_equal 'bar 4.5.6-rc.1+sha.5114f85', version.to_s
+
+        version.major = 1
+        version.minor = 2
+        version.patch = 3
+
+        # Changing the build should reflect in the to_s
+        version.build = 'sha.0012312'
+        assert_equal 'bar 1.2.3-rc.1+sha.0012312', version.to_s
+
+        # Removing the build should reflect in the to_s
+        version.build = ''
+        assert_equal 'bar 1.2.3-rc.1', version.to_s
+
+        # Changing the prerelease should reflect in the to_s
+        version.prerelease = 'alpha.02'
+        assert_equal 'bar 1.2.3-a.2', version.to_s
+
+        # Removing the prerelease should reflect in the to_s
+        version.prerelease = ''
+        assert_equal 'bar 1.2.3', version.to_s
+
+        # Having a build metadata and no prerelease should reflect in the to_s
+        version.build = 'sha.12ab32d'
+        assert_equal 'bar 1.2.3+sha.12ab32d', version.to_s
+      end
+
+
+    end
+
+
+  end
+
+
+end

data/test/test_version_parse.rb

@@ -0,0 +1,207 @@
+###############################################################################
+# VMLib version parsing test cases
+###############################################################################
+# Copyright (C) 2013 Nirenjan Krishnan
+# All rights reserved.
+###############################################################################
+
+require 'test/unit'
+require 'vmlib'
+
+module VMLib
+
+  module Tests #:nodoc:
+
+    class TestVersionParse < ::Test::Unit::TestCase   #:nodoc:
+
+
+      # Test parsing individual components
+      def test_version_parse
+        v = VMLib::Version.new
+
+        # Test parsing the version with name and prerelease
+        v.parse 'vmlib v1.1.0-2'
+
+        assert_equal 'vmlib', v.name
+        assert_equal 1, v.major
+        assert_equal 1, v.minor
+        assert_equal 0, v.patch
+        assert_equal '-2', v.prerelease
+        assert_equal '', v.build
+
+        # Test parsing a version without the name
+        v.parse 'v1.1.0-2'
+
+        assert_equal '', v.name
+        assert_equal 1, v.major
+        assert_equal 1, v.minor
+        assert_equal 0, v.patch
+        assert_equal '-2', v.prerelease
+        assert_equal '', v.build
+
+        # Test parsing a version with the format as name version X.Y.Z
+        v.parse 'vmlib version 1.1.0-2'
+
+        assert_equal 'vmlib', v.name
+        assert_equal 1, v.major
+        assert_equal 1, v.minor
+        assert_equal 0, v.patch
+        assert_equal '-2', v.prerelease
+        assert_equal '', v.build
+
+        # Test parsing a version with the format as name X.Y.Z
+        v.parse 'vmlib 1.1.0-2'
+
+        assert_equal 'vmlib', v.name
+        assert_equal 1, v.major
+        assert_equal 1, v.minor
+        assert_equal 0, v.patch
+        assert_equal '-2', v.prerelease
+        assert_equal '', v.build
+
+        # Right now, vmlib does not support having the format
+        # version X.Y.Z, i.e., no name, but the string 'version'
+        # followed by the version number. If you need to use the
+        # 'version' string format, then you must have a program
+        # name, otherwise, it will treat the program name as 'version'
+      end
+
+      # Check parsing of strings with various prerelease combinations
+      def test_parse_pre
+        v = VMLib::Version.new
+
+        # Default case - prerelease parser enabled
+        v.parse 'v1.1.0-2'
+        assert_equal '', v.name
+        assert_equal 1, v.major
+        assert_equal 1, v.minor
+        assert_equal 0, v.patch
+        assert_equal '-2', v.prerelease
+        assert_equal '', v.build
+
+        # Check alpha case
+        v.parse 'v1.1.0-a.2'
+        assert_equal '', v.name
+        assert_equal 1, v.major
+        assert_equal 1, v.minor
+        assert_equal 0, v.patch
+        assert_equal '-a.2', v.prerelease
+        assert_equal '', v.build
+
+        v.parse 'v1.1.0-alpha.2'
+        assert_equal '', v.name
+        assert_equal 1, v.major
+        assert_equal 1, v.minor
+        assert_equal 0, v.patch
+        assert_equal '-a.2', v.prerelease
+        assert_equal '', v.build
+
+        # Check beta case
+        v.parse 'v1.1.0-b.2'
+        assert_equal '', v.name
+        assert_equal 1, v.major
+        assert_equal 1, v.minor
+        assert_equal 0, v.patch
+        assert_equal '-b.2', v.prerelease
+        assert_equal '', v.build
+
+        v.parse 'v1.1.0-beta.2'
+        assert_equal '', v.name
+        assert_equal 1, v.major
+        assert_equal 1, v.minor
+        assert_equal 0, v.patch
+        assert_equal '-b.2', v.prerelease
+        assert_equal '', v.build
+
+        # Check rc case
+        v.parse 'v1.1.0-rc.2'
+        assert_equal '', v.name
+        assert_equal 1, v.major
+        assert_equal 1, v.minor
+        assert_equal 0, v.patch
+        assert_equal '-rc.2', v.prerelease
+        assert_equal '', v.build
+
+        # Check final case
+        v.parse 'v1.1.0'
+        assert_equal '', v.name
+        assert_equal 1, v.major
+        assert_equal 1, v.minor
+        assert_equal 0, v.patch
+        assert_equal '', v.prerelease
+        assert_equal '', v.build
+
+        # Check custom case
+        v.parse 'v1.1.0-alpha.1a'
+        assert_equal '', v.name
+        assert_equal 1, v.major
+        assert_equal 1, v.minor
+        assert_equal 0, v.patch
+        assert_equal '-alpha.1a', v.prerelease
+        assert_equal '', v.build
+
+        # Check with prerelease parser disabled
+        # This mainly addresses the alpha and beta cases, since it reduces
+        # the output to a.X and b.Y for alpha.X and beta.Y respectively
+        VMLib::Version.enable_prerelease_parser = false
+        # Check alpha case
+        v.parse 'v1.1.0-alpha.2'
+        assert_equal '-alpha.2', v.prerelease
+
+        # Check beta case
+        v.parse 'v1.1.0-beta.2'
+        assert_equal '-beta.2', v.prerelease
+
+        # Re-enable the prerelease parser and check if it works as expected
+        VMLib::Version.enable_prerelease_parser = true
+        # Check alpha case
+        v.parse 'v1.1.0-alpha.2'
+        assert_equal '-a.2', v.prerelease
+
+        # Check beta case
+        v.parse 'v1.1.0-beta.2'
+        assert_equal '-b.2', v.prerelease
+      end
+
+      # Test that the build combinations are stored as entered
+      def test_parse_build
+        v = VMLib::Version.new
+
+        v.parse 'vmlib v1.2.0+20130628.0354.gef3c66c'
+        assert_equal 'vmlib', v.name
+        assert_equal 1, v.major
+        assert_equal 2, v.minor
+        assert_equal 0, v.patch
+        assert_equal '', v.prerelease
+        assert_equal '+20130628.0354.gef3c66c', v.build
+      end
+
+      # Test that you can store any combination of pre and build, and
+      # it works as expected
+      def test_parse_pre_build_combo
+        v = VMLib::Version.new
+
+        v.parse 'vmlib version 1.1.0-3+20130628.0354.gef3c66c'
+        assert_equal 'vmlib', v.name
+        assert_equal 1, v.major
+        assert_equal 1, v.minor
+        assert_equal 0, v.patch
+        assert_equal '-3', v.prerelease
+        assert_equal '+20130628.0354.gef3c66c', v.build
+
+        v.parse 'vmlib version 1.1.0+20130628.0354.gef3c66c-3'
+        assert_equal 'vmlib', v.name
+        assert_equal 1, v.major
+        assert_equal 1, v.minor
+        assert_equal 0, v.patch
+        assert_equal '', v.prerelease
+        assert_equal '+20130628.0354.gef3c66c-3', v.build
+      end
+
+    end
+
+
+  end
+
+
+end

data/vmlib.gemspec

@@ -5,7 +5,7 @@ require 'vmlib/version'
 
 Gem::Specification.new do |s|
   s.name                    = 'vmlib'
-  s.version                 = VMLib::VERSION
+  s.version                 = VMLib::gem_version
   s.date                    = '2013-03-12'
   s.summary                 = "Version Manager Library"
   s.description             = "A gem to handle software versions"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: vmlib
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - Nirenjan Krishnan
@@ -45,6 +45,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- .ruby-version
 - Gemfile
 - README.md
 - Rakefile
@@ -53,6 +54,7 @@ files:
 - lib/vmlib.rb
 - lib/vmlib/base.rb
 - lib/vmlib/bump.rb
+- lib/vmlib/class.rb
 - lib/vmlib/compare.rb
 - lib/vmlib/errors.rb
 - lib/vmlib/file.rb
@@ -62,6 +64,10 @@ files:
 - lib/vmlib/source.rb
 - lib/vmlib/version.rb
 - test/test_version_basic.rb
+- test/test_version_bump.rb
+- test/test_version_compare.rb
+- test/test_version_format.rb
+- test/test_version_parse.rb
 - vmlib.gemspec
 homepage: http://rubygems.org/gems/vmlib
 licenses:
@@ -89,3 +95,7 @@ specification_version: 4
 summary: Version Manager Library
 test_files:
 - test/test_version_basic.rb
+- test/test_version_bump.rb
+- test/test_version_compare.rb
+- test/test_version_format.rb
+- test/test_version_parse.rb