spectus 1.1.1 → 2.0.0

data/lib/spectus/requirement_level/high.rb

@@ -0,0 +1,36 @@
+require_relative File.join '..', 'sandbox'
+
+module Spectus
+  # Contains requirement levels.
+  #
+  module RequirementLevel
+    # _High_ requirement level.
+    #
+    class High < BasicObject
+      # Initialize the requirement level class.
+      #
+      # @param [Hash] definition
+      # @param [Boolean] negate
+      def initialize(definition, negate = false)
+        @definition = definition
+        @negate     = negate
+      end
+
+      # Evaluate the expectation with the passed block.
+      #
+      # @return [Boolean] report if the expectation is true or false.
+      def pass?(&actual)
+        sandbox(&actual).pass?(@negate)
+      end
+
+      protected
+
+      # Run the actual block against the definition.
+      #
+      # @return [Boolean] report if the expectation is true or false.
+      def sandbox(&actual)
+        Sandbox.new(@definition, &actual)
+      end
+    end
+  end
+end

data/lib/spectus/requirement_level/low.rb

@@ -0,0 +1,22 @@
+require_relative 'medium'
+
+module Spectus
+  # Contains requirement levels.
+  #
+  module RequirementLevel
+    # _Low_ requirement level.
+    #
+    class Low < Medium
+      # Evaluate the expectation with the passed block.
+      #
+      # @return [Boolean] report if the expectation is true or false.
+      def pass?(&actual)
+        if sandbox(&actual).exception.class.equal?(::NoMethodError)
+          true
+        else
+          super
+        end
+      end
+    end
+  end
+end

data/lib/spectus/requirement_level/medium.rb

@@ -0,0 +1,22 @@
+require_relative 'high'
+
+module Spectus
+  # Contains requirement levels.
+  #
+  module RequirementLevel
+    # _Medium_ requirement level.
+    #
+    class Medium < High
+      # Evaluate the expectation with the passed block.
+      #
+      # @return [Boolean] report if the expectation is true or false.
+      def pass?(&actual)
+        if super
+          true
+        else
+          sandbox(&actual).exception.nil?
+        end
+      end
+    end
+  end
+end

data/lib/spectus/sandbox.rb

@@ -0,0 +1,31 @@
+require 'expect'
+
+module Spectus
+  # This class evaluate the expectation with the passed block.
+  #
+  class Sandbox < BasicObject
+    attr_reader :exception, :got
+
+    # Execute the untested code from the passed block against the definition.
+    #
+    # @param [Hash] definition
+    def initialize(definition, &actual)
+      @got = ::Expect.this(&actual).to(definition)
+    rescue => e
+      @exception = e
+    end
+
+    # Return the result as a positive or a negative assertion.
+    #
+    # @param [Boolean] negate
+    #
+    # @return [Boolean] Report if the test was true or false.
+    def pass?(negate)
+      if defined?(@exception)
+        false
+      else
+        negate ^ @got
+      end
+    end
+  end
+end

data/spectus.gemspec

@@ -2,25 +2,29 @@ Gem::Specification.new do |spec|
   spec.name          = 'spectus'
   spec.version       = File.read('VERSION.semver')
   spec.authors       = ['Cyril Wack']
-  spec.email         = ['cyril@sashite.com']
-  spec.summary       = %q{Expectation library.}
-  spec.description   = %q{Expectation library with some matchers for Ruby.}
+  spec.email         = ['contact@cyril.email']
+
+  spec.summary       = 'Expectation library with requirement levels.'
+  spec.description   = 'Expectation library with RFC 2119\'s requirement ' \
+                       'levels, and some matchers for Ruby.'
   spec.homepage      = 'https://github.com/fixrb/spectus'
   spec.license       = 'MIT'
 
-  spec.files         = `git ls-files -z`.split("\x0")
-  spec.test_files    = spec.files.grep(%r{^test/})
+  spec.files = `git ls-files -z`.split("\x0").reject { |f| f.match(/^test\//) }
+  spec.executables   = spec.files.grep(/^exe\//) { |f| File.basename(f) }
   spec.require_paths = ['lib']
-  spec.required_ruby_version = '>= 2.0.0'
 
-  spec.add_development_dependency 'bundler',    '~> 1.7'
+  spec.add_dependency 'expect',                 '~> 0.0.4'
+
+  spec.add_development_dependency 'bundler',    '~> 1.8'
   spec.add_development_dependency 'rake',       '~> 10.0'
   spec.add_development_dependency 'yard',       '~> 0.8'
-  spec.add_development_dependency 'coveralls',  '~> 0.7'
+  spec.add_development_dependency 'simplecov',  '~> 0.9.1'
+  spec.add_development_dependency 'rubocop',    '~> 0.29'
 
-  private_key = File.expand_path '~/.gemcert/spectus-gem-private_key.pem'
+  private_key = File.expand_path '~/.gem/spectus-gem-private_key.pem'
   if File.exist? private_key
     spec.signing_key = private_key
-    spec.cert_chain  = ['spectus.pem']
+    spec.cert_chain  = ['spectus-gem-public_cert.pem']
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: spectus
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 2.0.0
 platform: ruby
 authors:
 - Cyril Wack
@@ -30,22 +30,36 @@ cert_chain:
   zeYBFLJQAl0AQPaGujsG5tssIabiNy1ryydKAjWkNDxqLgvtwST3L0Qr9UQFQgoA
   O2Rl8PjSD+2P9XE7T2x1xQ==
   -----END CERTIFICATE-----
-date: 2014-10-19 00:00:00.000000000 Z
+date: 2015-02-14 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: expect
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.4
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '1.8'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '1.8'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -75,73 +89,60 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0.8'
 - !ruby/object:Gem::Dependency
-  name: coveralls
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+- !ruby/object:Gem::Dependency
+  name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.29'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.7'
-description: Expectation library with some matchers for Ruby.
+        version: '0.29'
+description: Expectation library with RFC 2119's requirement levels, and some matchers
+  for Ruby.
 email:
-- cyril@sashite.com
+- contact@cyril.email
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".coveralls.yml"
 - ".gitignore"
 - ".travis.yml"
 - ".yardopts"
+- CODE_OF_CONDUCT.md
 - Gemfile
 - LICENSE.md
 - README.md
 - Rakefile
 - VERSION.semver
-- example/duck/README.md
-- example/duck/app.rb
-- example/duck/lib.rb
-- example/duck/test.rb
+- bin/console
+- bin/setup
 - lib/spectus.rb
-- lib/spectus/dsl.rb
 - lib/spectus/expectation_target.rb
-- lib/spectus/matcher.rb
-- lib/spectus/matcher/eql.rb
-- lib/spectus/matcher/equal.rb
-- lib/spectus/matcher/match.rb
-- lib/spectus/matcher/raise_exception.rb
-- lib/spectus/version.rb
+- lib/spectus/requirement_level/high.rb
+- lib/spectus/requirement_level/low.rb
+- lib/spectus/requirement_level/medium.rb
+- lib/spectus/sandbox.rb
+- spectus-gem-public_cert.pem
 - spectus.gemspec
-- spectus.pem
-- test/helper_test.rb
-- test/spectus/helper_test.rb
-- test/spectus/matcher/built_in/helper_test.rb
-- test/spectus/matcher/built_in/test_eql.rb
-- test/spectus/matcher/built_in/test_equal.rb
-- test/spectus/matcher/built_in/test_match.rb
-- test/spectus/matcher/built_in/test_raise_exception.rb
-- test/spectus/matcher/custom/be_prime/helper_test.rb
-- test/spectus/matcher/custom/be_prime/test_be_prime.rb
-- test/spectus/matcher/custom/be_the_answer/helper_test.rb
-- test/spectus/matcher/custom/be_the_answer/test_be_the_answer.rb
-- test/spectus/matcher/custom/helper_test.rb
-- test/spectus/matcher/custom/start_with/helper_test.rb
-- test/spectus/matcher/custom/start_with/test_start_with.rb
-- test/spectus/matcher/helper_test.rb
-- test/spectus/test_dsl.rb
-- test/spectus/test_matcher.rb
-- test/spectus/test_version.rb
-- test/support.rb
-- test/support/coverage.rb
-- test/support/env.rb
-- test/support/immutable.rb
-- test/support/presenter.rb
 homepage: https://github.com/fixrb/spectus
 licenses:
 - MIT
@@ -154,7 +155,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.0.0
+      version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -162,32 +163,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.4.5
 signing_key: 
 specification_version: 4
-summary: Expectation library.
-test_files:
-- test/helper_test.rb
-- test/spectus/helper_test.rb
-- test/spectus/matcher/built_in/helper_test.rb
-- test/spectus/matcher/built_in/test_eql.rb
-- test/spectus/matcher/built_in/test_equal.rb
-- test/spectus/matcher/built_in/test_match.rb
-- test/spectus/matcher/built_in/test_raise_exception.rb
-- test/spectus/matcher/custom/be_prime/helper_test.rb
-- test/spectus/matcher/custom/be_prime/test_be_prime.rb
-- test/spectus/matcher/custom/be_the_answer/helper_test.rb
-- test/spectus/matcher/custom/be_the_answer/test_be_the_answer.rb
-- test/spectus/matcher/custom/helper_test.rb
-- test/spectus/matcher/custom/start_with/helper_test.rb
-- test/spectus/matcher/custom/start_with/test_start_with.rb
-- test/spectus/matcher/helper_test.rb
-- test/spectus/test_dsl.rb
-- test/spectus/test_matcher.rb
-- test/spectus/test_version.rb
-- test/support.rb
-- test/support/coverage.rb
-- test/support/env.rb
-- test/support/immutable.rb
-- test/support/presenter.rb
+summary: Expectation library with requirement levels.
+test_files: []
 has_rdoc: 

data/.coveralls.yml

@@ -1 +0,0 @@
-service_name: travis-ci

data/example/duck/README.md

@@ -1,6 +0,0 @@
-# Duck example
-
-```bash
-$ ./test.rb
-I call that #<Duck:0x007f84cc8174c0> a duck.
-```

data/example/duck/app.rb

@@ -1,3 +0,0 @@
-require_relative 'lib'
-
-@bird = Duck.new

data/example/duck/lib.rb

@@ -1,13 +0,0 @@
-class Duck
-  def walks
-    "Klop klop!"
-  end
-
-  def swims
-    "Swoosh..."
-  end
-
-  def quacks
-    puts "Quaaaaaack!"
-  end
-end

data/example/duck/test.rb

@@ -1,43 +0,0 @@
-#!/usr/bin/env ruby -w
-
-require_relative 'app'
-
-require_relative '../../lib/spectus'
-
-extend Spectus::DSL
-
-# Let's define the custom matcher `capture_stdout`.
-require 'stringio'
-module Spectus
-  module Matcher
-    class CaptureStdout
-      def initialize expected
-        @expected = expected
-      end
-
-      def matches?
-        begin
-          orig_std  = $stdout
-          $stdout   = StringIO.new
-          yield
-          $stdout.string.eql? @expected
-        ensure
-          $stdout   = orig_std
-        end
-      end
-    end
-  end
-end
-
-expectation_1 = expect { @bird.walks  }.to eql: "Klop klop!"
-expectation_2 = expect { @bird.swims  }.to eql: "Swoosh..."
-expectation_3 = expect { @bird.quacks }.to capture_stdout: "Quaaaaaack!\n"
-expectation_4 = expect { @bird.speaks }.to raise_exception: NoMethodError
-
-case (expectation_1 == true &&
-      expectation_2 == true &&
-      expectation_3 == true &&
-      expectation_4 == true)
-  when true then puts "I call that #{@bird} a duck."
-  else abort 'WAT?'
-end

data/lib/spectus/dsl.rb

@@ -1,20 +0,0 @@
-require_relative 'expectation_target'
-
-module Spectus
-
-  # Expectation's domain-specific language.
-  module DSL
-
-    # Expectations are built with this method.
-    #
-    # @api public
-    #
-    # @example Duck example
-    #   expect { 42 }.to equal: 42 # => true
-    #
-    # @return [ExpectationTarget] the expectation target.
-    def expect &input
-      ExpectationTarget.new(&input)
-    end
-  end
-end