test_tube 2.0.0 → 2.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b343e487d9f73eb0af9f0aeee5ba11c35cab9f644e7a106b3f8a259f3567d142
-  data.tar.gz: 9b28e9986b96cc1af7f1db0b9e98715364a4ff08579038d0a9663a67bd6dbf78
+  metadata.gz: 27985c322404e783924126aac5671af89d2852979dc9cf10deae5ca2821dada7
+  data.tar.gz: a383583d7360975bf5f1e98a0271a566be78f97a293bd8d4cec7437c6e315c4c
 SHA512:
-  metadata.gz: 3dd6be662939a33715130137e2ea9c6f5cebf95b9c33c18bf56457f2c08ac5e50e094c7e63eff045a1d7d9b4bfcee1db2652d43bcd1fc0a324e3ad99e3e1d17e
-  data.tar.gz: 9139defd6aa5d96e1d7b2dcfd676a60757b6bb496fb8ea071164e04c624de3e2d327bede1148e5fd793b5c39c57e7715e69f2982f8de6df9bfc95ed85b7b4c27
+  metadata.gz: e71d511063d6f166ddce31450773f149b679ba21f95a70ffad6f92e527c4819fe44d177d676e1b774d5478f71f31ac61cd6c971d4ad1445e89a3dcab2532d59e
+  data.tar.gz: bf01ae4ec42fdf5075663b61b91933456bbce5a572c5582faa7c06d35cb857a90a23e18cf8cd4cf3109d1c1e4dbf4b49cd420ec0dbcb92c3517c8c5feaa360a9

data/README.md

@@ -39,7 +39,7 @@ require "test_tube"
 ```
 
 Assuming we'd like to experiment on the answer to the Ultimate Question of Life,
-the Universe, and Everything with the following _matcher_:
+the Universe, and Everything with the following matcher:
 
 ```ruby
 class BeTheAnswer
@@ -49,21 +49,13 @@ class BeTheAnswer
 end
 ```
 
-A _matcher_ is an object that responds to the `matches?` method with a block
-parameter representing the _actual value_ to be compared.
-
-Back to our Ruby experiments, one possibility would be to `invoke` a whole block
-of code:
+One possibility would be to `invoke` a whole block of code:
 
 ```ruby
 block_of_code = -> { "101010".to_i(2) }
 
-experiment = TestTube.invoke(
-  isolation: false,
-  matcher:   BeTheAnswer.new,
-  negate:    false,
-  &block_of_code
-)
+experiment = TestTube.invoke(isolate: false, matcher: BeTheAnswer.new, negate: false, &block_of_code)
+# => <TestTube actual=42 error=nil got=true>
 
 experiment.actual # => 42
 experiment.error  # => nil
@@ -75,11 +67,8 @@ An alternative would be to `pass` directly the actual value as a parameter:
 ```ruby
 actual_value = "101010".to_i(2)
 
-experiment = TestTube.pass(
-  actual_value,
-  matcher: BeTheAnswer.new,
-  negate:  false
-)
+experiment = TestTube.pass(actual_value, matcher: BeTheAnswer.new, negate: false)
+# => <TestTube actual=42 error=nil got=true>
 
 experiment.actual # => 42
 experiment.error  # => nil
@@ -105,12 +94,11 @@ An example of successful experience:
 
 ```ruby
 experiment = TestTube.invoke(
-  isolation: false,
-  matcher:   Matchi::Matcher::RaiseException.new(NoMethodError),
-  negate:    false
-) do
-  "foo".blank?
-end
+  isolate: false,
+  matcher: Matchi::RaiseException.new(:NoMethodError),
+  negate:  false
+) { "foo".blank? }
+# => <TestTube actual=#<NoMethodError: undefined method `blank?' for "foo":String> error=nil got=true>
 
 experiment.actual # => #<NoMethodError: undefined method `blank?' for "foo":String>
 experiment.error  # => nil
@@ -121,11 +109,11 @@ Another example of an experiment that fails:
 
 ```ruby
 experiment = TestTube.invoke(
-  isolation: false,
-  matcher:   Matchi::Matcher::Equal.new(0.3),
-  negate:    false,
+  isolate: false,
+  matcher: Matchi::Be.new(0.3),
+  negate:  false,
   &-> { 0.1 + 0.2 }
-)
+) # => <TestTube actual=0.30000000000000004 error=nil got=false>
 
 experiment.actual # => 0.30000000000000004
 experiment.error  # => nil
@@ -136,10 +124,11 @@ Finally, an experiment which causes an error:
 
 ```ruby
 experiment = TestTube.invoke(
-  isolation: false,
-  matcher:   Matchi::Matcher::Match.new(/^foo$/),
-  negate:    false
+  isolate: false,
+  matcher: Matchi::Match.new(/^foo$/),
+  negate:  false
 ) { BOOM }
+# => <TestTube actual=nil error=#<NameError: uninitialized constant BOOM> got=nil>
 
 experiment.actual # => nil
 experiment.error  # => #<NameError: uninitialized constant BOOM>
@@ -149,27 +138,25 @@ experiment.got    # => nil
 ### Code isolation
 
 When experimenting tests, side-effects may occur. Because they may or may not be
-desired, an `isolation` option is available.
+desired, an `isolate` option is available.
 
 Let's for instance consider this block of code:
 
 ```ruby
 greeting = "Hello, world!"
-block_of_code = -> { greeting.gsub!("world", "Alice") }
+block_of_code = -> { greeting.gsub!("world", "Alice") } # => #<Proc:0x00007f87f71b9690 (irb):42 (lambda)>
 ```
 
-By setting the `isolation` option to `true`, we can experiment while avoiding
+By setting the `isolate` option to `true`, we can experiment while avoiding
 side effects:
 
 ```ruby
 experiment = TestTube.invoke(
-  isolation: true,
-  matcher:   Matchi::Matcher::Eql.new("Hello, Alice!"),
-  negate:    false,
+  isolate: true,
+  matcher: Matchi::Eq.new("Hello, Alice!"),
+  negate:  false,
   &block_of_code
-)
-
-experiment.inspect # => <TestTube actual="Hello, Alice!" error=nil got=true>
+) # => <TestTube actual="Hello, Alice!" error=nil got=true>
 
 greeting # => "Hello, world!"
 ```
@@ -178,13 +165,11 @@ Otherwise, we can experiment without any code isolation:
 
 ```ruby
 experiment = TestTube.invoke(
-  isolation: false,
-  matcher:   Matchi::Matcher::Eql.new("Hello, Alice!"),
-  negate:    false,
+  isolate: false,
+  matcher: Matchi::Eq.new("Hello, Alice!"),
+  negate:  false,
   &block_of_code
-)
-
-experiment.inspect # => <TestTube actual="Hello, Alice!" error=nil got=true>
+) # => <TestTube actual="Hello, Alice!" error=nil got=true>
 
 greeting # => "Hello, Alice!"
 ```
@@ -192,6 +177,8 @@ greeting # => "Hello, Alice!"
 ## Contact
 
 * Source code: https://github.com/fixrb/test_tube
+* Chinese blog post: https://ruby-china.org/topics/41390
+* Japanese blog post: https://qiita.com/cyril/items/36174b619ff1852c80ec
 
 ## Versioning
 
@@ -199,7 +186,7 @@ __Test Tube__ follows [Semantic Versioning 2.0](https://semver.org/).
 
 ## License
 
-The [gem](https://rubygems.org/gems/test_tube) is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+The [gem](https://rubygems.org/gems/test_tube) is available as open source under the terms of the [MIT License](https://github.com/fixrb/test_tube/raw/main/LICENSE.md).
 
 ***
 

data/lib/test_tube.rb

@@ -7,10 +7,10 @@ require_relative File.join("test_tube", "passer")
 #
 # @api public
 module TestTube
-  # @param isolation  [Boolean]     Compute in isolation or not.
-  # @param matcher    [#matches?]   A matcher.
-  # @param negate     [Boolean]     Invert the matcher or not.
-  # @param input      [Proc]        The callable object to test.
+  # @param isolate  [Boolean]   Compute in a subprocess.
+  # @param matcher  [#matches?] A matcher.
+  # @param negate   [Boolean]   Invert the matcher or not.
+  # @param input    [Proc]      The callable object to test.
   #
   # @example
   #   require "test_tube"
@@ -21,18 +21,18 @@ module TestTube
   #     end
   #   end
   #
-  #   TestTube.invoke(isolation: false, matcher: BeTheAnswer.new, negate: false) do
+  #   TestTube.invoke(isolate: false, matcher: BeTheAnswer.new, negate: false) do
   #     "101010".to_i(2)
   #   end
   #
   # @return [Invoker] A software experiment.
-  def self.invoke(isolation:, matcher:, negate:, &input)
-    Invoker.new(isolation: isolation, matcher: matcher, negate: negate, &input)
+  def self.invoke(isolate:, matcher:, negate:, &input)
+    Invoker.new(isolate: isolate, matcher: matcher, negate: negate, &input)
   end
 
-  # @param input      [#object_id]  The callable object to test.
-  # @param matcher    [#matches?]   A matcher.
-  # @param negate     [Boolean]     Invert the matcher or not.
+  # @param input    [#object_id]  The actual value to test.
+  # @param matcher  [#matches?]   A matcher.
+  # @param negate   [Boolean]     Invert the matcher or not.
   #
   # @example
   #   require "test_tube"

data/lib/test_tube/base.rb

@@ -4,25 +4,33 @@ module TestTube
   # Abstract class representing the state of an experiment.
   #
   # @api private
-  class Base
+  class Base < ::BasicObject
     # Expectation's actual value.
     #
     # @return [#object_id] The actual value.
+    #
+    # @api public
     attr_reader :actual
 
     # Expectation's raised error.
     #
     # @return [Exception, nil] The raised error.
+    #
+    # @api public
     attr_reader :error
 
     # Expectation's returned boolean value.
     #
     # @return [Boolean, nil] The returned boolean value.
+    #
+    # @api public
     attr_reader :got
 
     # A string containing a human-readable representation of the experiment.
     #
     # @return [String] The human-readable representation of the experiment.
+    #
+    # @api public
     def inspect
       "<TestTube actual=#{actual.inspect} error=#{error.inspect} got=#{got.inspect}>"
     end

data/lib/test_tube/invoker.rb

@@ -9,19 +9,19 @@ module TestTube
   #
   # @api private
   class Invoker < Base
-    # Class initializer.
-    #
     # rubocop:disable Lint/RescueException, Metrics/MethodLength
+
+    # Class initializer.
     #
-    # @param isolation  [Boolean]   Compute in isolation or not.
-    # @param matcher    [#matches?] A matcher.
-    # @param negate     [Boolean]   Invert the matcher or not.
-    # @param input      [Proc]      The callable object to test.
-    def initialize(isolation:, matcher:, negate:, &input)
+    # @param isolate  [Boolean]   Compute in a subprocess.
+    # @param matcher  [#matches?] A matcher.
+    # @param negate   [Boolean]   Invert the matcher or not.
+    # @param input    [Proc]      The callable object to test.
+    def initialize(isolate:, matcher:, negate:, &input)
       super()
 
       @got = negate ^ matcher.matches? do
-        value = if isolation
+        value = if isolate
                   send_call.to!(input)
                 else
                   send_call.to(input)
@@ -34,6 +34,7 @@ module TestTube
       @actual = nil
       @error  = e
     end
+
     # rubocop:enable Lint/RescueException, Metrics/MethodLength
 
     private

data/lib/test_tube/passer.rb

@@ -9,7 +9,7 @@ module TestTube
   class Passer < Base
     # Class initializer.
     #
-    # @param input    [#object_id]  An actual value to test.
+    # @param input    [#object_id]  The actual value to test.
     # @param matcher  [#matches?]   A matcher.
     # @param negate   [Boolean]     Invert the matcher or not.
     def initialize(input, matcher:, negate:)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: test_tube
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.1.3
 platform: ruby
 authors:
 - Cyril Kato
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-11 00:00:00.000000000 Z
+date: 2021-08-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: defi
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.5
+        version: 2.0.6
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.5
+        version: 2.0.6
 - !ruby/object:Gem::Dependency
   name: brutal
   requirement: !ruby/object:Gem::Requirement
@@ -52,6 +52,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: matchi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement