sem_version 1.0.0

data/lib/sem_version.rb

@@ -0,0 +1,153 @@
+class SemVersion
+  include Comparable
+
+  VERSION = '1.0.0'
+  # Pattern allows min and patch to be skipped. We have to do extra checking if we want them
+  SEMVER_REGEX = /^(\d+)(?:\.(\d+)(?:\.(\d+)(?:-([\dA-Za-z\-]+(?:\.[\dA-Za-z\-]+)*))?(?:\+([\dA-Za-z\-]+(?:\.[\dA-Za-z\-]+)*))?)?)?$/
+
+  attr_reader :major, :minor, :patch, :pre, :build
+  alias_method :prerelease, :pre
+
+  # Format were raw bits are passed in is undocumented, and not validity checked
+  def initialize(string, *args)
+    if args.empty?
+      @major, @minor, @patch, @pre, @build = self.class.parse(string)
+    else
+      @major, @minor, @patch, @pre, @build = [string, *args]
+    end
+  end
+
+  def self.parse(string)
+    match = string.match(SEMVER_REGEX)
+    raise ArgumentError, "Version string #{string} is not valid" unless match
+    maj, min, pat, pre, bui = match.captures
+    raise ArgumentError, "Version string #{string} is not valid" if min.empty? || pat.empty?
+    [maj.to_i, min.to_i, pat.to_i, pre, bui]
+  end
+
+  def self.from_loose_version(string)
+    match = string.match(SEMVER_REGEX)
+    raise ArgumentError, "Version string #{string} is not valid" unless match
+    maj, min, pat, pre, bui = match.captures
+    min = 0 if min.nil? || min.empty?
+    pat = 0 if pat.nil? || pat.empty?
+    new(maj.to_i, min.to_i, pat.to_i, pre, bui)
+  end
+
+  def self.valid?(string)
+    matches = string.match(SEMVER_REGEX)
+    matches && !matches[2].nil? && !matches[3].nil?
+  end
+
+  def <=>(other)
+    maj = @major <=> other.major
+    return maj unless maj == 0
+
+    min = @minor <=> other.minor
+    return min unless min == 0
+
+    pat = @patch <=> other.patch
+    return pat unless pat == 0
+
+    pre = compare_sep(@pre, other.pre, true)
+    return pre unless pre == 0
+
+    bui = compare_sep(@build, other.build, false)
+    return bui unless bui == 0
+
+    0
+  end
+
+  def satisfies?(constraint)
+    comparison, version = constraint.strip.split(' ', 2)
+    # Allow pessimistic operator
+    if comparison == '~>'
+      match = version.match(/^(\d+)\.(\d+)\.?(\d*)$/)
+      raise ArgumentError, "Pessimistic constraints must have a version in the form 'x.y' or 'x.y.z'" unless match
+      maj, min, pat = match.captures
+      if pat.empty?
+        lower = "#{maj}.#{min}.0"
+        upper = "#{maj.to_i+1}.0.0"
+      else
+        lower = "#{maj}.#{min}.#{pat}"
+        upper = "#{maj}.#{min.to_i+1}.0"
+      end
+
+      send('>=', SemVersion.new(lower)) && send('<', SemVersion.new(upper)) 
+    else
+      # Allow '1.0.2' as '== 1.0.2'
+      version, comparison = comparison, '==' if version.nil?
+      # Allow '= 1.0.2' as '== 1.0.2'
+      comparison = '==' if comparison == '='
+
+      semversion = self.class.from_loose_version(version)
+
+      send(comparison, semversion)
+    end
+  end
+
+  def major=(val)
+    raise ArgumentError, "#{val} is not a valid major version (must be an integer >= 0)" unless val.is_a?(Fixnum) && val >= 0
+    @major = val
+  end
+
+  def minor=(val)
+    raise ArgumentError, "#{val} is not a valid minor version (must be an integer >= 0)" unless val.is_a?(Fixnum) && val >= 0
+    @minor = val
+  end
+
+  def patch=(val)
+    raise ArgumentError, "#{val} is not a valid patch version (must be an integer >= 0)" unless val.is_a?(Fixnum) && val >= 0
+    @patch = val
+  end
+
+  def pre=(val)
+    if !val.is_a?(String) || val !~ /^[\dA-Za-z\-]+(\.[\dA-Za-z\-]+)*$/
+      raise ArgumentError, "#{val} is not a valid pre-release version (must be a string following http://semver.org constraints)"
+    end
+    @pre = val
+  end
+  alias_method :prerelease=, :pre=
+
+  def build=(val)
+    if !val.is_a?(String) || val !~ /^[\dA-Za-z\-]+(\.[\dA-Za-z\-]+)*$/
+      raise ArgumentError, "#{val} is not a valid pbuild version (must be a string following http://semver.org constraints)"
+    end
+    @build = val
+  end
+
+
+  def to_s
+    r = "#{@major}.#{@minor}.#{patch}"
+    r << "-#{@pre}" if @pre
+    r << "+#{@build}" if @build
+    r
+  end
+
+  private
+  
+  def compare_sep(ours, theirs, nil_wins)
+    # Both nil? They're equal
+    return 0 if ours.nil? && theirs.nil?
+    # One's nil? The winner is determined by precidence
+    return nil_wins ? -1 : 1 if theirs.nil?
+    return nil_wins ? 1 : -1 if ours.nil?
+
+    our_parts = ours.split('.')
+    their_parts = theirs.split('.')
+
+    our_parts.zip(their_parts) do |a,b|
+      # b can be nil, in which case it loses
+      return 1 if b.nil?
+      # If they're both ints, convert to as such
+      # If one's an int and the other isn't, the string version of the int gets correctly compared
+      a, b = a.to_i, b.to_i if a =~ /^\d+$/ && b =~ /^\d+$/
+
+      comp = a <=> b
+      return comp unless comp == 0
+    end
+
+    # If we got this far, either they're equal (same length) or they won
+    return (our_parts.length == their_parts.length) ? 0 : -1
+  end
+end

metadata

@@ -0,0 +1,46 @@
+--- !ruby/object:Gem::Specification
+name: sem_version
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Antony Male
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-12-06 00:00:00.000000000 Z
+dependencies: []
+description: Allows you to parse and compare semantic versions, as specified by http://semver.org/.
+  Allows constraint checking e.g. >=, <, ~>
+email: antony dot mail at gmail
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/sem_version.rb
+homepage: https://github.com/canton7/sem_version
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: ! 'SemVersion: Semantic version parsing and comparison. See http://semver.org/'
+test_files: []