fix 1.0.0.beta6 → 1.0.0.beta7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 361429a943a5149aeea4da4dd83150360db392275ec4d9d98e76969e60768dce
-  data.tar.gz: 6df8aaff424652d4e73cb163cc1dfd973c9a4a03ec2e2d6e351db5f87b0674a8
+  metadata.gz: 81f6a38942f7037e0250876038e1a715b9b905d5fb2186fb1b3dc3884ebee446
+  data.tar.gz: 76f805fc42a2683236ed85efbc888c25fadfaeb2f975177127101e4eb8ae2618
 SHA512:
-  metadata.gz: 24a1c58a8e0db0ef62d97881eabc8a4ff0596d82c96f1dee40fc68edffdc17f0206c6d45aa11040e3b11af35038df58ee7bca1f6190330f91b1b384304dcc304
-  data.tar.gz: 0a5ff783abf6bce80c8ff4a3e3f2e938c004bf5cd02e8300f56650e6312638e911638ed41c9293047aa757ae73048cd412bae5b6cc031e43bab82a2f4b92e41c
+  metadata.gz: c0ae0f82dd15aff8f14252631c2c8cf134bd6ce78ba814267f53e7b88a5d84ff2c7d14bb753152f51cea595f46a0284ae58d370e6e50f74fa6c6ec7bb7dcace1
+  data.tar.gz: 983e9f29a66982ab2cfef0548b50c064c0b63605acdb0f055da6f35cfd2153f667bf3d58975f6d274b49101d557149336e3a6c465549cfa3658f758903024617

data/README.md

@@ -9,14 +9,21 @@
 
 ⚠️ This project is still in the experimental phase. May be used at your own risk.
 
-![Fix specing framework for Ruby](https://github.com/fixrb/fix/raw/main/img/fix.jpg)
+![Fix specing framework for Ruby](https://fixrb.dev/fix.webp)
+
+## Project goals
+
+* Extract specs from the tests.
+* Look like English documents.
+* Be minimalist and easy to hack.
+* Run tests quickly.
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
 ```ruby
-gem "fix", ">= 1.0.0.beta6"
+gem "fix", ">= 1.0.0.beta7"
 ```
 
 And then execute:
@@ -60,9 +67,10 @@ And this fixed behavior:
 relative "fix"
 
 Fix :Duck do
-  it MUST be_an_instance_of :Duck
+  it SHOULD be_an_instance_of :Duck
 
   on :swims do
+    it MUST be_an_instance_of :String
     it MUST eql "Swoosh..."
   end
 
@@ -94,15 +102,12 @@ ruby examples/duck/test.rb
 I should see this output:
 
 ```txt
-NoMethodError: undefined method `sings' for #<Duck:0x00007fc5289bcf68>.
+Success: expected #<Duck:0x00007fc55b3c6388> to be an instance of Duck.
 Success: expected to eql "Swoosh...".
-Success: undefined method `speaks' for #<Duck:0x00007fc5289bcf68>.
+Success: undefined method `speaks' for #<Duck:0x00007fc55b3c46f0>.
+NoMethodError: undefined method `sings' for #<Duck:0x00007fc558aab6d8>.
 ```
 
-## Test suite
-
-__Fix__'s specifications will be [fixed here](https://github.com/fixrb/fix/blob/main/fix/) and will be tested against __Fix__'s codebase executing [test/*](https://github.com/fixrb/fix/blob/main/test/)'s files.
-
 ## Contact
 
 * Home page: [https://fixrb.dev/](https://fixrb.dev/)

data/lib/fix.rb

@@ -1,24 +1,22 @@
 # frozen_string_literal: true
 
-require_relative File.join("fix", "doc")
-require_relative File.join("fix", "test")
+require_relative File.join("fix", "set")
 
 require_relative "kernel"
 
 # Namespace for the Fix framework.
+#
+# @api public
 module Fix
   # Test a built specification.
   #
   # @example Run _Answer_ specification against `42`.
-  #   Fix[:Answer].call(42)
-  #
-  # @example Test _Answer_ specification against `42`.
-  #   Fix[:Answer].matches? { 42 }
+  #   Fix[:Answer].test(42)
   #
   # @param name [String, Symbol] The name of the specification document.
   #
-  # @return [::Fix::Dsl] The specification document.
+  # @return [::Fix::Test] The specification document.
   def self.[](name)
-    Test.new(*Doc.const_get(name).const_get(:CONTEXTS))
+    ::Fix::Set.load(name)
   end
 end

data/lib/fix/doc.rb

@@ -2,6 +2,23 @@
 
 module Fix
   # Module for storing spec documents.
+  #
+  # @api private
   module Doc
+    # @param name [String, Symbol] The name of the specification document.
+    def self.fetch(name)
+      const_get("#{name}::CONTEXTS")
+    end
+
+    # @param contexts [Array<::Fix::Dsl>] The list of contexts document.
+    def self.specs(*contexts)
+      contexts.flat_map do |context|
+        env = context.new
+
+        env.public_methods(false).map do |public_method|
+          [env] + env.public_send(public_method)
+        end
+      end
+    end
   end
 end

data/lib/fix/dsl.rb

@@ -1,15 +1,17 @@
 # frozen_string_literal: true
 
 require "defi"
-require "matchi/helper"
-require "spectus"
 
-require_relative "test"
+require_relative "matcher"
+require_relative "requirement"
 
 module Fix
   # Abstract class for handling the domain-specific language.
+  #
+  # @api private
   class Dsl
-    include ::Matchi::Helper
+    extend Matcher
+    extend Requirement
 
     # Sets a user-defined property.
     #
@@ -38,7 +40,7 @@ module Fix
     #
     #   Fix do
     #     with :password, "secret" do
-    #       it MUST equal true
+    #       it MUST be true
     #     end
     #   end
     #
@@ -76,16 +78,8 @@ module Fix
       const_set("Child#{block.object_id}", klass)
 
       klass.define_singleton_method(:challenges) do
-        super() + [::Defi.send(method_name, *args, **kwargs)]
-      end
-
-      def klass.initialize
-        if subject.raised?
-          subject
-        else
-          challenge = ::Defi.send(method_name, *args, **kwargs)
-          challenge.to(subject.call)
-        end
+        challenge = ::Defi.send(method_name, *args, **kwargs)
+        super() + [challenge]
       end
 
       klass.instance_eval(&block)
@@ -97,68 +91,23 @@ module Fix
     # @example
     #   require "fix"
     #
-    #   Fix { it MUST equal 42 }
+    #   Fix { it MUST be 42 }
     #
     # @api public
     def self.it(requirement)
-      define_method("test_#{requirement.object_id}") { requirement }
-    end
-
-    # @todo Move this method inside "fix-its" gem.
-    def self.its(method_name, requirement)
-      klass = ::Class.new(self)
-      klass.const_get(:CONTEXTS) << klass
-
-      const_set("Child#{requirement.object_id}", klass)
+      location = caller_locations(1, 1).fetch(0)
+      location = [location.path, location.lineno].join(":")
 
-      klass.define_singleton_method(:challenges) do
-        super() + [::Defi.send(method_name)]
-      end
-
-      def klass.initialize
-        if subject.raised?
-          subject
-        else
-          challenge = ::Defi.send(method_name, *args, **kwargs)
-          challenge.to(subject.call)
-        end
+      define_method("test_#{requirement.object_id}") do
+        [location, requirement, self.class.challenges]
       end
-
-      klass.it(requirement)
     end
 
+    # The list of challenges to be addressed to the object to be tested.
+    #
+    # @return [Array<Defi::Challenge>] A list of challenges.
     def self.challenges
       []
     end
-
-    def self.test(&subject)
-      Test.new(self).test(&subject)
-    end
-
-    private_class_method :challenges
-
-    private
-
-    attr_reader :subject
-
-    def initialize(&subject)
-      @subject = ::Defi::Value.new(&subject)
-    end
-
-    ::Matchi::Matcher.constants.each do |matcher_const|
-      next if matcher_const.equal?(:Base)
-
-      matcher_klass = ::Matchi::Matcher.const_get(matcher_const)
-
-      define_singleton_method(matcher_klass.to_sym) do |*args|
-        matcher_klass.new(*args)
-      end
-    end
-
-    ::Spectus.methods(false).each do |method_name|
-      define_singleton_method(method_name.upcase) do |matcher|
-        ::Spectus.public_send(method_name, matcher)
-      end
-    end
   end
 end

data/lib/fix/matcher.rb

@@ -0,0 +1,209 @@
+# frozen_string_literal: true
+
+require "matchi"
+
+module Fix
+  # Collection of expectation matchers.
+  #
+  # @api private
+  module Matcher
+    # Equivalence matcher
+    #
+    # @example
+    #   matcher = eq("foo")
+    #   matcher.matches? { "foo" } # => true
+    #   matcher.matches? { "bar" } # => false
+    #
+    # @param expected [#eql?] An expected equivalent object.
+    #
+    # @return [#matches?] An equivalence matcher.
+    #
+    # @api public
+    def eq(expected)
+      ::Matchi::Eq.new(expected)
+    end
+
+    alias eql eq
+
+    # Identity matcher
+    #
+    # @example
+    #   object = "foo"
+    #   matcher = be(object)
+    #   matcher.matches? { object } # => true
+    #   matcher.matches? { "foo" } # => false
+    #
+    # @param expected [#equal?] The expected identical object.
+    #
+    # @return [#matches?] An identity matcher.
+    #
+    # @api public
+    def be(expected)
+      ::Matchi::Be.new(expected)
+    end
+
+    alias equal be
+
+    # Comparisons matcher
+    #
+    # @example
+    #   matcher = be_within(1).of(41)
+    #   matcher.matches? { 42 } # => true
+    #   matcher.matches? { 43 } # => false
+    #
+    # @param delta [Numeric] A numeric value.
+    #
+    # @return [#matches?] A comparison matcher.
+    #
+    # @api public
+    def be_within(delta)
+      ::Matchi::BeWithin.new(delta)
+    end
+
+    # Regular expressions matcher
+    #
+    # @example
+    #   matcher = match(/^foo$/)
+    #   matcher.matches? { "foo" } # => true
+    #   matcher.matches? { "bar" } # => false
+    #
+    # @param expected [#match] A regular expression.
+    #
+    # @return [#matches?] A regular expression matcher.
+    #
+    # @api public
+    def match(expected)
+      ::Matchi::Match.new(expected)
+    end
+
+    # Expecting errors matcher
+    #
+    # @example
+    #   matcher = raise_exception(NameError)
+    #   matcher.matches? { Boom } # => true
+    #   matcher.matches? { true } # => false
+    #
+    # @param expected [Exception, #to_s] The expected exception name.
+    #
+    # @return [#matches?] An error matcher.
+    #
+    # @api public
+    def raise_exception(expected)
+      ::Matchi::RaiseException.new(expected)
+    end
+
+    # True matcher
+    #
+    # @example
+    #   matcher = be_true
+    #   matcher.matches? { true } # => true
+    #   matcher.matches? { false } # => false
+    #   matcher.matches? { nil } # => false
+    #   matcher.matches? { 4 } # => false
+    #
+    # @return [#matches?] A `true` matcher.
+    #
+    # @api public
+    def be_true
+      be(true)
+    end
+
+    # False matcher
+    #
+    # @example
+    #   matcher = be_false
+    #   matcher.matches? { false } # => true
+    #   matcher.matches? { true } # => false
+    #   matcher.matches? { nil } # => false
+    #   matcher.matches? { 4 } # => false
+    #
+    # @return [#matches?] A `false` matcher.
+    #
+    # @api public
+    def be_false
+      be(false)
+    end
+
+    # Nil matcher
+    #
+    # @example
+    #   matcher = be_nil
+    #   matcher.matches? { nil } # => true
+    #   matcher.matches? { false } # => false
+    #   matcher.matches? { true } # => false
+    #   matcher.matches? { 4 } # => false
+    #
+    # @return [#matches?] A `nil` matcher.
+    #
+    # @api public
+    def be_nil
+      be(nil)
+    end
+
+    # Type/class matcher
+    #
+    # @example
+    #   matcher = be_an_instance_of(String)
+    #   matcher.matches? { "foo" } # => true
+    #   matcher.matches? { 4 } # => false
+    #
+    # @param expected [Class, #to_s] The expected class name.
+    #
+    # @return [#matches?] A type/class matcher.
+    #
+    # @api public
+    def be_an_instance_of(expected)
+      ::Matchi::BeAnInstanceOf.new(expected)
+    end
+
+    # Change matcher
+    #
+    # @example
+    #   object = []
+    #   matcher = change(object, :length).by(1)
+    #   matcher.matches? { object << 1 } # => true
+    #
+    #   object = []
+    #   matcher = change(object, :length).by_at_least(1)
+    #   matcher.matches? { object << 1 } # => true
+    #
+    #   object = []
+    #   matcher = change(object, :length).by_at_most(1)
+    #   matcher.matches? { object << 1 } # => true
+    #
+    #   object = "foo"
+    #   matcher = change(object, :to_s).from("foo").to("FOO")
+    #   matcher.matches? { object.upcase! } # => true
+    #
+    #   object = "foo"
+    #   matcher = change(object, :to_s).to("FOO")
+    #   matcher.matches? { object.upcase! } # => true
+    #
+    # @param object [#object_id]  An object.
+    # @param method [Symbol]      The name of a method.
+    # @param args   [Array]       A list of arguments.
+    # @param kwargs [Hash]        A list of keyword arguments.
+    #
+    # @return [#matches?] A change matcher.
+    #
+    # @api public
+    def change(object, method, *args, **kwargs, &block)
+      ::Matchi::Change.new(object, method, *args, **kwargs, &block)
+    end
+
+    # Satisfy matcher
+    #
+    # @example
+    #   matcher = satisfy { |value| value == 42 }
+    #   matcher.matches? { 42 } # => true
+    #
+    # @param expected [Proc] A block of code.
+    #
+    # @return [#matches?] A satisfy matcher.
+    #
+    # @api public
+    def satisfy(&expected)
+      ::Matchi::Satisfy.new(&expected)
+    end
+  end
+end

data/lib/fix/requirement.rb

@@ -0,0 +1,162 @@
+# frozen_string_literal: true
+
+require "spectus/requirement/optional"
+require "spectus/requirement/recommended"
+require "spectus/requirement/required"
+
+module Fix
+  # Collection of expectation matchers.
+  #
+  # @api private
+  module Requirement
+    # rubocop:disable Naming/MethodName
+
+    # This method mean that the definition is an absolute requirement of the
+    # specification.
+    #
+    # @param matcher [#matches?] The matcher.
+    #
+    # @return [Requirement::Required] An absolute requirement level instance.
+    #
+    # @api public
+    def MUST(matcher)
+      ::Spectus::Requirement::Required.new(
+        isolate: false,
+        negate:  false,
+        matcher: matcher
+      )
+    end
+
+    # @see MUST
+    #
+    # @api public
+    def MUST!(matcher)
+      ::Spectus::Requirement::Required.new(
+        isolate: true,
+        negate:  false,
+        matcher: matcher
+      )
+    end
+
+    # This method mean that the definition is an absolute prohibition of the specification.
+    #
+    # @param matcher [#matches?] The matcher.
+    #
+    # @return [Requirement::Required] An absolute prohibition level instance.
+    #
+    # @api public
+    def MUST_NOT(matcher)
+      ::Spectus::Requirement::Required.new(
+        isolate: false,
+        negate:  true,
+        matcher: matcher
+      )
+    end
+
+    # @see MUST_NOT
+    #
+    # @api public
+    def MUST_NOT!(matcher)
+      ::Spectus::Requirement::Required.new(
+        isolate: true,
+        negate:  true,
+        matcher: matcher
+      )
+    end
+
+    # This method mean that there may exist valid reasons in particular
+    # circumstances to ignore a particular item, but the full implications must be
+    # understood and carefully weighed before choosing a different course.
+    #
+    # @param matcher [#matches?] The matcher.
+    #
+    # @return [Requirement::Recommended] A recommended requirement level instance.
+    #
+    # @api public
+    def SHOULD(matcher)
+      ::Spectus::Requirement::Recommended.new(
+        isolate: false,
+        negate:  false,
+        matcher: matcher
+      )
+    end
+
+    # @see SHOULD
+    #
+    # @api public
+    def SHOULD!(matcher)
+      ::Spectus::Requirement::Recommended.new(
+        isolate: true,
+        negate:  false,
+        matcher: matcher
+      )
+    end
+
+    # This method mean that there may exist valid reasons in particular
+    # circumstances when the particular behavior is acceptable or even useful, but
+    # the full implications should be understood and the case carefully weighed
+    # before implementing any behavior described with this label.
+    #
+    # @param matcher [#matches?] The matcher.
+    #
+    # @return [Requirement::Recommended] A not recommended requirement level
+    #   instance.
+    #
+    # @api public
+    def SHOULD_NOT(matcher)
+      ::Spectus::Requirement::Recommended.new(
+        isolate: false,
+        negate:  true,
+        matcher: matcher
+      )
+    end
+
+    # @see SHOULD_NOT
+    #
+    # @api public
+    def SHOULD_NOT!(matcher)
+      ::Spectus::Requirement::Recommended.new(
+        isolate: true,
+        negate:  true,
+        matcher: matcher
+      )
+    end
+
+    # This method mean that an item is truly optional.
+    # One vendor may choose to include the item because a particular marketplace
+    # requires it or because the vendor feels that it enhances the product while
+    # another vendor may omit the same item. An implementation which does not
+    # include a particular option must be prepared to interoperate with another
+    # implementation which does include the option, though perhaps with reduced
+    # functionality. In the same vein an implementation which does include a
+    # particular option must be prepared to interoperate with another
+    # implementation which does not include the option (except, of course, for the
+    # feature the option provides).
+    #
+    # @param matcher [#matches?] The matcher.
+    #
+    # @return [Requirement::Optional] An optional requirement level instance.
+    #
+    # @api public
+    def MAY(matcher)
+      ::Spectus::Requirement::Optional.new(
+        isolate: false,
+        negate:  false,
+        matcher: matcher
+      )
+    end
+
+    # @see MAY
+    #
+    # @api public
+    def MAY!(matcher)
+      ::Spectus::Requirement::Optional.new(
+        isolate: true,
+        negate:  false,
+        matcher: matcher
+      )
+    end
+
+    # rubocop:enable Naming/MethodName
+  end
+end

data/lib/fix/run.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require "expresenter/fail"
+
+module Fix
+  # Run class.
+  #
+  # @api private
+  class Run
+    # @return [::Fix::Dsl] A context instance.
+    attr_reader :environment
+
+    # @return [::Spectus::Requirement::Base] An expectation.
+    attr_reader :requirement
+
+    # @return [Array<::Defi::Challenge>] A list of challenges.
+    attr_reader :challenges
+
+    # @param environment  [::Fix::Dsl]                    A context instance.
+    # @param requirement  [::Spectus::Requirement::Base]  An expectation.
+    # @param challenges   [Array<::Defi::Challenge>]      A list of challenges.
+    def initialize(environment, requirement, *challenges)
+      @environment = environment
+      @requirement = requirement
+      @challenges  = challenges
+    end
+
+    # Verify if the object checks the condition.
+    #
+    # @param subject [Proc] The block of code to be tested.
+    #
+    # @raise [::Expresenter::Fail] A failed spec exception.
+    # @return [::Expresenter::Pass] A passed spec instance.
+    #
+    # @see https://github.com/fixrb/expresenter
+    def against(&subject)
+      requirement.call { actual_value(&subject) }
+    rescue ::Expresenter::Fail => e
+      e
+    end
+
+    private
+
+    # The test's actual value.
+    #
+    # @param subject [Proc] The block of code to be tested.
+    #
+    # @return [#object_id] The actual value to be tested.
+    def actual_value(&subject)
+      challenges.inject(environment.instance_eval(&subject)) do |obj, challenge|
+        challenge.to(obj).call
+      end
+    end
+  end
+end

data/lib/fix/set.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+require_relative "doc"
+require_relative "run"
+
+module Fix
+  # Collection of specifications.
+  #
+  # @api private
+  class Set
+    # The type of result.
+    #
+    # Passed expectations can be classified as:
+    #
+    #  * `success`
+    #  * `warning`
+    #  * `info`
+    #
+    # Failed expectations can be classified as:
+    #
+    #  * `failure`
+    #  * `error`
+    LOG_LEVELS = %w[
+      none
+      error
+      failure
+      warning
+      info
+      success
+    ].freeze
+
+    # @return [Array] A list of specifications.
+    attr_reader :specs
+
+    # @param name [String, Symbol] The name of the specification document.
+    #
+    # @api public
+    def self.load(name)
+      new(*Doc.fetch(name))
+    end
+
+    # @param contexts [Array<::Fix::Dsl>] The list of contexts document.
+    def initialize(*contexts)
+      @specs  = Doc.specs(*contexts)
+      @passed = true
+    end
+
+    # @param subject [Proc] The block of code to be tested.
+    #
+    # @raise [::SystemExit] The result of the test.
+    #
+    # @api public
+    def test(log_level: 5, &subject)
+      randomize!
+
+      specs.each do |environment, location, requirement, challenges|
+        runner = Run.new(environment, requirement, *challenges)
+        result = runner.against(&subject)
+
+        failed! if result.failed?
+        report!(location, result, log_level: log_level)
+      end
+
+      exit!
+    end
+
+    private
+
+    def randomize!
+      specs.shuffle!
+    end
+
+    # @raise [::SystemExit] The result of the test.
+    def exit!
+      ::Kernel.exit(passed?)
+    end
+
+    def failed!
+      @passed = false
+    end
+
+    # @return [Boolean] The test set passed or failed.
+    def passed?
+      @passed
+    end
+
+    def report!(path, result, log_level:)
+      return unless report?(result, log_level: log_level)
+
+      puts "#{path} #{result.colored_string}"
+    end
+
+    def report?(result, log_level:)
+      LOG_LEVELS[1..log_level].any? { |name| result.public_send("#{name}?") }
+    end
+  end
+end

data/lib/kernel.rb

@@ -2,31 +2,35 @@
 
 require_relative File.join("fix", "doc")
 require_relative File.join("fix", "dsl")
-require_relative File.join("fix", "test")
+require_relative File.join("fix", "set")
 
 # The Kernel module.
 module Kernel
+  # rubocop:disable Naming/MethodName
+
   # Specifications are built with this method.
   #
-  # @example Fix 42 such as it must be equal to 42.
+  # @example Require an answer equal to 42.
+  #   # The spec
   #   Fix :Answer do
-  #     it { MUST equal 42 }
+  #     it MUST equal 42
   #   end
   #
+  #   # A test
+  #   Fix[:Answer].test { 42 }
+  #
   # @param name   [String, Symbol]  The name of the specification document.
   # @param block  [Proc]            The specifications.
   #
-  # @return [Class] The specification document.
+  # @return [#test] The collection of specifications.
   #
-  # rubocop:disable Naming/MethodName
+  # @api public
   def Fix(name = nil, &block)
     klass = ::Class.new(::Fix::Dsl)
     klass.const_set(:CONTEXTS, [klass])
     klass.instance_eval(&block)
-
     ::Fix::Doc.const_set(name, klass) unless name.nil?
-
-    ::Fix::Test.new(*klass.const_get(:CONTEXTS))
+    ::Fix::Set.new(*klass.const_get(:CONTEXTS))
   end
   # rubocop:enable Naming/MethodName
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fix
 version: !ruby/object:Gem::Version
-  version: 1.0.0.beta6
+  version: 1.0.0.beta7
 platform: ruby
 authors:
 - Cyril Kato
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-18 00:00:00.000000000 Z
+date: 2021-07-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: defi
@@ -30,28 +30,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.2.0
+        version: 3.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.2.0
+        version: 3.2.0
 - !ruby/object:Gem::Dependency
   name: spectus
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: 4.0.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: 4.0.2
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -178,7 +178,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Specing framework for Ruby.
+description: Specing framework.
 email: contact@cyril.email
 executables: []
 extensions: []
@@ -187,17 +187,19 @@ files:
 - LICENSE.md
 - README.md
 - lib/fix.rb
-- lib/fix/console.rb
 - lib/fix/doc.rb
 - lib/fix/dsl.rb
-- lib/fix/test.rb
+- lib/fix/matcher.rb
+- lib/fix/requirement.rb
+- lib/fix/run.rb
+- lib/fix/set.rb
 - lib/kernel.rb
 homepage: https://fixrb.dev/
 licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/fixrb/fix/issues
-  documentation_uri: https://rubydoc.info/gems/r_spec-clone
+  documentation_uri: https://rubydoc.info/gems/fix
   source_code_uri: https://github.com/fixrb/fix
   wiki_uri: https://github.com/fixrb/fix/wiki
 post_install_message: 
@@ -218,5 +220,5 @@ requirements: []
 rubygems_version: 3.1.6
 signing_key: 
 specification_version: 4
-summary: Specing framework for Ruby.
+summary: Specing framework.
 test_files: []

data/lib/fix/console.rb

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-module Fix
-  # Send log messages to the console.
-  module Console
-    # @param report [::Expresenter::Pass] Passed expectation result presenter.
-    #
-    # @see https://github.com/fixrb/expresenter
-    #
-    # @return [nil] Add a colored message to `$stdout`.
-    def self.passed_spec(report)
-      puts report.colored_string
-    end
-
-    # @param report [::Expresenter::Fail] Failed expectation result presenter.
-    #
-    # @see https://github.com/fixrb/expresenter
-    #
-    # @raise [SystemExit] Terminate execution immediately with colored message.
-    def self.failed_spec(report)
-      abort report.colored_string
-    end
-  end
-end

data/lib/fix/test.rb

@@ -1,51 +0,0 @@
-# frozen_string_literal: true
-
-require "expresenter/fail"
-
-require_relative "console"
-require_relative "doc"
-
-module Fix
-  # Module for testing spec documents.
-  class Test
-    attr_reader :contexts
-
-    def initialize(*contexts)
-      @contexts = contexts
-    end
-
-    def test(&block)
-      requirements(&block)
-      exit(true)
-    end
-
-    private
-
-    def requirements(&block)
-      contexts.flat_map do |context|
-        sandbox = context.new
-        sandbox.public_methods(false).shuffle.map do |public_method|
-          definition = sandbox.public_send(public_method)
-
-          report = begin
-            definition.call do
-              front_object = instance_eval(&block)
-
-              context.send(:challenges).inject(front_object) do |object, challenge|
-                challenge.to(object).call
-              end
-            end
-          rescue ::Expresenter::Fail => e
-            e
-          end
-
-          if report.passed?
-            Console.passed_spec report
-          else
-            Console.failed_spec report
-          end
-        end
-      end
-    end
-  end
-end