semantic_puppet 0.1.3 → 1.0.3

data/semantic_puppet.gemspec

@@ -1,6 +1,6 @@
 # -*- encoding: utf-8 -*-
 $:.push File.expand_path("../lib", __FILE__)
-require "semantic_puppet"
+require "semantic_puppet/gem_version"
 
 spec = Gem::Specification.new do |s|
   # Metadata
@@ -20,12 +20,16 @@ spec = Gem::Specification.new do |s|
   s.require_paths = ["lib"]
 
   # Dependencies
-  s.required_ruby_version = '>= 1.8.7'
+  s.required_ruby_version = '>= 1.9.3'
 
+  s.add_development_dependency "json", "~> 1.8.3" if RUBY_VERSION < '2.0'
   s.add_development_dependency "rake"
   s.add_development_dependency "rspec"
-  s.add_development_dependency "simplecov"
-  s.add_development_dependency "cane"
-  s.add_development_dependency "yard"
-  s.add_development_dependency "redcarpet"
+
+  unless RUBY_PLATFORM =~ /java/
+    s.add_development_dependency "simplecov"
+    s.add_development_dependency "cane"
+    s.add_development_dependency "yard"
+    s.add_development_dependency "redcarpet"
+  end
 end

data/spec/spec_helper.rb

@@ -8,7 +8,6 @@ if ENV['COVERAGE']
 end
 
 RSpec.configure do |config|
-  config.treat_symbols_as_metadata_keys_with_true_values = true
   config.run_all_when_everything_filtered = true
   config.filter_run :focus
 

data/spec/unit/semantic_puppet/dependency/unsatisfiable_graph_spec.rb

@@ -5,7 +5,7 @@ describe SemanticPuppet::Dependency::UnsatisfiableGraph do
 
   let(:modules) { %w[ foo bar baz ] }
   let(:graph) { double('Graph', :modules => modules) }
-  let(:instance) { described_class.new(graph) }
+  let(:instance) { described_class.new(graph, ['a']) }
 
   subject { instance }
 

data/spec/unit/semantic_puppet/dependency_spec.rb

@@ -40,27 +40,27 @@ describe SemanticPuppet::Dependency do
     end
 
     context 'with one source' do
-      let(:source) { double('Source') }
+      let(:source) { double('Source', :priority => 0) }
 
       before { SemanticPuppet::Dependency.add_source(source) }
 
       it 'queries the source for release information' do
-        source.should_receive(:fetch).with('module_name').and_return([])
+        expect(source).to receive(:fetch).with('module_name').and_return([])
 
         SemanticPuppet::Dependency.query('module_name' => '1.0.0')
       end
 
       it 'queries the source for each dependency' do
-        source.should_receive(:fetch).with('module_name').and_return([
+        expect(source).to receive(:fetch).with('module_name').and_return([
           create_release(source, 'module_name', '1.0.0', 'bar' => '1.0.0')
         ])
-        source.should_receive(:fetch).with('bar').and_return([])
+        expect(source).to receive(:fetch).with('bar').and_return([])
 
         SemanticPuppet::Dependency.query('module_name' => '1.0.0')
       end
 
       it 'queries the source for each dependency only once' do
-        source.should_receive(:fetch).with('module_name').and_return([
+        expect(source).to receive(:fetch).with('module_name').and_return([
           create_release(
             source,
             'module_name',
@@ -68,23 +68,23 @@ describe SemanticPuppet::Dependency do
             'bar' => '1.0.0', 'baz' => '0.0.2'
           )
         ])
-        source.should_receive(:fetch).with('bar').and_return([
+        expect(source).to receive(:fetch).with('bar').and_return([
           create_release(source, 'bar', '1.0.0', 'baz' => '0.0.3')
         ])
-        source.should_receive(:fetch).with('baz').once.and_return([])
+        expect(source).to receive(:fetch).with('baz').once.and_return([])
 
         SemanticPuppet::Dependency.query('module_name' => '1.0.0')
       end
 
       it 'returns a ModuleRelease with the requested dependencies' do
-        source.stub(:fetch).and_return([])
+        allow(source).to receive(:fetch).and_return([])
 
         result = SemanticPuppet::Dependency.query('foo' => '1.0.0', 'bar' => '1.0.0')
         expect(result.dependency_names).to match_array %w[ foo bar ]
       end
 
       it 'populates the returned ModuleRelease with related dependencies' do
-        source.stub(:fetch).and_return(
+        allow(source).to receive(:fetch).and_return(
           [ foo = create_release(source, 'foo', '1.0.0', 'bar' => '1.0.0') ],
           [ bar = create_release(source, 'bar', '1.0.0') ]
         )
@@ -95,7 +95,7 @@ describe SemanticPuppet::Dependency do
       end
 
       it 'populates all returned ModuleReleases with related dependencies' do
-        source.stub(:fetch).and_return(
+        allow(source).to receive(:fetch).and_return(
           [ foo = create_release(source, 'foo', '1.0.0', 'bar' => '1.0.0') ],
           [ bar = create_release(source, 'bar', '1.0.0', 'baz' => '0.1.0') ],
           [ baz = create_release(source, 'baz', '0.1.0', 'baz' => '1.0.0') ]
@@ -109,9 +109,9 @@ describe SemanticPuppet::Dependency do
     end
 
     context 'with multiple sources' do
-      let(:source1) { double('SourceOne') }
-      let(:source2) { double('SourceTwo') }
-      let(:source3) { double('SourceThree') }
+      let(:source1) { double('SourceOne', :priority => 0) }
+      let(:source2) { double('SourceTwo', :priority => 0) }
+      let(:source3) { double('SourceThree', :priority => 0) }
 
       before do
         SemanticPuppet::Dependency.add_source(source1)
@@ -120,23 +120,23 @@ describe SemanticPuppet::Dependency do
       end
 
       it 'queries each source in turn' do
-        source1.should_receive(:fetch).with('module_name').and_return([])
-        source2.should_receive(:fetch).with('module_name').and_return([])
-        source3.should_receive(:fetch).with('module_name').and_return([])
+        expect(source1).to receive(:fetch).with('module_name').and_return([])
+        expect(source2).to receive(:fetch).with('module_name').and_return([])
+        expect(source3).to receive(:fetch).with('module_name').and_return([])
 
         SemanticPuppet::Dependency.query('module_name' => '1.0.0')
       end
 
       it 'resolves all dependencies against all sources' do
-        source1.should_receive(:fetch).with('module_name').and_return([
+        expect(source1).to receive(:fetch).with('module_name').and_return([
           create_release(source1, 'module_name', '1.0.0', 'bar' => '1.0.0')
         ])
-        source2.should_receive(:fetch).with('module_name').and_return([])
-        source3.should_receive(:fetch).with('module_name').and_return([])
+        expect(source2).to receive(:fetch).with('module_name').and_return([])
+        expect(source3).to receive(:fetch).with('module_name').and_return([])
 
-        source1.should_receive(:fetch).with('bar').and_return([])
-        source2.should_receive(:fetch).with('bar').and_return([])
-        source3.should_receive(:fetch).with('bar').and_return([])
+        expect(source1).to receive(:fetch).with('bar').and_return([])
+        expect(source2).to receive(:fetch).with('bar').and_return([])
+        expect(source3).to receive(:fetch).with('bar').and_return([])
 
         SemanticPuppet::Dependency.query('module_name' => '1.0.0')
       end
@@ -147,7 +147,7 @@ describe SemanticPuppet::Dependency do
     def add_source_modules(name, versions, deps = {})
       versions = Array(versions)
       releases = versions.map { |ver| create_release(source, name, ver, deps) }
-      source.stub(:fetch).with(name).and_return(modules[name].concat(releases))
+      allow(source).to receive(:fetch).with(name).and_return(modules[name].concat(releases))
     end
 
     def subject(specs)
@@ -187,7 +187,7 @@ describe SemanticPuppet::Dependency do
         it 'returns the greatest prerelease version matching the range' do
           add_source_modules('foo', %w[ 1.0.0 1.1.0-a 1.1.0-b 2.0.0 ])
 
-          expect(foo('1.1.x')).to   eql %w[ 1.1.0-b ]
+          expect(foo('>1.1.0-a <2.0.0')).to eql %w[ 1.1.0-b ]
           expect(foo('1.1.0-a')).to eql %w[ 1.1.0-a ]
         end
       end
@@ -226,7 +226,7 @@ describe SemanticPuppet::Dependency do
 
       context 'when the dependency has no stable versions' do
         it 'returns the greatest prerelease version matching the range' do
-          add_source_modules('foo', '1.1.0', 'bar' => '1.1.x')
+          add_source_modules('foo', '1.1.0', 'bar' => '>=1.1.0-0 <1.2.0')
           add_source_modules('foo', '1.1.1', 'bar' => '1.1.0-a')
           add_source_modules('bar', %w[ 1.0.0 1.1.0-a 1.1.0-b 2.0.0 ])
 

data/spec/unit/semantic_puppet/version_range_spec.rb

@@ -4,43 +4,49 @@ require 'semantic_puppet/version'
 describe SemanticPuppet::VersionRange do
 
   describe '.parse' do
+    def self.test_expressions(expressions)
+      expressions.each do |range, vs|
+        test_range(range, vs[:to_str], vs[:includes], vs[:excludes])
+      end
+    end
+
     def self.test_range(range_list, str, includes, excludes)
       Array(range_list).each do |expr|
         example "#{expr.inspect} stringifies as #{str}" do
           range = SemanticPuppet::VersionRange.parse(expr)
-          expect(range.to_s).to eql str
+          expect(range.inspect).to eql str
         end
 
         includes.each do |vstring|
           example "#{expr.inspect} includes #{vstring}" do
             range = SemanticPuppet::VersionRange.parse(expr)
-            expect(range).to include(SemanticPuppet::Version.parse(vstring))
+            expect(range).to cover(SemanticPuppet::Version.parse(vstring))
           end
 
           example "parse(#{expr.inspect}).to_s includes #{vstring}" do
             range = SemanticPuppet::VersionRange.parse(expr)
             range = SemanticPuppet::VersionRange.parse(range.to_s)
-            expect(range).to include(SemanticPuppet::Version.parse(vstring))
+            expect(range).to cover(SemanticPuppet::Version.parse(vstring))
           end
         end
 
         excludes.each do |vstring|
           example "#{expr.inspect} excludes #{vstring}" do
             range = SemanticPuppet::VersionRange.parse(expr)
-            expect(range).to_not include(SemanticPuppet::Version.parse(vstring))
+            expect(range).to_not cover(SemanticPuppet::Version.parse(vstring))
           end
 
           example "parse(#{expr.inspect}).to_s excludes #{vstring}" do
             range = SemanticPuppet::VersionRange.parse(expr)
             range = SemanticPuppet::VersionRange.parse(range.to_s)
-            expect(range).to_not include(SemanticPuppet::Version.parse(vstring))
+            expect(range).to_not cover(SemanticPuppet::Version.parse(vstring))
           end
         end
       end
     end
 
     context 'loose version expressions' do
-      expressions = {
+      test_expressions(
         [ '1.2.3-alpha' ] => {
           :to_str   => '1.2.3-alpha',
           :includes => [ '1.2.3-alpha'  ],
@@ -48,32 +54,28 @@ describe SemanticPuppet::VersionRange do
         },
         [ '1.2.3' ] => {
           :to_str   => '1.2.3',
-          :includes => [ '1.2.3-alpha', '1.2.3' ],
-          :excludes => [ '1.2.2', '1.2.4-alpha' ],
+          :includes => [ '1.2.3' ],
+          :excludes => [ '1.2.2', '1.2.3-alpha', '1.2.4-alpha' ],
         },
         [ '1.2', '1.2.x', '1.2.X' ] => {
-          :to_str   => '1.2.x',
-          :includes => [ '1.2.0-alpha', '1.2.0', '1.2.999' ],
-          :excludes => [ '1.1.999', '1.3.0-0' ],
+          :to_str   => '>=1.2.0 <1.3.0',
+          :includes => [ '1.2.0', '1.2.999' ],
+          :excludes => [ '1.1.999', '1.2.0-alpha', '1.3.0-0' ],
         },
         [ '1', '1.x', '1.X' ] => {
-          :to_str   => '1.x',
-          :includes => [ '1.0.0-alpha', '1.999.0' ],
-          :excludes => [ '0.999.999', '2.0.0-0' ],
+          :to_str   => '>=1.0.0 <2.0.0',
+          :includes => [ '1.0.0', '1.999.0' ],
+          :excludes => [ '0.999.999', '1.0.0-alpha', '2.0.0-0' ],
         },
-      }
-
-      expressions.each do |range, vs|
-        test_range(range, vs[:to_str], vs[:includes], vs[:excludes])
-      end
+      )
     end
 
     context 'open-ended expressions' do
-      expressions = {
+      test_expressions(
         [ '>1.2.3', '> 1.2.3' ] => {
-          :to_str   => '>=1.2.4',
-          :includes => [ '1.2.4-0', '999.0.0' ],
-          :excludes => [ '1.2.3' ],
+          :to_str   => '>1.2.3',
+          :includes => [ '999.0.0' ],
+          :excludes => [ '1.2.3', '1.2.4-0' ],
         },
         [ '>1.2.3-alpha', '> 1.2.3-alpha' ] => {
           :to_str   => '>1.2.3-alpha',
@@ -83,87 +85,79 @@ describe SemanticPuppet::VersionRange do
 
         [ '>=1.2.3', '>= 1.2.3' ] => {
           :to_str   => '>=1.2.3',
-          :includes => [ '1.2.3-0', '999.0.0' ],
-          :excludes => [ '1.2.2' ],
+          :includes => [ '999.0.0' ],
+          :excludes => [ '1.2.2', '1.2.3-0' ],
         },
         [ '>=1.2.3-alpha', '>= 1.2.3-alpha' ] => {
           :to_str   => '>=1.2.3-alpha',
           :includes => [ '1.2.3-alpha', '1.2.3-alpha0', '999.0.0' ],
-          :excludes => [ '1.2.3-alph' ],
+          :excludes => [ '1.2.3-alph', '1.2.4-alpha' ],
         },
 
         [ '<1.2.3', '< 1.2.3' ] => {
           :to_str   => '<1.2.3',
-          :includes => [ '0.0.0-0', '1.2.2' ],
-          :excludes => [ '1.2.3-0', '2.0.0' ],
+          :includes => [ '0.0.0', '1.2.2' ],
+          :excludes => [ '0.0.0-0', '1.2.3-0', '2.0.0' ],
         },
         [ '<1.2.3-alpha', '< 1.2.3-alpha' ] => {
           :to_str   => '<1.2.3-alpha',
-          :includes => [ '0.0.0-0', '1.2.3-alph' ],
-          :excludes => [ '1.2.3-alpha', '2.0.0' ],
+          :includes => [ '0.0.0', '1.2.3-alph' ],
+          :excludes => [ '0.0.0-0', '1.2.3-alpha', '2.0.0' ],
         },
 
         [ '<=1.2.3', '<= 1.2.3' ] => {
-          :to_str   => '<1.2.4',
-          :includes => [ '0.0.0-0', '1.2.3' ],
-          :excludes => [ '1.2.4-0' ],
+          :to_str   => '<=1.2.3',
+          :includes => [ '0.0.0', '1.2.3' ],
+          :excludes => [ '0.0.0-0', '1.2.3-0' ],
         },
         [ '<=1.2.3-alpha', '<= 1.2.3-alpha' ] => {
           :to_str   => '<=1.2.3-alpha',
-          :includes => [ '0.0.0-0', '1.2.3-alpha' ],
-          :excludes => [ '1.2.3-alpha0', '1.2.3-alpha.0', '1.2.3-alpha'.next ],
+          :includes => [ '0.0.0', '1.2.3-alpha' ],
+          :excludes => [ '0.0.0-0', '1.2.3-alpha0', '1.2.3-alpha.0', '1.2.3-alpha'.next ],
         },
-      }
-
-      expressions.each do |range, vs|
-        test_range(range, vs[:to_str], vs[:includes], vs[:excludes])
-      end
+      )
     end
 
     context '"reasonably close" expressions' do
-      expressions = {
+      test_expressions(
         [ '~ 1', '~1' ] => {
-          :to_str   => '1.x',
-          :includes => [ '1.0.0-0', '1.999.999' ],
-          :excludes => [ '0.999.999', '2.0.0-0' ],
+          :to_str   => '>=1.0.0 <2.0.0',
+          :includes => [ '1.0.0', '1.999.999' ],
+          :excludes => [ '0.999.999', '1.0.0-0', '2.0.0-0' ],
         },
         [ '~ 1.2', '~1.2' ] => {
-          :to_str   => '1.2.x',
-          :includes => [ '1.2.0-0', '1.2.999' ],
-          :excludes => [ '1.1.999', '1.3.0-0' ],
+          :to_str   => '>=1.2.0 <1.3.0',
+          :includes => [ '1.2.0', '1.2.999' ],
+          :excludes => [ '1.1.999', '1.2.0-0', '1.3.0-0' ],
         },
         [ '~ 1.2.3', '~1.2.3' ] => {
           :to_str   => '>=1.2.3 <1.3.0',
-          :includes => [ '1.2.3-0', '1.2.5' ],
-          :excludes => [ '1.2.2', '1.3.0-0' ],
+          :includes => [ '1.2.3', '1.2.5' ],
+          :excludes => [ '1.2.2', '1.2.3-0', '1.3.0-0' ],
         },
         [ '~ 1.2.3-alpha', '~1.2.3-alpha' ] => {
-          :to_str   => '>=1.2.3-alpha <1.2.4',
+          :to_str   => '>=1.2.3-alpha <1.3.0',
           :includes => [ '1.2.3-alpha', '1.2.3' ],
           :excludes => [ '1.2.3-alph', '1.2.4-0' ],
         },
-      }
-
-      expressions.each do |range, vs|
-        test_range(range, vs[:to_str], vs[:includes], vs[:excludes])
-      end
+      )
     end
 
     context 'inclusive range expressions' do
-      expressions = {
+      test_expressions(
         '1.2.3 - 1.3.4' => {
-          :to_str   => '>=1.2.3 <1.3.5',
-          :includes => [ '1.2.3-0', '1.3.4' ],
-          :excludes => [ '1.2.2', '1.3.5-0' ],
+          :to_str   => '>=1.2.3 <=1.3.4',
+          :includes => [ '1.2.3', '1.3.4' ],
+          :excludes => [ '1.2.2', '1.2.3-0', '1.3.5-0' ],
         },
         '1.2.3 - 1.3.4-alpha' => {
           :to_str   => '>=1.2.3 <=1.3.4-alpha',
-          :includes => [ '1.2.3-0', '1.3.4-alpha' ],
-          :excludes => [ '1.2.2', '1.3.4-alpha0', '1.3.5' ],
+          :includes => [ '1.2.3', '1.3.4-alpha' ],
+          :excludes => [ '1.2.2', '1.2.3-0', '1.3.4-alpha0', '1.3.5' ],
         },
 
         '1.2.3-alpha - 1.3.4' => {
-          :to_str   => '>=1.2.3-alpha <1.3.5',
+          :to_str   => '>=1.2.3-alpha <=1.3.4',
           :includes => [ '1.2.3-alpha', '1.3.4' ],
           :excludes => [ '1.2.3-alph', '1.3.5-0' ],
         },
@@ -172,39 +166,109 @@ describe SemanticPuppet::VersionRange do
           :includes => [ '1.2.3-alpha', '1.3.4-alpha' ],
           :excludes => [ '1.2.3-alph', '1.3.4-alpha0', '1.3.5' ],
         },
-      }
-
-      expressions.each do |range, vs|
-        test_range(range, vs[:to_str], vs[:includes], vs[:excludes])
-      end
+      )
     end
 
     context 'unioned expressions' do
-      expressions = {
+      test_expressions(
         [ '1.2 <1.2.5' ] => {
           :to_str   => '>=1.2.0 <1.2.5',
-          :includes => [ '1.2.0-0', '1.2.4' ],
-          :excludes => [ '1.1.999', '1.2.5-0', '1.9.0' ],
+          :includes => [ '1.2.0', '1.2.4' ],
+          :excludes => [ '1.1.999', '1.2.0-0', '1.2.5-0', '1.9.0' ],
         },
         [ '1 <=1.2.5' ] => {
-          :to_str   => '>=1.0.0 <1.2.6',
-          :includes => [ '1.0.0-0', '1.2.5' ],
-          :excludes => [ '0.999.999', '1.2.6-0', '1.9.0' ],
+          :to_str   => '>=1.0.0 <=1.2.5',
+          :includes => [ '1.0.0', '1.2.5' ],
+          :excludes => [ '0.999.999', '1.0.0-0', '1.2.6-0', '1.9.0' ],
         },
         [ '>1.0.0 >2.0.0 >=3.0.0 <5.0.0' ] => {
           :to_str   => '>=3.0.0 <5.0.0',
-          :includes => [ '3.0.0-0', '4.999.999' ],
-          :excludes => [ '2.999.999', '5.0.0-0' ],
+          :includes => [ '3.0.0', '4.999.999' ],
+          :excludes => [ '2.999.999', '3.0.0-0', '5.0.0-0' ],
         },
         [ '<1.0.0 >2.0.0' ] => {
           :to_str   => '<0.0.0',
           :includes => [  ],
-          :excludes => [ '0.0.0-0' ],
+          :excludes => [ '0.0.0-0', '0.0.0' ],
         },
-      }
+      )
+    end
 
-      expressions.each do |range, vs|
-        test_range(range, vs[:to_str], vs[:includes], vs[:excludes])
+    context 'ored expressions' do
+      context 'overlapping' do
+        test_expressions(
+          [ '>=1.2.3 || 1.2.5' ] => {
+            :to_str   => '>=1.2.3',
+            :includes => [ '1.2.3', '1.2.4' ],
+            :excludes => [ '1.2.3-0', '1.2.4-0' ],
+          },
+          [ '>=1.2.3 <=1.2.5 || >=1.2.5 <1.3.0' ] => {
+            :to_str   => '>=1.2.3 <1.3.0',
+            :includes => [ '1.2.3', '1.2.6' ],
+            :excludes => [ '1.2.3-0', '1.2.6-0' ],
+          },
+        )
+      end
+
+      context 'adjacent' do
+        test_expressions(
+          [ '1.2.3 || 1.2.4 || 1.2.5' ] => {
+            :to_str   => '>=1.2.3 <=1.2.5',
+            :includes => [ '1.2.3', '1.2.5' ],
+            :excludes => [ '1.2.3-0', '1.2.5-0' ],
+          },
+          [ '>=1.2.3 <1.2.5 || >=1.2.5 <1.3.0' ] => {
+            :to_str   => '>=1.2.3 <1.3.0',
+            :includes => [ '1.2.3', '1.2.6' ],
+            :excludes => [ '1.2.3-0', '1.2.6-0' ],
+          },
+        )
+
+        let(:range) { SemanticPuppet::VersionRange.parse('>=1.2.3 <1.2.5 || >=1.2.5 <1.3.0') }
+
+        it 'returns expected begin' do
+          expect(range.begin.to_s).to eql('1.2.3')
+        end
+
+        it 'returns nil on end' do
+          expect(range.end.to_s).to eql('1.3.0')
+        end
+
+        it 'returns nil on exclude_begin?' do
+          expect(range.exclude_begin?).to be_falsey
+        end
+
+        it 'returns nil on exclude_end?' do
+          expect(range.exclude_end?).to be_truthy
+        end
+      end
+
+      context 'non-overlapping' do
+        test_expressions(
+          [ '1.2.3 || 1.2.5' ] => {
+            :to_str   => '1.2.3 || 1.2.5',
+            :includes => [ '1.2.3', '1.2.5' ],
+            :excludes => [ '1.2.4', '1.2.3-0', '1.2.5-0' ],
+          },
+        )
+
+        let(:range) { SemanticPuppet::VersionRange.parse('1.2.3 || 1.2.5') }
+
+        it 'returns nil on begin' do
+          expect(range.begin).to be_nil
+        end
+
+        it 'returns nil on end' do
+          expect(range.end).to be_nil
+        end
+
+        it 'returns nil on exclude_begin?' do
+          expect(range.exclude_begin?).to be_nil
+        end
+
+        it 'returns nil on exclude_end?' do
+          expect(range.exclude_end?).to be_nil
+        end
       end
     end
 
@@ -304,4 +368,329 @@ describe SemanticPuppet::VersionRange do
     end
   end
 
+  context 'The version' do
+    def below(version, range)
+      version = SemanticPuppet::Version.parse(version)
+      range = SemanticPuppet::VersionRange.parse(range)
+      !range.include?(version) && range.ranges.all? { |part| part.exclude_begin? ? part.begin >= version : part.begin > version }
+    end
+
+    def above(version, range)
+      version = SemanticPuppet::Version.parse(version)
+      range = SemanticPuppet::VersionRange.parse(range)
+      !range.include?(version) && range.ranges.all? { |part| part.exclude_end? ? part.end <= version.to_stable : part.end < version.to_stable }
+    end
+
+    [
+      ['~1.2.2', '1.3.0'],
+      ['~0.6.1-1', '0.7.1-1'],
+      ['1.0.0 - 2.0.0', '2.0.1'],
+      ['1.0.0', '1.0.1-beta1'],
+      ['1.0.0', '2.0.0'],
+      ['<=2.0.0', '2.1.1'],
+      ['<=2.0.0', '3.2.9'],
+      ['<2.0.0', '2.0.0'],
+      ['0.1.20 || 1.2.4', '1.2.5'],
+      ['2.x.x', '3.0.0'],
+      ['1.2.x', '1.3.0'],
+      ['1.2.x || 2.x', '3.0.0'],
+      ['2.*.*', '5.0.1'],
+      ['1.2.*', '1.3.3'],
+      ['1.2.* || 2.*', '4.0.0'],
+      ['2', '3.0.0'],
+      ['2.3', '2.4.2'],
+      ['~2.4', '2.5.0'], # >=2.4.0 <2.5.0
+      ['~2.4', '2.5.5'],
+      ['~>3.2.1', '3.3.0'], # >=3.2.1 <3.3.0
+      ['~1', '2.2.3'], # >=1.0.0 <2.0.0
+      ['~>1', '2.2.4'],
+      ['~> 1', '3.2.3'],
+      ['~1.0', '1.1.2'], # >=1.0.0 <1.1.0
+      ['~ 1.0', '1.1.0'],
+      ['<1.2', '1.2.0'],
+      ['< 1.2', '1.2.1'],
+      ['1', '2.0.0-beta'],
+      ['~v0.5.4-pre', '0.6.0'],
+      ['~v0.5.4-pre', '0.6.1-pre'],
+      ['=0.7.x', '0.8.0'],
+      ['=0.7.x', '0.8.0-asdf'],
+      ['<0.7.x', '0.7.0'],
+      ['~1.2.2', '1.3.0'],
+      ['1.0.0 - 2.0.0', '2.2.3'],
+      ['1.0.0', '1.0.1'],
+      ['<=2.0.0', '3.0.0'],
+      ['<=2.0.0', '2.9999.9999'],
+      ['<=2.0.0', '2.2.9'],
+      ['<2.0.0', '2.9999.9999'],
+      ['<2.0.0', '2.2.9'],
+      ['2.x.x', '3.1.3'],
+      ['1.2.x', '1.3.3'],
+      ['1.2.x || 2.x', '3.1.3'],
+      ['2.*.*', '3.1.3'],
+      ['1.2.*', '1.3.3'],
+      ['1.2.* || 2.*', '3.1.3'],
+      ['2', '3.1.2'],
+      ['2.3', '2.4.1'],
+      ['~2.4', '2.5.0'], # >=2.4.0 <2.5.0
+      ['~>3.2.1', '3.3.2'], # >=3.2.1 <3.3.0
+      ['~1', '2.2.3'], # >=1.0.0 <2.0.0
+      ['~>1', '2.2.3'],
+      ['~1.0', '1.1.0'], # >=1.0.0 <1.1.0
+      ['<1', '1.0.0'],
+      ['1', '2.0.0-beta'],
+      ['<1', '1.0.0-beta'],
+      ['< 1', '1.0.0-beta'],
+      ['=0.7.x', '0.8.2'],
+      ['<0.7.x', '0.7.2']
+    ].each do |tuple|
+      it "#{tuple[1]} should be above range #{tuple[0]}" do
+        expect(above(tuple[1], tuple[0])).to be_truthy
+      end
+    end
+
+    [
+      ['~0.6.1-1', '0.6.1-1'],
+      ['1.0.0 - 2.0.0', '1.2.3'],
+      ['1.0.0 - 2.0.0', '0.9.9'],
+      ['1.0.0', '1.0.0'],
+      ['>=*', '0.2.4'],
+      ['', '1.0.0'],
+      ['*', '1.2.3'],
+      ['*', '1.2.3-foo'],
+      ['>=1.0.0', '1.0.0'],
+      ['>=1.0.0', '1.0.1'],
+      ['>=1.0.0', '1.1.0'],
+      ['>1.0.0', '1.0.1'],
+      ['>1.0.0', '1.1.0'],
+      ['<=2.0.0', '2.0.0'],
+      ['<=2.0.0', '1.9999.9999'],
+      ['<=2.0.0', '0.2.9'],
+      ['<2.0.0', '1.9999.9999'],
+      ['<2.0.0', '0.2.9'],
+      ['>= 1.0.0', '1.0.0'],
+      ['>=  1.0.0', '1.0.1'],
+      ['>=   1.0.0', '1.1.0'],
+      ['> 1.0.0', '1.0.1'],
+      ['>  1.0.0', '1.1.0'],
+      ['<=   2.0.0', '2.0.0'],
+      ['<= 2.0.0', '1.9999.9999'],
+      ['<=  2.0.0', '0.2.9'],
+      ['<    2.0.0', '1.9999.9999'],
+      ["<\t2.0.0", '0.2.9'],
+      ['>=0.1.97', '0.1.97'],
+      ['>=0.1.97', '0.1.97'],
+      ['0.1.20 || 1.2.4', '1.2.4'],
+      ['0.1.20 || >1.2.4', '1.2.4'],
+      ['0.1.20 || 1.2.4', '1.2.3'],
+      ['0.1.20 || 1.2.4', '0.1.20'],
+      ['>=0.2.3 || <0.0.1', '0.0.0'],
+      ['>=0.2.3 || <0.0.1', '0.2.3'],
+      ['>=0.2.3 || <0.0.1', '0.2.4'],
+      ['||', '1.3.4'],
+      ['2.x.x', '2.1.3'],
+      ['1.2.x', '1.2.3'],
+      ['1.2.x || 2.x', '2.1.3'],
+      ['1.2.x || 2.x', '1.2.3'],
+      ['x', '1.2.3'],
+      ['2.*.*', '2.1.3'],
+      ['1.2.*', '1.2.3'],
+      ['1.2.* || 2.*', '2.1.3'],
+      ['1.2.* || 2.*', '1.2.3'],
+      ['1.2.* || 2.*', '1.2.3'],
+      ['*', '1.2.3'],
+      ['2', '2.1.2'],
+      ['2.3', '2.3.1'],
+      ['~2.4', '2.4.0'], # >=2.4.0 <2.5.0
+      ['~2.4', '2.4.5'],
+      ['~>3.2.1', '3.2.2'], # >=3.2.1 <3.3.0
+      ['~1', '1.2.3'], # >=1.0.0 <2.0.0
+      ['~>1', '1.2.3'],
+      ['~> 1', '1.2.3'],
+      ['~1.0', '1.0.2'], # >=1.0.0 <1.1.0
+      ['~ 1.0', '1.0.2'],
+      ['>=1', '1.0.0'],
+      ['>= 1', '1.0.0'],
+      ['<1.2', '1.1.1'],
+      ['< 1.2', '1.1.1'],
+      ['1', '1.0.0-beta'],
+      ['~v0.5.4-pre', '0.5.5'],
+      ['~v0.5.4-pre', '0.5.4'],
+      ['=0.7.x', '0.7.2'],
+      ['>=0.7.x', '0.7.2'],
+      ['=0.7.x', '0.7.0-asdf'],
+      ['>=0.7.x', '0.7.0-asdf'],
+      ['<=0.7.x', '0.6.2'],
+      ['>0.2.3 >0.2.4 <=0.2.5', '0.2.5'],
+      ['>=0.2.3 <=0.2.4', '0.2.4'],
+      ['1.0.0 - 2.0.0', '2.0.0'],
+      ['^1', '0.0.0-0'],
+      ['^3.0.0', '2.0.0'],
+      ['^1.0.0 || ~2.0.1', '2.0.0'],
+      ['^0.1.0 || ~3.0.1 || 5.0.0', '3.2.0'],
+      ['^0.1.0 || ~3.0.1 || 5.0.0', '1.0.0-beta'],
+      ['^0.1.0 || ~3.0.1 || 5.0.0', '5.0.0-0'],
+      ['^0.1.0 || ~3.0.1 || >4 <=5.0.0', '3.5.0']
+    ].each do |tuple|
+      it "#{tuple[1]} should not be above range #{tuple[0]}(#{SemanticPuppet::VersionRange.parse(tuple[0]).inspect})" do
+        expect(above(tuple[1], tuple[0])).to be_falsey
+      end
+    end
+
+    [
+      ['~1.2.2', '1.2.1'],
+      ['~0.6.1-1', '0.6.1-0'],
+      ['1.0.0 - 2.0.0', '0.0.1'],
+      ['1.0.0-beta.2', '1.0.0-beta.1'],
+      ['1.0.0', '0.0.0'],
+      ['>=2.0.0', '1.1.1'],
+      ['>=2.0.0', '1.2.9'],
+      ['>2.0.0', '2.0.0'],
+      ['0.1.20 || 1.2.4', '0.1.5'],
+      ['2.x.x', '1.0.0'],
+      ['1.2.x', '1.1.0'],
+      ['1.2.x || 2.x', '1.0.0'],
+      ['2.*.*', '1.0.1'],
+      ['1.2.*', '1.1.3'],
+      ['1.2.* || 2.*', '1.1.9999'],
+      ['2', '1.0.0'],
+      ['2.3', '2.2.2'],
+      ['~2.4', '2.3.0'], # >=2.4.0 <2.5.0
+      ['~2.4', '2.3.5'],
+      ['~>3.2.1', '3.2.0'], # >=3.2.1 <3.3.0
+      ['~1', '0.2.3'], # >=1.0.0 <2.0.0
+      ['~>1', '0.2.4'],
+      ['~> 1', '0.2.3'],
+      ['~1.0', '0.1.2'], # >=1.0.0 <1.1.0
+      ['~ 1.0', '0.1.0'],
+      ['>1.2', '1.2.0'],
+      ['> 1.2', '1.2.1'],
+      ['1', '0.0.0-beta'],
+      ['~v0.5.4-pre', '0.5.4-alpha'],
+      ['~v0.5.4-pre', '0.5.4-alpha'],
+      ['=0.7.x', '0.6.0'],
+      ['=0.7.x', '0.6.0-asdf'],
+      ['>=0.7.x', '0.6.0'],
+      ['~1.2.2', '1.2.1'],
+      ['1.0.0 - 2.0.0', '0.2.3'],
+      ['1.0.0', '0.0.1'],
+      ['>=2.0.0', '1.0.0'],
+      ['>=2.0.0', '1.9999.9999'],
+      ['>=2.0.0', '1.2.9'],
+      ['>2.0.0', '2.0.0'],
+      ['>2.0.0', '1.2.9'],
+      ['2.x.x', '1.1.3'],
+      ['1.2.x', '1.1.3'],
+      ['1.2.x || 2.x', '1.1.3'],
+      ['2.*.*', '1.1.3'],
+      ['1.2.*', '1.1.3'],
+      ['1.2.* || 2.*', '1.1.3'],
+      ['2', '1.9999.9999'],
+      ['2.3', '2.2.1'],
+      ['~2.4', '2.3.0'], # >=2.4.0 <2.5.0
+      ['~>3.2.1', '2.3.2'], # >=3.2.1 <3.3.0
+      ['~1', '0.2.3'], # >=1.0.0 <2.0.0
+      ['~>1', '0.2.3'],
+      ['~1.0', '0.0.0'], # >=1.0.0 <1.1.0
+      ['>1', '1.0.0'],
+      ['2', '1.0.0-beta'],
+      ['>1', '1.0.0-beta'],
+      ['> 1', '1.0.0-beta'],
+      ['=0.7.x', '0.6.2'],
+      ['=0.7.x', '0.7.0-asdf'],
+      ['^1', '1.0.0-0'],
+      ['>=0.7.x', '0.7.0-asdf'],
+      ['1', '1.0.0-beta'],
+      ['>=0.7.x', '0.6.2']
+    ].each do |tuple|
+      it "#{tuple[1]} should be below range #{tuple[0]}" do
+        expect(below(tuple[1], tuple[0])).to be_truthy
+      end
+    end
+
+    [
+      ['~ 1.0', '1.1.0'],
+      ['~0.6.1-1', '0.6.1-1'],
+      ['1.0.0 - 2.0.0', '1.2.3'],
+      ['1.0.0 - 2.0.0', '2.9.9'],
+      ['1.0.0', '1.0.0'],
+      ['>=*', '0.2.4'],
+      ['', '1.0.0'],
+      ['*', '1.2.3'],
+      ['>=1.0.0', '1.0.0'],
+      ['>=1.0.0', '1.0.1'],
+      ['>=1.0.0', '1.1.0'],
+      ['>1.0.0', '1.0.1'],
+      ['>1.0.0', '1.1.0'],
+      ['<=2.0.0', '2.0.0'],
+      ['<=2.0.0', '1.9999.9999'],
+      ['<=2.0.0', '0.2.9'],
+      ['<2.0.0', '1.9999.9999'],
+      ['<2.0.0', '0.2.9'],
+      ['>= 1.0.0', '1.0.0'],
+      ['>=  1.0.0', '1.0.1'],
+      ['>=   1.0.0', '1.1.0'],
+      ['> 1.0.0', '1.0.1'],
+      ['>  1.0.0', '1.1.0'],
+      ['<=   2.0.0', '2.0.0'],
+      ['<= 2.0.0', '1.9999.9999'],
+      ['<=  2.0.0', '0.2.9'],
+      ['<    2.0.0', '1.9999.9999'],
+      ["<\t2.0.0", '0.2.9'],
+      ['>=0.1.97', '0.1.97'],
+      ['0.1.20 || 1.2.4', '1.2.4'],
+      ['0.1.20 || >1.2.4', '1.2.4'],
+      ['0.1.20 || 1.2.4', '1.2.3'],
+      ['0.1.20 || 1.2.4', '0.1.20'],
+      ['>=0.2.3 || <0.0.1', '0.0.0'],
+      ['>=0.2.3 || <0.0.1', '0.2.3'],
+      ['>=0.2.3 || <0.0.1', '0.2.4'],
+      ['||', '1.3.4'],
+      ['2.x.x', '2.1.3'],
+      ['1.2.x', '1.2.3'],
+      ['1.2.x || 2.x', '2.1.3'],
+      ['1.2.x || 2.x', '1.2.3'],
+      ['x', '1.2.3'],
+      ['2.*.*', '2.1.3'],
+      ['1.2.*', '1.2.3'],
+      ['1.2.* || 2.*', '2.1.3'],
+      ['1.2.* || 2.*', '1.2.3'],
+      ['1.2.* || 2.*', '1.2.3'],
+      ['*', '1.2.3'],
+      ['2', '2.1.2'],
+      ['2.3', '2.3.1'],
+      ['~2.4', '2.4.0'], # >=2.4.0 <2.5.0
+      ['~2.4', '2.4.5'],
+      ['~>3.2.1', '3.2.2'], # >=3.2.1 <3.3.0
+      ['~1', '1.2.3'], # >=1.0.0 <2.0.0
+      ['~>1', '1.2.3'],
+      ['~> 1', '1.2.3'],
+      ['~1.0', '1.0.2'], # >=1.0.0 <1.1.0
+      ['~ 1.0', '1.0.2'],
+      ['>=1', '1.0.0'],
+      ['>= 1', '1.0.0'],
+      ['<1.2', '1.1.1'],
+      ['< 1.2', '1.1.1'],
+      ['~v0.5.4-pre', '0.5.5'],
+      ['~v0.5.4-pre', '0.5.4'],
+      ['=0.7.x', '0.7.2'],
+      ['>=0.7.x', '0.7.2'],
+      ['<=0.7.x', '0.6.2'],
+      ['>0.2.3 >0.2.4 <=0.2.5', '0.2.5'],
+      ['>=0.2.3 <=0.2.4', '0.2.4'],
+      ['1.0.0 - 2.0.0', '2.0.0'],
+      ['^3.0.0', '4.0.0'],
+      ['^1.0.0 || ~2.0.1', '2.0.0'],
+      ['^0.1.0 || ~3.0.1 || 5.0.0', '3.2.0'],
+      ['^0.1.0 || ~3.0.1 || 5.0.0', '1.0.0-beta'],
+      ['^0.1.0 || ~3.0.1 || 5.0.0', '5.0.0-0'],
+      ['^0.1.0 || ~3.0.1 || >4 <=5.0.0', '3.5.0'],
+      ['^1.0.0-alpha', '1.0.0-beta'],
+      ['~1.0.0-alpha', '1.0.0-beta'],
+      ['=0.1.0', '1.0.0']
+    ].each do |tuple|
+      it "#{tuple[1]} should not be below range #{tuple[0]}" do
+        expect(below(tuple[1], tuple[0])).to be_falsey
+      end
+    end
+  end
 end