semantic 1.3.1 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8be7b65e62aeac78a5554d3fe5ab776f21531896
-  data.tar.gz: f07d9b1a21e1b54713a3cb6147e53d0213859b31
+  metadata.gz: 8c17513515b4ea394b9402cb707245c00a07590a
+  data.tar.gz: 884b649d9f02d0fc203081dcf863cddd61037ed7
 SHA512:
-  metadata.gz: 55558e793373d843849a13058ad77db46067046255eb266919f5089c201bbab6c535f53df692707b5781c8b7ec226d077dd2723e5ba6bb588259569075aacdc4
-  data.tar.gz: b1761377c7f2a5beb1decd3246053906c053e76e465e654a43da102fffe3e00e34dca432ff996c74301fe2472ee968eb804d00950e4f96353bc64e592805969e
+  metadata.gz: b81b25d151711e3465f512c241279e1dbebf9442c1b37601a04f5f97d91602168460b47fdbc1fd523c0f4a28d4ed0c1100fb98d66545188a3bc4e61fcdc3e811
+  data.tar.gz: b51033a0d6a106fdc7f42bfb3bf0e82a539043467124d209024f0b4a260eb16b96e940dd57084ebd253fc3fdc74fc10d63956e9de6f658bc204bcbcc4963437e

data/lib/semantic.rb

@@ -1,5 +1,5 @@
 module Semantic
-  GEM_VERSION = '1.3.1'
+  GEM_VERSION = '1.4.0'
   autoload :Version, 'semantic/version'
 end
 

data/lib/semantic/version.rb

@@ -94,6 +94,22 @@ module Semantic
       end
     end
 
+    [:major, :minor, :patch].each do |term|
+      define_method("#{term}!") { increment!(term) }
+    end
+
+    def increment!(term)
+      new_version = clone
+      new_value = send(term) + 1
+
+      new_version.send("#{term}=", new_value)
+      new_version.minor = 0 if term == :major
+      new_version.patch = 0 if term == :major || term == :minor
+      new_version.build = new_version.pre = nil
+
+      new_version
+    end
+
     private
 
     def pad_version_string version_string

data/spec/core_ext_spec.rb

@@ -0,0 +1,43 @@
+require 'spec_helper'
+require 'semantic/core_ext'
+
+describe 'Core Extensions' do
+  context "String#to_version" do
+    before(:each) do
+      @test_versions = [
+        '1.0.0',
+        '12.45.182',
+        '0.0.1-pre.1',
+        '1.0.1-pre.5+build.123.5',
+        '1.1.1+123',
+        '0.0.0+hello',
+        '1.2.3-1'
+      ]
+
+      @bad_versions = [
+        'a.b.c',
+        '1.a.3',
+        'a.3.4',
+        '5.2.a',
+        'pre3-1.5.3'
+      ]
+    end
+
+    it "extends String with a #to_version method" do
+      String.new.should respond_to(:to_version)
+    end
+
+    it "converts the String into a Version object" do
+      @test_versions.each do |v|
+        expect { v.to_version }.to_not raise_error()
+        v.to_version.should be_a(Semantic::Version)
+      end
+    end
+
+    it "raises an error on invalid strings" do
+      @bad_versions.each do |v|
+        expect { v.to_version }.to raise_error()
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,20 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  require 'semantic'
+
+  config.mock_framework = :rspec
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end

data/spec/version_spec.rb

@@ -0,0 +1,234 @@
+require 'spec_helper'
+
+describe Semantic::Version do
+  before(:each) do
+    @test_versions = [
+      '1.0.0',
+      '12.45.182',
+      '0.0.1-pre.1',
+      '1.0.1-pre.5+build.123.5',
+      '1.1.1+123',
+      '0.0.0+hello',
+      '1.2.3-1'
+    ]
+
+    @bad_versions = [
+      'a.b.c',
+      '1.a.3',
+      'a.3.4',
+      '5.2.a',
+      'pre3-1.5.3',
+      "I am not a valid semver\n0.0.0\nbut I still pass"
+    ]
+  end
+
+  context "parsing" do
+    it "parses valid SemVer versions" do
+      @test_versions.each do |v|
+        expect { Semantic::Version.new v }.to_not raise_error()
+      end
+    end
+
+    it "raises an error on invalid versions" do
+      @bad_versions.each do |v|
+        expect { Semantic::Version.new v }.to raise_error()
+      end
+    end
+
+    it "stores parsed versions in member variables" do
+      v1 = Semantic::Version.new '1.5.9'
+      v1.major.should == 1
+      v1.minor.should == 5
+      v1.patch.should == 9
+      v1.pre.should be_nil
+      v1.build.should be_nil
+
+      v2 = Semantic::Version.new '0.0.1-pre.1'
+      v2.major.should == 0
+      v2.minor.should == 0
+      v2.patch.should == 1
+      v2.pre.should == 'pre.1'
+      v2.build.should be_nil
+
+      v3 = Semantic::Version.new '1.0.1-pre.5+build.123.5'
+      v3.major.should == 1
+      v3.minor.should == 0
+      v3.patch.should == 1
+      v3.pre.should == 'pre.5'
+      v3.build.should == 'build.123.5'
+
+      v4 = Semantic::Version.new '0.0.0+hello'
+      v4.major.should == 0
+      v4.minor.should == 0
+      v4.patch.should == 0
+      v4.pre.should be_nil
+      v4.build.should == 'hello'
+    end
+  end
+
+  context "comparisons" do
+    before(:each) do
+      # These three are all semantically equivalent, according to the spec.
+      @v1_5_9_pre_1 = Semantic::Version.new '1.5.9-pre.1'
+      @v1_5_9_pre_1_build_5127 = Semantic::Version.new '1.5.9-pre.1+build.5127'
+      @v1_5_9_pre_1_build_4352 = Semantic::Version.new '1.5.9-pre.1+build.4352'
+
+      @v1_5_9 = Semantic::Version.new '1.5.9'
+      @v1_6_0 = Semantic::Version.new '1.6.0'
+    end
+
+    it "determines sort order" do
+      # The second parameter here can be a string, so we want to ensure that this kind of comparison works also.
+      (@v1_5_9_pre_1 <=> @v1_5_9_pre_1.to_s).should == 0
+
+      (@v1_5_9_pre_1 <=> @v1_5_9_pre_1_build_5127).should == 0
+      (@v1_5_9_pre_1 <=> @v1_5_9).should == -1
+      (@v1_5_9_pre_1_build_5127 <=> @v1_5_9).should == -1
+
+      @v1_5_9_pre_1_build_5127.build.should == 'build.5127'
+
+      (@v1_5_9 <=> @v1_5_9).should == 0
+
+      (@v1_5_9 <=> @v1_6_0).should == -1
+      (@v1_6_0 <=> @v1_5_9).should == 1
+      (@v1_6_0 <=> @v1_5_9_pre_1).should == 1
+      (@v1_5_9_pre_1 <=> @v1_6_0).should == -1
+
+      [@v1_5_9_pre_1, @v1_5_9_pre_1_build_5127, @v1_5_9, @v1_6_0]
+        .reverse
+        .sort
+        .should == [@v1_5_9_pre_1, @v1_5_9_pre_1_build_5127, @v1_5_9, @v1_6_0]
+    end
+
+    it "determines whether it is greater than another instance" do
+      # These should be equal, since "Build metadata SHOULD be ignored when determining version precedence".
+      # (SemVer 2.0.0-rc.2, paragraph 10 - http://www.semver.org)
+      @v1_5_9_pre_1.should_not > @v1_5_9_pre_1_build_5127
+      @v1_5_9_pre_1.should_not < @v1_5_9_pre_1_build_5127
+
+      @v1_6_0.should > @v1_5_9
+      @v1_5_9.should_not > @v1_6_0
+      @v1_5_9.should > @v1_5_9_pre_1_build_5127
+      @v1_5_9.should > @v1_5_9_pre_1
+    end
+
+    it "determines whether it is less than another instance" do
+      @v1_5_9_pre_1.should_not < @v1_5_9_pre_1_build_5127
+      @v1_5_9_pre_1_build_5127.should_not < @v1_5_9_pre_1
+      @v1_5_9_pre_1.should < @v1_5_9
+      @v1_5_9_pre_1.should < @v1_6_0
+      @v1_5_9_pre_1_build_5127.should < @v1_6_0
+      @v1_5_9.should < @v1_6_0
+    end
+
+    it "determines whether it is greater than or equal to another instance" do
+      @v1_5_9_pre_1.should >= @v1_5_9_pre_1
+      @v1_5_9_pre_1.should >= @v1_5_9_pre_1_build_5127
+      @v1_5_9_pre_1_build_5127.should >= @v1_5_9_pre_1
+      @v1_5_9.should >= @v1_5_9_pre_1
+      @v1_6_0.should >= @v1_5_9
+      @v1_5_9_pre_1_build_5127.should_not >= @v1_6_0
+    end
+
+    it "determines whether it is less than or equal to another instance" do
+      @v1_5_9_pre_1.should <= @v1_5_9_pre_1_build_5127
+      @v1_6_0.should_not <= @v1_5_9
+      @v1_5_9_pre_1_build_5127.should <= @v1_5_9_pre_1_build_5127
+      @v1_5_9.should_not <= @v1_5_9_pre_1
+    end
+
+    it "determines whether it is semantically equal to another instance" do
+      @v1_5_9_pre_1.should == @v1_5_9_pre_1.dup
+      @v1_5_9_pre_1_build_5127.should == @v1_5_9_pre_1_build_5127.dup
+
+      # "Semantically equal" is the keyword here; these are by definition not "equal" (different build), but should be treated as
+      # equal according to the spec.
+      @v1_5_9_pre_1_build_4352.should == @v1_5_9_pre_1_build_5127
+      @v1_5_9_pre_1_build_4352.should == @v1_5_9_pre_1
+    end
+
+    it "determines whether it satisfies >= style specifications" do
+      @v1_6_0.satisfies('>=1.6.0').should be true
+      @v1_6_0.satisfies('<=1.6.0').should be true
+      @v1_6_0.satisfies('>=1.5.0').should be true
+      @v1_6_0.satisfies('<=1.5.0').should_not be true
+
+      # partial / non-semver numbers after comparator are extremely common in
+      # version specifications in the wild
+
+      @v1_6_0.satisfies('>1.5').should be true
+      @v1_6_0.satisfies('<1').should_not be true
+    end
+
+    it "determines whether it satisfies * style specifications" do
+      @v1_6_0.satisfies('1.*').should be true
+      @v1_6_0.satisfies('1.6.*').should be true
+      @v1_6_0.satisfies('2.*').should_not be true
+      @v1_6_0.satisfies('1.5.*').should_not be true
+    end
+
+    it "determines whether it satisfies ~ style specifications" do
+      @v1_6_0.satisfies('~1.6').should be true
+      @v1_5_9_pre_1.satisfies('~1.5').should be true
+      @v1_6_0.satisfies('~1.5').should_not be true
+    end
+
+  end
+
+  context "type coercions" do
+    it "converts to a string" do
+      @test_versions.each do |v|
+        Semantic::Version.new(v).to_s.should == v
+      end
+    end
+
+    it "converts to an array" do
+      Semantic::Version.new('1.0.0').to_a.should == [1, 0, 0, nil, nil]
+      Semantic::Version.new('6.1.4-pre.5').to_a.should == [6, 1, 4, 'pre.5', nil]
+      Semantic::Version.new('91.6.0+build.17').to_a.should == [91, 6, 0, nil, 'build.17']
+      Semantic::Version.new('0.1.5-pre.7+build191').to_a.should == [0, 1, 5, 'pre.7', 'build191']
+    end
+
+    it "converts to a hash" do
+      Semantic::Version.new('1.0.0').to_h.should == { major: 1, minor: 0, patch: 0, pre: nil, build: nil }
+      Semantic::Version.new('6.1.4-pre.5').to_h.should == { major: 6, minor: 1, patch: 4, pre: 'pre.5', build: nil }
+      Semantic::Version.new('91.6.0+build.17').to_h.should == { major: 91, minor: 6, patch: 0, pre: nil, build: 'build.17' }
+      Semantic::Version.new('0.1.5-pre.7+build191').to_h.should == { major: 0, minor: 1, patch: 5, pre: 'pre.7', build: 'build191' }
+    end
+
+    it "aliases conversion methods" do
+      v = Semantic::Version.new('0.0.0')
+      [:to_hash, :to_array, :to_string].each { |sym| v.should respond_to(sym) }
+    end
+  end
+
+  describe '#major!' do
+    subject { described_class.new('1.2.3-pre1+build2') }
+
+    context 'changing the major term' do
+      it 'changes the major version and resets the others' do
+        subject.major!.should == '2.0.0'
+      end
+    end
+  end
+
+  describe '#minor' do
+    subject { described_class.new('1.2.3-pre1+build2') }
+
+    context 'changing the minor term' do
+      it 'changes minor term and resets patch, pre and build' do
+        subject.minor!.should == '1.3.0'
+      end
+    end
+  end
+
+  describe '#patch' do
+    subject { described_class.new('1.2.3-pre1+build2') }
+
+    context 'changing the patch term' do
+      it 'changes the patch term and resets the pre and build' do
+        subject.patch!.should == '1.2.4'
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: semantic
 version: !ruby/object:Gem::Version
-  version: 1.3.1
+  version: 1.4.0
 platform: ruby
 authors:
 - Josh Lindsey
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-09-24 00:00:00.000000000 Z
+date: 2015-01-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -51,6 +51,9 @@ files:
 - lib/semantic.rb
 - lib/semantic/core_ext.rb
 - lib/semantic/version.rb
+- spec/core_ext_spec.rb
+- spec/spec_helper.rb
+- spec/version_spec.rb
 homepage: https://github.com/jlindsey/semantic
 licenses:
 - MIT
@@ -75,5 +78,7 @@ rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
 summary: Semantic Version utility class
-test_files: []
-has_rdoc: 
+test_files:
+- spec/core_ext_spec.rb
+- spec/spec_helper.rb
+- spec/version_spec.rb