sem_ver 0.1.1

data/README.md

@@ -0,0 +1,27 @@
+# SemVer [![Build Status](https://secure.travis-ci.org/porras/sem_ver.png?branch=master)](http://travis-ci.org/porras/sem_ver)
+
+SemVer is a very simple [semantic version](http://semver.org/spec/v1.0.0.html) parser in Ruby. It takes a string and returns an object that can be validated and compared.
+
+## Examples
+
+    require 'sem_ver'
+    
+    SemVer.parse('0.0.10').valid?                       # true
+    SemVer.parse('v1.0.10').valid?                      # true
+    SemVer.parse('X.10').valid?                         # false
+    
+    SemVer.parse('1.0.0') >  SemVer.parse('0.9.9')      # true
+    SemVer.parse('1.0.1') >= SemVer.parse('1.0.0')      # true
+    SemVer.parse('1.0.1') >= SemVer.parse('1.1.0')      # false
+    SemVer.parse('1.0.0') == SemVer.parse('1.0.0-pre1') # false
+    SemVer.parse('1.0.0') >  SemVer.parse('1.0.0-pre1') # true
+    
+    ...
+
+## Alternatives
+
+If you need more advanced things, [versionomy](http://dazuma.github.com/versionomy/) looks great.
+
+## Credits
+
+Copyright © 2012 Sergio Gil, released under the MIT license

data/lib/sem_ver.rb

@@ -0,0 +1,69 @@
+class SemVer
+  class InvalidVersion < Exception; end
+  
+  include Comparable
+  
+  def self.parse(*args)
+    new(*args)
+  end
+  
+  def initialize(spec)
+    @spec = spec
+  end
+  
+  def major
+    match && match[1].to_i
+  end
+  
+  def minor
+    match && match[2].to_i
+  end
+  
+  def patch
+    match && match[3].to_i
+  end
+  
+  def prerelease
+    match && match[5]
+  end
+  
+  def valid?
+    !!match
+  end
+  
+  def <=>(other)
+    raise InvalidVersion.new(to_s) unless valid? && other.valid?
+    parts <=> other.parts
+  end
+  
+  def to_s
+    return @spec unless valid?
+    "#{major}.#{minor}.#{patch}".tap do |v|
+      v << "-#{prerelease}" if prerelease
+    end
+  end
+  
+  def inspect
+    "<#{'Invalid' unless valid?}Version: #{to_s}>"
+  end
+  
+  protected
+  
+  def parts
+    [major, minor, patch, prerelease_value]
+  end
+  
+  private
+  
+  def prerelease_value
+    prerelease ? prerelease.bytes.to_a : [Float::INFINITY]
+  end
+  
+  def match
+    @match ||= @spec.match(/^v?(\d+)\.(\d+)\.(\d+)(\-(\w+))?$/)
+  end
+end
+
+unless defined?(Float::INFINITY)
+  Float::INFINITY = +1.0/0.0
+end

data/spec/sem_ver_spec.rb

@@ -0,0 +1,136 @@
+require 'rspec'
+require 'sem_ver'
+
+describe SemVer do
+  describe '.parse' do
+    describe 'normal' do
+      let(:version) { SemVer.parse('3.1.2') }
+      
+      example { version.major.should == 3 }
+      example { version.minor.should == 1 }
+      example { version.patch.should == 2 }
+      example { version.prerelease.should == nil }
+      
+      describe 'order' do
+        example { SemVer.parse('0.0.10').should > SemVer.parse('0.0.9') }
+        example { SemVer.parse('0.1.0').should > SemVer.parse('0.0.2') }
+        example { SemVer.parse('1.0.0').should > SemVer.parse('0.9.9') }
+        
+        example { SemVer.parse('0.0.1').should < SemVer.parse('0.0.2') }
+        example { SemVer.parse('0.0.2').should < SemVer.parse('0.1.0') }
+        example { SemVer.parse('0.9.9').should < SemVer.parse('1.0.0') }
+        
+        example { SemVer.parse('0.0.1').should == SemVer.parse('0.0.1') }
+        example { SemVer.parse('0.0.2').should == SemVer.parse('0.0.2') }
+        example { SemVer.parse('0.9.9').should == SemVer.parse('0.9.9') }
+      end
+    end
+    
+    describe 'prereleases' do
+      let(:version) { SemVer.parse('1.0.11-rc2') }
+      
+      example { version.major.should == 1 }
+      example { version.minor.should == 0 }
+      example { version.patch.should == 11 }
+      example { version.prerelease.should == 'rc2' }
+      
+      describe 'order' do
+        example { SemVer.parse('1.0.0').should > SemVer.parse('1.0.0-rc15') }
+        example { SemVer.parse('1.0.0-rc15').should < SemVer.parse('1.0.0') }
+        example { SemVer.parse('1.0.0-rc15').should == SemVer.parse('1.0.0-rc15') }
+        example { SemVer.parse('1.0.0-rc16').should > SemVer.parse('1.0.0-rc15') }
+        example { SemVer.parse('1.0.1-rc14').should > SemVer.parse('1.0.0-rc15') }
+        example { SemVer.parse('1.0.1-rc15').should > SemVer.parse('1.0.0-rc15') }
+        example { SemVer.parse('v1.0.0-rc15').should == SemVer.parse('1.0.0-rc15') }
+      end
+    end
+    
+    describe 'vX.Y.Z' do
+      let(:version) { SemVer.parse('v3.1.2') }
+      
+      example { version.major.should == 3 }
+      example { version.minor.should == 1 }
+      example { version.patch.should == 2 }
+      example { version.prerelease.should == nil }
+      
+      describe 'equivalence' do
+        example { SemVer.parse('v0.0.1').should == SemVer.parse('0.0.1') }
+        example { SemVer.parse('v0.0.2').should == SemVer.parse('0.0.2') }
+        example { SemVer.parse('v0.9.9').should == SemVer.parse('0.9.9') }
+      end
+    end
+  end
+  
+  describe '#valid?' do
+    example { SemVer.parse('1.0.0').should be_valid }
+    example { SemVer.parse('v1.0.0').should be_valid }
+    example { SemVer.parse('1.0.0-rc1').should be_valid }
+    example { SemVer.parse('v1.0.0-rc1').should be_valid }
+    
+    example { SemVer.parse('v1.0.0-').should_not be_valid }
+    example { SemVer.parse('1.0.0-').should_not be_valid }
+    
+    example { SemVer.parse('1.0-rc1').should_not be_valid }
+    example { SemVer.parse('v1.0-rc1').should_not be_valid }
+    
+    example { SemVer.parse('1-rc1').should_not be_valid }
+    example { SemVer.parse('v1-rc1').should_not be_valid }
+    
+    example { SemVer.parse('1.0').should_not be_valid }
+    example { SemVer.parse('v1.0').should_not be_valid }
+    
+    example { SemVer.parse('1').should_not be_valid }
+    example { SemVer.parse('v1').should_not be_valid }
+    
+    example { SemVer.parse('X.0.0').should_not be_valid }
+    example { SemVer.parse('vX.0.0').should_not be_valid }
+    example { SemVer.parse('X.0.0-rc1').should_not be_valid }
+    example { SemVer.parse('vX.0.0-rc1').should_not be_valid }
+    example { SemVer.parse('1.X.0').should_not be_valid }
+    example { SemVer.parse('v1.X.0').should_not be_valid }
+    example { SemVer.parse('1.X.0-rc1').should_not be_valid }
+    example { SemVer.parse('v1.X.0-rc1').should_not be_valid }
+    example { SemVer.parse('1.0.X').should_not be_valid }
+    example { SemVer.parse('v1.0.X').should_not be_valid }
+    example { SemVer.parse('1.0.X-rc1').should_not be_valid }
+    example { SemVer.parse('v1.0.X-rc1').should_not be_valid }
+    
+    describe 'using a invalid version' do
+      let(:invalid_version) { SemVer.parse('1.0.wadus-rc1') }
+      
+      example { invalid_version.major.should == nil }
+      example { invalid_version.minor.should == nil }
+      example { invalid_version.patch.should == nil }
+      example { invalid_version.prerelease.should == nil }
+      
+      describe 'comparing' do
+        let(:valid_version) { SemVer.parse('1.0.0') }
+        
+        example { expect { invalid_version < valid_version }.to raise_error(SemVer::InvalidVersion) }
+        example { expect { valid_version < invalid_version }.to raise_error(SemVer::InvalidVersion) }
+        example { expect { invalid_version <= valid_version }.to raise_error(SemVer::InvalidVersion) }
+        example { expect { valid_version <= invalid_version }.to raise_error(SemVer::InvalidVersion) }
+        example { expect { invalid_version > valid_version }.to raise_error(SemVer::InvalidVersion) }
+        example { expect { valid_version > invalid_version }.to raise_error(SemVer::InvalidVersion) }
+        example { expect { invalid_version >= valid_version }.to raise_error(SemVer::InvalidVersion) }
+        example { expect { valid_version >= invalid_version }.to raise_error(SemVer::InvalidVersion) }
+        example { expect { invalid_version == valid_version }.to raise_error(SemVer::InvalidVersion) }
+        example { expect { valid_version == invalid_version }.to raise_error(SemVer::InvalidVersion) }
+        example { expect { invalid_version != valid_version }.to raise_error(SemVer::InvalidVersion) }
+        example { expect { valid_version != invalid_version }.to raise_error(SemVer::InvalidVersion) }
+      end
+    end
+  end
+  
+  describe '#to_s' do
+    example { SemVer.parse('1.0.0').to_s.should == '1.0.0' }
+    example { SemVer.parse('1.0.0-rc15').to_s.should == '1.0.0-rc15' }
+    example { SemVer.parse('1.0.wadus').to_s.should == '1.0.wadus' }
+  end
+  
+  describe '#inspect' do
+    example { SemVer.parse('1.0.0').inspect.should == '<Version: 1.0.0>' }
+    example { SemVer.parse('1.0.0-rc15').inspect.should == '<Version: 1.0.0-rc15>' }
+    example { SemVer.parse('1.0.wadus').inspect.should == '<InvalidVersion: 1.0.wadus>' }
+  end
+end

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification 
+name: sem_ver
+version: !ruby/object:Gem::Version 
+  hash: 25
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 1
+  version: 0.1.1
+platform: ruby
+authors: 
+- Sergio Gil
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2013-01-14 00:00:00 Z
+dependencies: []
+
+description: Semantic Version parser
+email: 
+- sgilperez@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/sem_ver.rb
+- README.md
+- spec/sem_ver_spec.rb
+homepage: http://github.com/porras/sem_ver
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Semantic Version parser
+test_files: 
+- spec/sem_ver_spec.rb
+has_rdoc: