fix 1.0.0.beta7 → 1.0.0.beta8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 81f6a38942f7037e0250876038e1a715b9b905d5fb2186fb1b3dc3884ebee446
-  data.tar.gz: 76f805fc42a2683236ed85efbc888c25fadfaeb2f975177127101e4eb8ae2618
+  metadata.gz: 9d095777befeb78f0e16a218f3f14c0f8b39955265db3848cd26a0afb0b224f3
+  data.tar.gz: d918e8bfd693765450dfb14477f4fe9285642e22a35995446b89acac78662837
 SHA512:
-  metadata.gz: c0ae0f82dd15aff8f14252631c2c8cf134bd6ce78ba814267f53e7b88a5d84ff2c7d14bb753152f51cea595f46a0284ae58d370e6e50f74fa6c6ec7bb7dcace1
-  data.tar.gz: 983e9f29a66982ab2cfef0548b50c064c0b63605acdb0f055da6f35cfd2153f667bf3d58975f6d274b49101d557149336e3a6c465549cfa3658f758903024617
+  metadata.gz: c063f295f4d133635d70da15659c613018b51931db21d40c3bedb7db9b442fa756e8ed52833fc49333a816749df99c73956d43c237159f7bd6e728ea36e7791d
+  data.tar.gz: 1e4317121e610e67d0d396571b86e0a82b07c16122cc0be5c2c7ee5514136d9ec349282b643f06fe6d7f7b33cd04584048cf72ec3d8d88345e93f1135e7d5dee

data/README.md

@@ -15,7 +15,7 @@
 
 * Extract specs from the tests.
 * Look like English documents.
-* Be minimalist and easy to hack.
+* Be minimalist and easy to use.
 * Run tests quickly.
 
 ## Installation
@@ -23,7 +23,7 @@
 Add this line to your application's Gemfile:
 
 ```ruby
-gem "fix", ">= 1.0.0.beta7"
+gem "fix", ">= 1.0.0.beta8"
 ```
 
 And then execute:
@@ -40,31 +40,12 @@ gem install fix --pre
 
 ## Example
 
-Given this app:
-
-```ruby
-# examples/duck/app.rb
-class Duck
-  def walks
-    "Klop klop!"
-  end
-
-  def swims
-    "Swoosh..."
-  end
-
-  def quacks
-    puts "Quaaaaaack!"
-  end
-end
-```
-
-And this fixed behavior:
+Given these specifications:
 
 ```ruby
 # examples/duck/fix.rb
 
-relative "fix"
+require "fix"
 
 Fix :Duck do
   it SHOULD be_an_instance_of :Duck
@@ -84,7 +65,26 @@ Fix :Duck do
 end
 ```
 
-When I run this test:
+When we load this `Duck` application:
+
+```ruby
+# examples/duck/app.rb
+class Duck
+  def walks
+    "Klop klop!"
+  end
+
+  def swims
+    "Swoosh..."
+  end
+
+  def quacks
+    puts "Quaaaaaack!"
+  end
+end
+```
+
+And we run this test:
 
 ```ruby
 # examples/duck/test.rb
@@ -92,20 +92,21 @@ When I run this test:
 require_relative "app"
 require_relative "fix"
 
-Fix[:Duck].test { Duck.new }
+Fix[:Duck].against { Duck.new }
 ```
 
 ```sh
 ruby examples/duck/test.rb
 ```
 
-I should see this output:
+We should see this output:
 
 ```txt
-Success: expected #<Duck:0x00007fc55b3c6388> to be an instance of Duck.
-Success: expected to eql "Swoosh...".
-Success: undefined method `speaks' for #<Duck:0x00007fc55b3c46f0>.
-NoMethodError: undefined method `sings' for #<Duck:0x00007fc558aab6d8>.
+(irb):3 Success: expected #<Duck:0x00007fb2fa208708> to be an instance of Duck.
+(irb):7 Success: expected to eq "Swoosh...".
+(irb):15 NoMethodError: undefined method `sings' for #<Duck:0x00007fb2fd8371d0>.
+(irb):6 Success: expected "Swoosh..." to be an instance of String.
+(irb):11 Success: undefined method `speaks' for #<Duck:0x00007fb2fcc79258>.
 ```
 
 ## Contact

data/lib/fix.rb

@@ -11,9 +11,9 @@ module Fix
   # Test a built specification.
   #
   # @example Run _Answer_ specification against `42`.
-  #   Fix[:Answer].test(42)
+  #   Fix[:Answer].against(42)
   #
-  # @param name [String, Symbol] The name of the specification document.
+  # @param name [String, Symbol] The constant name of the specifications.
   #
   # @return [::Fix::Test] The specification document.
   def self.[](name)

data/lib/fix/doc.rb

@@ -5,7 +5,7 @@ module Fix
   #
   # @api private
   module Doc
-    # @param name [String, Symbol] The name of the specification document.
+    # @param name [String, Symbol] The constant name of the specifications.
     def self.fetch(name)
       const_get("#{name}::CONTEXTS")
     end

data/lib/fix/matcher.rb

@@ -205,5 +205,37 @@ module Fix
     def satisfy(&expected)
       ::Matchi::Satisfy.new(&expected)
     end
+
+    private
+
+    # Predicate matcher, or default method missing behavior.
+    #
+    # @example Empty predicate matcher
+    #   matcher = be_empty
+    #   matcher.matches? { [] } # => true
+    #   matcher.matches? { [4] } # => false
+    def method_missing(name, *args, **kwargs, &block)
+      return super unless predicate_matcher_name?(name)
+
+      ::Matchi::Predicate.new(name, *args, **kwargs, &block)
+    end
+
+    # :nocov:
+
+    # Hook method to return whether the obj can respond to id method or not.
+    def respond_to_missing?(name, include_private = false)
+      predicate_matcher_name?(name) || super
+    end
+
+    # :nocov:
+
+    # Predicate matcher name detector.
+    #
+    # @param name [Array, Symbol] The name of a potential predicate matcher.
+    #
+    # @return [Boolean] Indicates if it is a predicate matcher name or not.
+    def predicate_matcher_name?(name)
+      name.start_with?("be_", "have_") && !name.end_with?("!", "?")
+    end
   end
 end

data/lib/fix/set.rb

@@ -32,7 +32,7 @@ module Fix
     # @return [Array] A list of specifications.
     attr_reader :specs
 
-    # @param name [String, Symbol] The name of the specification document.
+    # @param name [String, Symbol] The constant name of the specifications.
     #
     # @api public
     def self.load(name)
@@ -47,10 +47,10 @@ module Fix
 
     # @param subject [Proc] The block of code to be tested.
     #
-    # @raise [::SystemExit] The result of the test.
+    # @raise [::SystemExit] The test set failed!
     #
     # @api public
-    def test(log_level: 5, &subject)
+    def against(log_level: 5, &subject)
       randomize!
 
       specs.each do |environment, location, requirement, challenges|
@@ -61,7 +61,7 @@ module Fix
         report!(location, result, log_level: log_level)
       end
 
-      exit!
+      passed? || ::Kernel.exit(false)
     end
 
     private
@@ -70,11 +70,6 @@ module Fix
       specs.shuffle!
     end
 
-    # @raise [::SystemExit] The result of the test.
-    def exit!
-      ::Kernel.exit(passed?)
-    end
-
     def failed!
       @passed = false
     end

data/lib/kernel.rb

@@ -17,12 +17,12 @@ module Kernel
   #   end
   #
   #   # A test
-  #   Fix[:Answer].test { 42 }
+  #   Fix[:Answer].against { 42 }
   #
-  # @param name   [String, Symbol]  The name of the specification document.
+  # @param name   [String, Symbol]  The constant name of the specifications.
   # @param block  [Proc]            The specifications.
   #
-  # @return [#test] The collection of specifications.
+  # @return [#against] The collection of specifications.
   #
   # @api public
   def Fix(name = nil, &block)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fix
 version: !ruby/object:Gem::Version
-  version: 1.0.0.beta7
+  version: 1.0.0.beta8
 platform: ruby
 authors:
 - Cyril Kato
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-27 00:00:00.000000000 Z
+date: 2021-07-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: defi
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.2.0
+        version: 3.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.2.0
+        version: 3.3.0
 - !ruby/object:Gem::Dependency
   name: spectus
   requirement: !ruby/object:Gem::Requirement
@@ -122,20 +122,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: rubocop-rspec
-  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: rubocop-thread_safety
   requirement: !ruby/object:Gem::Requirement