spectus 3.3.0 → 3.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 91207456a98d2640cdeb0dbf52ce04c532f72060c904aa15474f2eb86eb67481
-  data.tar.gz: 26e7073807fa4bb734eb8e349682c41d2b23bd83c11012818ce443b5615089e3
+  metadata.gz: 2fea4a88991addc0a6b69ce46d6422e92df818447818975d6123848cbba9d5a7
+  data.tar.gz: 8dffb97e6e58cdf0c3e5661294238e42f5477f4e677a34868ce918156086cbdb
 SHA512:
-  metadata.gz: '018827c15c82d74b1af062e57768809c89f6ad18e2b389b4150ae318f12fdbadd6709eff232483d67a7e9aa0234d008ade347503066b78c522f7291fa515f809'
-  data.tar.gz: a57c6cfaf4b7292ca768fc309e61a025d85de984cf62af8f0a88c0b37d58189732babf03e3a8a6eed208838518af088d1d53448cc5c6c71842db1e52f0c60ab7
+  metadata.gz: 9a4798a255dcf0097dcba1bac46af91552a11348513c0d4af77a00a748cb950e90b113c264404cc745af3c7dc730154ad81893d879a495450f6cda5ca4b07942
+  data.tar.gz: ba56345d554c0483ce27fd6c7d876e7837d59a53a37a9b9e6417df849e0a6047b522a2c00e7f5d4327a76c1ed3e60cea68cff5970e7dcc4718d31ed89e3e6fa4

data/README.md

@@ -1,12 +1,10 @@
 # Spectus
 
-[![Build Status](https://api.travis-ci.org/fixrb/spectus.svg?branch=main)][travis]
-[![Code Climate](https://codeclimate.com/github/fixrb/spectus/badges/gpa.svg)][codeclimate]
-[![Gem Version](https://badge.fury.io/rb/spectus.svg)][gem]
-[![Inline docs](https://inch-ci.org/github/fixrb/spectus.svg?branch=main)][inchpages]
-[![Documentation](https://img.shields.io/:yard-docs-38c800.svg)][rubydoc]
+[![Build Status](https://api.travis-ci.org/fixrb/spectus.svg?branch=main)](https://travis-ci.org/fixrb/spectus)
+[![Gem Version](https://badge.fury.io/rb/spectus.svg)](https://rubygems.org/gems/spectus)
+[![Documentation](https://img.shields.io/:yard-docs-38c800.svg)](https://rubydoc.info/gems/spectus/frames)
 
-> Expectation library with [RFC 2119](https://www.ietf.org/rfc/rfc2119.txt)'s requirement levels 🚥
+> Expectation library with [RFC 2119](https://www.ietf.org/rfc/rfc2119.txt) requirement levels 🚥
 
 ## Installation
 
@@ -18,80 +16,161 @@ gem "spectus"
 
 And then execute:
 
-    $ bundle
+```sh
+bundle
+```
 
 Or install it yourself as:
 
-    $ gem install spectus
+```sh
+gem install spectus
+```
+
+## Overview
+
+Assuming that an expectation is an assertion that is either `true` or `false`,
+qualifying it with `MUST`, `SHOULD` and `MAY`, we can draw up several scenarios:
+
+| Requirement levels        | **MUST** | **SHOULD** | **MAY** |
+| ------------------------- | -------- | ---------- | ------- |
+| Implemented & Matched     | `true`   | `true`     | `true`  |
+| Implemented & Not matched | `false`  | `true`     | `false` |
+| Implemented & Exception   | `false`  | `false`    | `false` |
+| Not implemented           | `false`  | `false`    | `true`  |
+
+When an expectation is evaluated by __Spectus__,
+
+* in case of a _passed_ expectation, a `Spectus::Result::Pass` instance is _returned_;
+* in case of a _failed_ expectation, a `Spectus::Result::Fail` exception is _raised_.
 
 ## Usage
 
-To begin with, let's include __Spectus__:
+The __Spectus__ library is basically a module containing an `it` instance method that accept a block representing the actual value to be evaluated through an expectation.
+
+The `Spectus` module can be included inside a class and used as follows:
+
+```ruby
+require "spectus"
+
+class Spec
+  include ::Spectus
+
+  attr_reader :subject
+
+  def initialize(subject)
+    @subject = subject
+  end
+
+  def test_a
+    it { subject.upcase }.MUST eql "FOO"
+  end
+
+  def test_b
+    it { subject.blank? }.MAY be_true
+  end
+
+  def test_c
+    it { subject.length }.SHOULD equal 42
+  end
+end
+```
+
+```ruby
+t = Spec.new("foo")
+
+t.test_a # => Spectus::Result::Pass(actual: "FOO", error: nil, expected: "FOO", got: true, matcher: :eql, negate: false, level: :MUST)
+
+t.test_b # => Spectus::Result::Pass(actual: nil, error: #<NoMethodError: undefined method `blank?' for "foo":String>, expected: nil, got: nil, matcher: :be_true, negate: false, level: :MAY)
+
+t.test_c # => Spectus::Result::Pass(actual: 3, error: nil, expected: 42, got: false, matcher: :equal, negate: false, level: :SHOULD)
+```
 
 ```ruby
+t = Spec.new(4)
+
+t.test_a # => raises an exception:
+# Traceback (most recent call last):
+#         3: from ./bin/console:8:in `<main>'
+#         2: from (irb):23
+#         1: from (irb):11:in `test_a'
+# Spectus::Result::Fail (NoMethodError: undefined method `upcase' for 4:Integer)
+
+t.test_b # => Spectus::Result::Pass(actual: nil, error: #<NoMethodError: undefined method `blank?' for 4:Integer>, expected: nil, got: nil, matcher: :be_true, negate: false, level: :MAY)
+
+t.test_c # => raises an exception:
+# Traceback (most recent call last):
+#         3: from ./bin/console:8:in `<main>'
+#         2: from (irb):25
+#         1: from (irb):19:in `test_c'
+# Spectus::Result::Fail (NoMethodError: undefined method `length' for 4:Integer.)
+```
+
+## More examples
+
+To make __Spectus__ available:
+
+```ruby
+require "spectus"
+
 include Spectus
 ```
 
+All examples here assume that this has been done.
+
 ### Absolute Requirement
 
-Given the "`ルビー`" object, when it receives `valid_encoding?` method, then it **MUST** be `true`:
+There's only one bat:
 
 ```ruby
-it { "ルビー".valid_encoding? }.MUST be_true
-# => Spectus::Result::Pass(actual: true, error: nil, expected: nil, got: true, matcher: :be_true, negate: false, level: :MUST, valid: true)
+it { "🦇".size }.MUST equal 1
+# => Spectus::Result::Pass(actual: 1, error: nil, expected: 1, got: true, matcher: :equal, negate: false, level: :MUST)
 ```
 
-The result of the test shows that the spec passed.
-
 ### Absolute Prohibition
 
-Given the "`foo`" object, when it receives `length` method, then it **MUST NOT** raise the `NoMethodError` exception:
+The true from the false:
 
 ```ruby
-it { "foo".length }.MUST_NOT raise_exception NoMethodError
-# => Spectus::Result::Pass(actual: 3, error: nil, expected: NoMethodError, got: true, matcher: :raise_exception, negate: true, level: :MUST, valid: true)
+it { false }.MUST_NOT be_true
+# => Spectus::Result::Pass(actual: false, error: nil, expected: nil, got: true, matcher: :be_true, negate: true, level: :MUST)
 ```
 
-The result of the test shows that the spec passed.
-
 ### Recommended
 
-Given the `BasicObject` object, when it receives `superclass` method, then it **SHOULD** return the explicit blank class `NilClass`:
+A well-known joke. An addition of `0.1` and `0.2` is deadly precise:
 
 ```ruby
-it { BasicObject.superclass }.SHOULD equal NilClass
-# => Spectus::Result::Pass(actual: nil, error: nil, expected: NilClass, got: false, matcher: :equal, negate: false, level: :SHOULD, valid: false)
+it { 0.1 + 0.2 }.SHOULD equal 0.3
+# => Spectus::Result::Pass(actual: 0.30000000000000004, error: nil, expected: 0.3, got: false, matcher: :equal, negate: false, level: :SHOULD)
 ```
 
-Instead of the expected `NilClass` class, its sole instance (which is `nil`) was returned.
-However, because there isn't any exception, the result of the test shows that the spec passed.
-
 ### Not Recommended
 
-Given the "`1`" object, when it receives `+(1)` method, then it **SHOULD NOT** return the "`11`" value:
+The situation should still be under control:
 
 ```ruby
-it { "1" + 1 }.SHOULD_NOT eql "11"
-# raise Spectus::Result::Fail(actual: nil, error: #<TypeError: no implicit conversion of Integer into String>, expected: "11", got: nil, matcher: :eql, negate: true, level: :SHOULD, valid: false)
+it { BOOM }.SHOULD_NOT raise_exception SystemExit
 ```
 
-There was a `TypeError` exception, the result of the test shows that the spec failed.
+```txt
+Traceback (most recent call last):
+        2: from ./bin/console:8:in `<main>'
+        1: from (irb):8
+Spectus::Result::Fail (NameError: uninitialized constant BOOM.)
+```
 
 ### Optional
 
-Given the "`foo`" object, when it receives `blank?` method, then it **MAY** be `false`:
+An empty array is blank, right?
 
 ```ruby
-it { "foo".blank? }.MAY be_false
-# => Spectus::Result::Pass(actual: nil, error: #<NoMethodError: undefined method `blank?' for "foo":String>, expected: nil, got: nil, matcher: :be_false, negate: false, level: :MAY, valid: false)
+it { [].blank? }.MAY be_true
+# => Spectus::Result::Pass(actual: nil, error: #<NoMethodError: undefined method `blank?' for []:Array>, expected: nil, got: nil, matcher: :be_true, negate: false, level: :MAY)
 ```
 
-The optional `blank?` method is not implemented (unlike in [Ruby on Rails](https://api.rubyonrails.org/classes/Object.html#method-i-blank-3F), for instance), so the result of the test shows that the spec passed.
-
-### More Examples
+Damn, I forgot to load activesupport. 🤦‍♂️
 
-A full list of unit tests can be viewed (and executed) here:
-[./test.rb](https://github.com/fixrb/spectus/blob/main/test.rb)
+That said, the test is passing due to the _not-implemented-like_ raised exception: `NoMethodError`.
 
 ## Code Isolation
 
@@ -104,20 +183,22 @@ Because they may or may not be desired, each requirement level has 2 versions:
 Example of test without isolation:
 
 ```ruby
-include Spectus
 greeting = "Hello, world!"
+
 it { greeting.gsub!("world", "Alice") }.MUST eql "Hello, Alice!"
-# => Spectus::Result::Pass(actual: "Hello, Alice!", error: nil, expected: "Hello, Alice!", got: true, matcher: :eql, negate: false, level: :MUST, valid: true)
+# => Spectus::Result::Pass(actual: "Hello, Alice!", error: nil, expected: "Hello, Alice!", got: true, matcher: :eql, negate: false, level: :MUST)
+
 greeting # => "Hello, Alice!"
 ```
 
 Example of test in isolation:
 
 ```ruby
-include Spectus
 greeting = "Hello, world!"
+
 it { greeting.gsub!("world", "Alice") }.MUST! eql "Hello, Alice!"
-# => Spectus::Result::Pass(actual: "Hello, Alice!", error: nil, expected: "Hello, Alice!", got: true, matcher: :eql, negate: false, level: :MUST, valid: true)
+# => Spectus::Result::Pass(actual: "Hello, Alice!", error: nil, expected: "Hello, Alice!", got: true, matcher: :eql, negate: false, level: :MUST)
+
 greeting # => "Hello, world!"
 ```
 
@@ -132,7 +213,7 @@ __Spectus__ follows [Semantic Versioning 2.0](https://semver.org/).
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+The [gem](https://rubygems.org/gems/spectus) is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
 
 ***
 
@@ -142,9 +223,3 @@ The gem is available as open source under the terms of the [MIT License](https:/
     src="https://github.com/fixrb/spectus/raw/main/img/sashite.png"
     alt="Sashite" /></a>
 </p>
-
-[gem]: https://rubygems.org/gems/spectus
-[travis]: https://travis-ci.org/fixrb/spectus
-[codeclimate]: https://codeclimate.com/github/fixrb/spectus
-[inchpages]: https://inch-ci.org/github/fixrb/spectus
-[rubydoc]: https://rubydoc.info/gems/spectus/frames

data/lib/spectus.rb

@@ -2,18 +2,108 @@
 
 require "matchi/helper"
 
+require_relative File.join("spectus", "expectation_target")
+
 # Namespace for the Spectus library.
 #
-# @example It MUST equal 42.
+# This module defines the {#it} method to create expectations, which can be
+# automatically included into classes.
+#
+# @example
+#   class Spec
+#     include ::Spectus
+#
+#     attr_reader :subject
+#
+#     def initialize(subject)
+#       @subject = subject
+#     end
+#
+#     def test_a
+#       it { subject.upcase }.MUST eql "FOO"
+#     end
+#
+#     def test_b
+#       it { subject.blank? }.MAY be_true
+#     end
+#
+#     def test_c
+#       it { subject.length }.SHOULD equal 42
+#     end
+#   end
+#
+#   t = Spec.new("foo")
+#   t.test_a # => Spectus::Result::Pass(actual: "FOO", error: nil, expected: "FOO", got: true, matcher: :eql, negate: false, level: :MUST)
+#   t.test_b # => Spectus::Result::Pass(actual: nil, error: #<NoMethodError: undefined method `blank?' for "foo":String>, expected: nil, got: nil, matcher: :be_true, negate: false, level: :MAY)
+#   t.test_c # => Spectus::Result::Pass(actual: 3, error: nil, expected: 42, got: false, matcher: :equal, negate: false, level: :SHOULD)
+#
+# Or even directly used like this.
+#
+# @example
 #   require 'spectus'
-#   it { 42 }.MUST equal 42 # => #<Spectus::Result::Pass...>
+#
+#   include Spectus
+#
+#   it { 42 }.MUST equal 42 # => Spectus::Result::Pass(actual: 42, error: nil, expected: 42, got: true, matcher: :equal, negate: false, level: :MUST
+#
+# It also includes a collection of expectation matchers 🤹
+#
+# @example Equivalence matcher
+#   matcher = eql("foo") # => Matchi::Matcher::Eql.new("foo")
+#   matcher.matches? { "foo" } # => true
+#   matcher.matches? { "bar" } # => false
+#
+# @example Identity matcher
+#   object = "foo"
+#
+#   matcher = equal(object) # => Matchi::Matcher::Equal.new(object)
+#   matcher.matches? { object } # => true
+#   matcher.matches? { "foo" } # => false
+#
+# @example Regular expressions matcher
+#   matcher = match(/^foo$/) # => Matchi::Matcher::Match.new(/^foo$/)
+#   matcher.matches? { "foo" } # => true
+#   matcher.matches? { "bar" } # => false
+#
+# @example Expecting errors matcher
+#   matcher = raise_exception(NameError) # => Matchi::Matcher::RaiseException.new(NameError)
+#   matcher.matches? { Boom } # => true
+#   matcher.matches? { true } # => false
+#
+# @example Truth matcher
+#   matcher = be_true # => Matchi::Matcher::BeTrue.new
+#   matcher.matches? { true } # => true
+#   matcher.matches? { false } # => false
+#   matcher.matches? { nil } # => false
+#   matcher.matches? { 4 } # => false
+#
+# @example Untruth matcher
+#   matcher = be_false # => Matchi::Matcher::BeFalse.new
+#   matcher.matches? { false } # => true
+#   matcher.matches? { true } # => false
+#   matcher.matches? { nil } # => false
+#   matcher.matches? { 4 } # => false
+#
+# @example Nil matcher
+#   matcher = be_nil # => Matchi::Matcher::BeNil.new
+#   matcher.matches? { nil } # => true
+#   matcher.matches? { false } # => false
+#   matcher.matches? { true } # => false
+#   matcher.matches? { 4 } # => false
+#
+# @example Type/class matcher
+#   matcher = be_an_instance_of(String) # => Matchi::Matcher::BeAnInstanceOf.new(String)
+#   matcher.matches? { "foo" } # => true
+#   matcher.matches? { 4 } # => false
+#
+# @see https://github.com/fixrb/matchi
 module Spectus
   include ::Matchi::Helper
 
   # Expectations are built with this method.
   #
   # @example An _absolute requirement_ definition.
-  #   it { 42 }.MUST equal 42 # => #<Spectus::Result::Pass...>
+  #   it { 42 }.MUST equal 42 # => Spectus::Result::Pass(actual: 42, error: nil, expected: 42, got: true, matcher: :equal, negate: false, level: :MUST
   #
   # @param input [Proc] The code to test.
   #
@@ -22,5 +112,3 @@ module Spectus
     ExpectationTarget.new(&input)
   end
 end
-
-require_relative File.join("spectus", "expectation_target")

data/lib/spectus/expectation_target.rb

@@ -1,5 +1,9 @@
 # frozen_string_literal: true
 
+require_relative File.join("requirement_level", "must")
+require_relative File.join("requirement_level", "should")
+require_relative File.join("requirement_level", "may")
+
 module Spectus
   # Wraps the target of an expectation.
   #
@@ -196,7 +200,3 @@ module Spectus
     attr_reader :callable
   end
 end
-
-require_relative File.join("requirement_level", "must")
-require_relative File.join("requirement_level", "should")
-require_relative File.join("requirement_level", "may")

data/lib/spectus/requirement_level/base.rb

@@ -1,5 +1,9 @@
 # frozen_string_literal: true
 
+require "test_tube"
+
+require_relative File.join("..", "result")
+
 module Spectus
   # Namespace for the requirement levels.
   module RequirementLevel
@@ -9,22 +13,21 @@ module Spectus
       #
       # @param callable   [#call]     The callable object to test.
       # @param isolation  [Boolean]   Compute actual in isolation?
-      # @param negate     [Boolean]   Positive or negative assertion?
+      # @param negate     [Boolean]   Invert the matcher or not.
       # @param matcher    [#matches?] The matcher.
-      def initialize(callable:, isolation:, negate:, matcher:)
-        @negate   = negate
-        @matcher  = matcher
-
-        @exam = Exam.new(
-          callable:   callable,
+      def initialize(callable:, isolation:, matcher:, negate:)
+        @negate     = negate
+        @matcher    = matcher
+        @experiment = ::TestTube.invoke(
+          callable,
           isolation:  isolation,
-          negate:     negate,
-          matcher:    matcher
+          matcher:    matcher,
+          negate:     negate
         )
       end
 
-      # @return [#Exam] The exam.
-      attr_reader :exam
+      # @return [TestTube::Base] The experiment.
+      attr_reader :experiment
 
       # @return [#matches?] The matcher that performed a boolean comparison
       #   between the actual value and the expected value.
@@ -32,24 +35,25 @@ module Spectus
 
       # The result of the expectation.
       #
-      # @raise [Spectus::Result::Fail] The expectation is `false`.
-      # @return [Spectus::Result::Pass] The expectation is `true`.
+      # @raise [Spectus::Result::Fail] The expectation failed.
+      # @return [Spectus::Result::Pass] The expectation passed.
       def call
         Result.call(pass?).with(
-          actual:   exam.actual,
-          error:    exam.exception,
+          actual:   experiment.actual,
+          error:    experiment.error,
           expected: matcher.expected,
-          got:      exam.got,
-          negate:   negate?,
-          valid:    exam.valid?,
+          got:      experiment.got,
+          level:    level,
           matcher:  matcher.class.to_sym,
-          level:    level
+          negate:   negate?
         )
       end
 
       protected
 
-      # @return [Symbol] The requirement level.
+      # Some key words for use in RFCs to indicate requirement levels.
+      #
+      # @return [:MUST, :SHOULD, :MAY] The requirement level.
       def level
         self.class.name.split("::").fetch(-1).upcase.to_sym
       end
@@ -57,13 +61,10 @@ module Spectus
       # @note The boolean comparison between the actual value and the expected
       #   value can be evaluated to a negative assertion.
       #
-      # @return [Boolean] Positive or negative assertion?
+      # @return [Boolean] Invert the matcher or not.
       def negate?
         @negate
       end
     end
   end
 end
-
-require_relative File.join("..", "exam")
-require_relative File.join("..", "result")

data/lib/spectus/requirement_level/may.rb

@@ -10,7 +10,7 @@ module Spectus
       #
       # @return [Boolean] Report if the low expectation pass or fail?
       def pass?
-        super || exam.exception.is_a?(::NoMethodError)
+        super || experiment.error.is_a?(::NoMethodError)
       end
     end
   end

data/lib/spectus/requirement_level/must.rb

@@ -10,7 +10,7 @@ module Spectus
       #
       # @return [Boolean] Report if the high expectation pass or fail?
       def pass?
-        exam.valid?
+        experiment.got.equal?(true)
       end
     end
   end

data/lib/spectus/requirement_level/should.rb

@@ -10,7 +10,7 @@ module Spectus
       #
       # @return [Boolean] Report if the medium expectation pass or fail?
       def pass?
-        super || exam.exception.nil?
+        super || experiment.error.nil?
       end
     end
   end

data/lib/spectus/result.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require_relative File.join("result", "fail")
+require_relative File.join("result", "pass")
+
 module Spectus
   # Namespace for the results.
   module Result
@@ -13,6 +16,3 @@ module Spectus
     end
   end
 end
-
-require_relative File.join("result", "fail")
-require_relative File.join("result", "pass")

data/lib/spectus/result/fail.rb

@@ -5,6 +5,8 @@ require "expresenter/fail"
 module Spectus
   module Result
     # The class that is responsible for reporting that the expectation is false.
+    #
+    # @see https://github.com/fixrb/expresenter/blob/v1.2.1/lib/expresenter/fail.rb
     class Fail < ::Expresenter::Fail
     end
   end

data/lib/spectus/result/pass.rb

@@ -5,6 +5,8 @@ require "expresenter/pass"
 module Spectus
   module Result
     # The class that is responsible for reporting that the expectation is true.
+    #
+    # @see https://github.com/fixrb/expresenter/blob/v1.2.1/lib/expresenter/pass.rb
     class Pass < ::Expresenter::Pass
     end
   end

metadata

@@ -1,57 +1,57 @@
 --- !ruby/object:Gem::Specification
 name: spectus
 version: !ruby/object:Gem::Version
-  version: 3.3.0
+  version: 3.4.0
 platform: ruby
 authors:
 - Cyril Kato
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-05-12 00:00:00.000000000 Z
+date: 2021-06-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: defi
+  name: expresenter
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.4
+        version: 1.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.4
+        version: 1.3.0
 - !ruby/object:Gem::Dependency
-  name: expresenter
+  name: matchi
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.0
+        version: 2.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.0
+        version: 2.1.0
 - !ruby/object:Gem::Dependency
-  name: matchi
+  name: test_tube
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.0
+        version: 1.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.0
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: brutal
   requirement: !ruby/object:Gem::Requirement
@@ -187,7 +187,6 @@ files:
 - LICENSE.md
 - README.md
 - lib/spectus.rb
-- lib/spectus/exam.rb
 - lib/spectus/expectation_target.rb
 - lib/spectus/requirement_level/base.rb
 - lib/spectus/requirement_level/may.rb
@@ -215,7 +214,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.1.6
 signing_key: 
 specification_version: 4
 summary: "Expectation library with RFC 2119's requirement levels \U0001F6A5"

data/lib/spectus/exam.rb

@@ -1,56 +0,0 @@
-# frozen_string_literal: true
-
-require "defi"
-
-module Spectus
-  # This class evaluate the expectation with the passed block.
-  class Exam
-    # Execute the untested code from the passed block against the matcher.
-    #
-    # rubocop:disable Lint/RescueException
-    #
-    # @param callable   [#call]     The callable object to test.
-    # @param isolation  [Boolean]   Compute actual in isolation?
-    # @param negate     [Boolean]   Positive or negative assertion?
-    # @param matcher    [#matches?] The matcher.
-    def initialize(callable:, isolation:, negate:, matcher:)
-      @got = negate ^ matcher.matches? do
-        value = if isolation
-                  send_call.to!(callable)
-                else
-                  send_call.to(callable)
-                end
-
-        @actual = value.object
-
-        value.call
-      end
-    rescue ::Exception => e
-      @actual     = nil
-      @exception  = e
-    end
-    # rubocop:enable Lint/RescueException
-
-    # @return [#object_id] The actual value.
-    attr_reader :actual
-
-    # @return [Exception, nil] An exception.
-    attr_reader :exception
-
-    # @return [Boolean, nil] Report to the spec requirement level if the
-    #   expectation is true or false.
-    attr_reader :got
-
-    # @return [Defi::Challenge] The challenge for the callable object.
-    def send_call
-      ::Defi.send(:call)
-    end
-
-    # Report to the spec requirement level if the test pass or fail.
-    #
-    # @return [Boolean] Report if the test pass or fail?
-    def valid?
-      exception.nil? ? got : false
-    end
-  end
-end