fix 1.0.0.beta3 → 1.0.0.beta7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d55ef5f2323d4329f5b62fa981130fc4027f72a44aedb4cedc1d60a8f6482a8c
-  data.tar.gz: 4f19f7567567c70f180a1cc3cfbcbad8f907dd16154a815d1395b1fb22a3c18d
+  metadata.gz: 81f6a38942f7037e0250876038e1a715b9b905d5fb2186fb1b3dc3884ebee446
+  data.tar.gz: 76f805fc42a2683236ed85efbc888c25fadfaeb2f975177127101e4eb8ae2618
 SHA512:
-  metadata.gz: e14033e214c24666156eed3c3c4f29699bb40c4f6404dd1ab1b8c50b626d3db36ae7986cb29cba180ca0aaac1d80f677b6750693870e9932dbe98c51e01964d9
-  data.tar.gz: bf125f159f6f672f3d799c3c67631949d724d71cbd06137644158ac83d54cb9f9957b5e98f9f6676ab7a1381e0f5e74b773fde659bffe7e95a18d150ea9827a4
+  metadata.gz: c0ae0f82dd15aff8f14252631c2c8cf134bd6ce78ba814267f53e7b88a5d84ff2c7d14bb753152f51cea595f46a0284ae58d370e6e50f74fa6c6ec7bb7dcace1
+  data.tar.gz: 983e9f29a66982ab2cfef0548b50c064c0b63605acdb0f055da6f35cfd2153f667bf3d58975f6d274b49101d557149336e3a6c465549cfa3658f758903024617

data/LICENSE.md

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2014-2020 Cyril Kato
+Copyright (c) 2014-2021 Cyril Kato
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,31 +1,44 @@
 # Fix
 
-[![Build Status](https://api.travis-ci.org/fixrb/fix.svg?branch=master)][travis]
-[![Code Climate](https://codeclimate.com/github/fixrb/fix/badges/gpa.svg)][codeclimate]
-[![Gem Version](https://badge.fury.io/rb/fix.svg)][gem]
-[![Inline docs](https://inch-ci.org/github/fixrb/fix.svg?branch=master)][inchpages]
-[![Documentation](https://img.shields.io/:yard-docs-38c800.svg)][rubydoc]
-[![Gitter](https://badges.gitter.im/Join%20Chat.svg)][gitter]
+[![Home](https://img.shields.io/badge/Home-fixrb.dev-00af8b)](https://fixrb.dev/)
+[![Version](https://img.shields.io/github/v/tag/fixrb/fix?label=Version&logo=github)](https://github.com/fixrb/fix/releases)
+[![Yard documentation](https://img.shields.io/badge/Yard-documentation-blue.svg?logo=github)](https://rubydoc.info/github/fixrb/fix/main)
+[![CI](https://github.com/fixrb/fix/workflows/CI/badge.svg?branch=main)](https://github.com/fixrb/fix/actions?query=workflow%3Aci+branch%3Amain)
+[![RuboCop](https://github.com/fixrb/fix/workflows/RuboCop/badge.svg?branch=main)](https://github.com/fixrb/fix/actions?query=workflow%3Arubocop+branch%3Amain)
+[![License](https://img.shields.io/github/license/fixrb/fix?label=License&logo=github)](https://github.com/fixrb/fix/raw/main/LICENSE.md)
 
-> Specing framework for Ruby.
+⚠️ This project is still in the experimental phase. May be used at your own risk.
+
+![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.beta3'
+gem "fix", ">= 1.0.0.beta7"
 ```
 
 And then execute:
 
-    $ bundle
+```sh
+bundle
+```
 
 Or install it yourself as:
 
-    $ gem install fix --pre
+```sh
+gem install fix --pre
+```
 
-## Usage
+## Example
 
 Given this app:
 
@@ -33,59 +46,74 @@ Given this app:
 # examples/duck/app.rb
 class Duck
   def walks
-    'Klop klop!'
+    "Klop klop!"
   end
 
   def swims
-    'Swoosh...'
+    "Swoosh..."
   end
 
   def quacks
-    puts 'Quaaaaaack!'
+    puts "Quaaaaaack!"
   end
 end
 ```
 
-When you run this:
+And this fixed behavior:
 
 ```ruby
 # examples/duck/fix.rb
-require_relative 'app'
-require_relative '../../lib/fix'
 
-@bird = Duck.new
+relative "fix"
+
+Fix :Duck do
+  it SHOULD be_an_instance_of :Duck
 
-Fix(@bird) do
   on :swims do
-    it { MUST eql 'Swoosh...' }
+    it MUST be_an_instance_of :String
+    it MUST eql "Swoosh..."
   end
 
   on :speaks do
-    it { MUST raise_exception NoMethodError }
+    it MUST raise_exception NoMethodError
   end
 
   on :sings do
-    it { MAY eql '♪... ♫...' }
+    it MAY eql "♪... ♫..."
   end
 end
 ```
 
-Then the output should look like this:
+When I run this test:
+
+```ruby
+# examples/duck/test.rb
+
+require_relative "app"
+require_relative "fix"
+
+Fix[:Duck].test { Duck.new }
+```
 
 ```sh
-ruby examples/duck/fix.rb
+ruby examples/duck/test.rb
 ```
 
+I should see this output:
+
 ```txt
-examples/duck/fix.rb:8: Success: expected to eql "Swoosh...".
-examples/duck/fix.rb:12: Success: undefined method `speaks' for #<Duck:0x00007fe3be868ea0>.
-examples/duck/fix.rb:16: NoMethodError: undefined method `sings' for #<Duck:0x00007fe3be868ea0>.
+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>.
 ```
 
 ## Contact
 
-* Home page: https://fixrb.dev/
-* Source code: https://github.com/fixrb/fix
+* Home page: [https://fixrb.dev/](https://fixrb.dev/)
+* Source code: [https://github.com/fixrb/fix](https://github.com/fixrb/fix)
+* API Doc: [https://rubydoc.info/gems/fix](https://rubydoc.info/gems/fix)
+* Twitter: [https://twitter.com/fix\_rb](https://twitter.com/fix\_rb)
 
 ## Versioning
 
@@ -93,20 +121,13 @@ __Fix__ 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/fix) is available as open source under the terms of the [MIT License](https://github.com/fixrb/fix/raw/main/LICENSE.md).
 
 ***
 
 <p>
   This project is sponsored by:<br />
   <a href="https://sashite.com/"><img
-    src="https://github.com/fixrb/fix/raw/master/img/sashite.png"
+    src="https://github.com/fixrb/fix/raw/main/img/sashite.png"
     alt="Sashite" /></a>
 </p>
-
-[travis]: https://travis-ci.org/fixrb/fix
-[codeclimate]: https://codeclimate.com/github/fixrb/fix
-[gem]: https://rubygems.org/gems/fix
-[inchpages]: https://inch-ci.org/github/fixrb/fix
-[rubydoc]: https://rubydoc.info/gems/fix/frames
-[gitter]: https://gitter.im/fixrb/fix?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge

data/lib/fix.rb

@@ -1,25 +1,22 @@
 # frozen_string_literal: true
 
+require_relative File.join("fix", "set")
+
+require_relative "kernel"
+
 # Namespace for the Fix framework.
 #
+# @api public
 module Fix
-  # Specs are built with this method.
+  # Test a built specification.
   #
-  # @example 42 must be equal to 42
-  #   describe(42) do
-  #     it { MUST equal 42 }
-  #   end
+  # @example Run _Answer_ specification against `42`.
+  #   Fix[:Answer].test(42)
   #
-  # @param front_object [BasicObject] The front object.
-  # @param options      [Hash]        Some options.
-  # @param specs        [Proc]        The set of specs.
+  # @param name [String, Symbol] The name of the specification document.
   #
-  # @raise [SystemExit] The result of the test.
-  def self.describe(front_object, **lets, &block)
-    c = Context.new(front_object, ::Defi.send(:itself), **lets)
-    c.instance_eval(&block)
+  # @return [::Fix::Test] The specification document.
+  def self.[](name)
+    ::Fix::Set.load(name)
   end
 end
-
-require_relative 'kernel'
-require_relative File.join('fix', 'context')

data/lib/fix/doc.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+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

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+require "defi"
+
+require_relative "matcher"
+require_relative "requirement"
+
+module Fix
+  # Abstract class for handling the domain-specific language.
+  #
+  # @api private
+  class Dsl
+    extend Matcher
+    extend Requirement
+
+    # Sets a user-defined property.
+    #
+    # @example
+    #   require "fix"
+    #
+    #   Fix do
+    #     let(:name) { "Bob" }
+    #   end
+    #
+    # @param name   [String, Symbol] The name of the property.
+    # @param block  [Proc] The content of the method to define.
+    #
+    # @return [Symbol] A private method that define the block content.
+    #
+    # @api public
+    def self.let(name, &block)
+      private define_method(name, &block)
+    end
+
+    # Defines an example group with user-defined properties that describes a
+    # unit to be tested.
+    #
+    # @example
+    #   require "fix"
+    #
+    #   Fix do
+    #     with :password, "secret" do
+    #       it MUST be true
+    #     end
+    #   end
+    #
+    # @param kwargs [Hash] The list of propreties.
+    # @param block [Proc] The block to define the specs.
+    #
+    # @api public
+    def self.with(**kwargs, &block)
+      klass = ::Class.new(self)
+      klass.const_get(:CONTEXTS) << klass
+      kwargs.each { |name, value| klass.let(name) { value } }
+      klass.instance_eval(&block)
+      klass
+    end
+
+    # Defines an example group that describes a unit to be tested.
+    #
+    # @example
+    #   require "fix"
+    #
+    #   Fix do
+    #     on :+, 2 do
+    #       it MUST be 42
+    #     end
+    #   end
+    #
+    # @param method_name [String, Symbol] The method to send to the subject.
+    # @param block [Proc] The block to define the specs.
+    #
+    # @api public
+    def self.on(method_name, *args, **kwargs, &block)
+      klass = ::Class.new(self)
+      klass.const_get(:CONTEXTS) << klass
+
+      const_set("Child#{block.object_id}", klass)
+
+      klass.define_singleton_method(:challenges) do
+        challenge = ::Defi.send(method_name, *args, **kwargs)
+        super() + [challenge]
+      end
+
+      klass.instance_eval(&block)
+      klass
+    end
+
+    # Defines a concrete spec definition.
+    #
+    # @example
+    #   require "fix"
+    #
+    #   Fix { it MUST be 42 }
+    #
+    # @api public
+    def self.it(requirement)
+      location = caller_locations(1, 1).fetch(0)
+      location = [location.path, location.lineno].join(":")
+
+      define_method("test_#{requirement.object_id}") do
+        [location, requirement, self.class.challenges]
+      end
+    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
+  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

@@ -1,9 +1,36 @@
 # frozen_string_literal: true
 
+require_relative File.join("fix", "doc")
+require_relative File.join("fix", "dsl")
+require_relative File.join("fix", "set")
+
+# The Kernel module.
 module Kernel
   # rubocop:disable Naming/MethodName
-  def Fix(subject = nil, **lets, &block)
-    ::Fix.describe(subject, **lets, &block)
+
+  # Specifications are built with this method.
+  #
+  # @example Require an answer equal to 42.
+  #   # The spec
+  #   Fix :Answer do
+  #     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 [#test] The collection of specifications.
+  #
+  # @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::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.beta3
+  version: 1.0.0.beta7
 platform: ruby
 authors:
 - Cyril Kato
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-01-15 00:00:00.000000000 Z
+date: 2021-07-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: defi
@@ -16,70 +16,84 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.4
+        version: 2.0.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.4
+        version: 2.0.5
+- !ruby/object:Gem::Dependency
+  name: matchi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.2.0
 - !ruby/object:Gem::Dependency
   name: spectus
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.1.2
+        version: 4.0.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.1.2
+        version: 4.0.2
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '13.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '13.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: rubocop
+  name: rubocop-md
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.79'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.79'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rubocop-performance
   requirement: !ruby/object:Gem::Requirement
@@ -94,35 +108,77 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  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-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
+    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: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.17'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.17'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.9'
-description: Specing framework for Ruby.
+        version: '0'
+description: Specing framework.
 email: contact@cyril.email
 executables: []
 extensions: []
@@ -131,16 +187,21 @@ files:
 - LICENSE.md
 - README.md
 - lib/fix.rb
-- lib/fix/context.rb
-- lib/fix/expectation_result_not_found_error.rb
-- lib/fix/it.rb
-- lib/fix/suspicious_success_error.rb
+- lib/fix/doc.rb
+- lib/fix/dsl.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/fix
   source_code_uri: https://github.com/fixrb/fix
+  wiki_uri: https://github.com/fixrb/fix/wiki
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -149,15 +210,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.3.0
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">"
     - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.1.6
 signing_key: 
 specification_version: 4
-summary: Specing framework for Ruby.
+summary: Specing framework.
 test_files: []

data/lib/fix/context.rb

@@ -1,147 +0,0 @@
-# frozen_string_literal: true
-
-require 'aw'
-require 'defi'
-
-module Fix
-  # Wraps the target of challenge.
-  class Context
-    RESERVED_KEYWORDS = %i[
-      alias
-      and
-      begin
-      break
-      case
-      catch
-      class
-      def
-      defined?
-      do
-      else
-      elsif
-      end
-      ensure
-      fail
-      false
-      for
-      if
-      in
-      module
-      next
-      nil
-      not
-      or
-      raise
-      redo
-      rescue
-      retry
-      return
-      self
-      super
-      then
-      throw
-      true
-      undef
-      unless
-      until
-      when
-      while
-      yield
-    ].freeze
-
-    attr_reader :callable
-
-    def initialize(subject, challenge, before_hooks_counter = 0, *hooks, **lets)
-      @subject      = subject
-      @callable     = challenge.to(subject)
-      @before_hooks = hooks[0, before_hooks_counter]
-      @after_hooks  = hooks[before_hooks_counter..-1]
-      @lets         = lets
-    end
-
-    def before(&block)
-      @before_hooks << block
-    end
-
-    def after(&block)
-      @after_hooks << block
-    end
-
-    def let(name, &block)
-      raise ::TypeError, "expected a Symbol, got #{name.class}" unless name.is_a?(::Symbol)
-      raise ::NameError, "wrong method name `#{name}'" unless name.match(/\A[a-z][a-z0-9_]+[?!]?\z/)
-      raise ::NameError, "reserved keyword name `#{name}'" if RESERVED_KEYWORDS.include?(name)
-      raise ::NameError, "reserved method name `#{name}'" if respond_to?(name, true) && !@lets.key?(name)
-
-      @lets.update(name => block.call)
-    rescue ::SystemExit => e
-      raise SuspiciousSuccessError, "attempt `#{name}' to bypass the tests" if e.success?
-      raise e
-    end
-
-    def let!(name, &block)
-      raise ::TypeError, "expected a Symbol, got #{name.class}" unless name.is_a?(::Symbol)
-      raise ::NameError, "wrong method name `#{name}'" unless name.match(/\A[a-z][a-z0-9_]+[?!]?\z/)
-      raise ::NameError, "reserved keyword name `#{name}'" if RESERVED_KEYWORDS.include?(name)
-      raise ::NameError, "reserved method name `#{name}'" if respond_to?(name, true) && !@lets.key?(name)
-
-      @lets.update(name => ::Aw.fork! { block.call })
-    rescue ::SystemExit => e
-      raise SuspiciousSuccessError, "attempt `#{name}' to bypass the tests" if e.success?
-      raise e
-    end
-
-    # Verify the expectation.
-    #
-    # @param block [Proc] A spec to compare against the computed actual value.
-    #
-    # @return [::Spectus::Result::Pass, ::Spectus::Result::Fail] Pass or fail.
-    def it(_message = nil, &block)
-      print "#{block.source_location.join(':')}: "
-      i = It.new(callable, **@lets)
-      @before_hooks.each { |hook| i.instance_eval(&hook) }
-      result = i.instance_eval(&block)
-      puts result.colored_string
-    rescue ::Spectus::Result::Fail => result
-      abort result.colored_string
-    ensure
-      @after_hooks.each { |hook| i.instance_eval(&hook) }
-      raise ExpectationResultNotFoundError, result.class.inspect unless result.is_a?(::Spectus::Result::Common)
-    end
-
-    def on(name, *args, **options, &block)
-      if callable.raised?
-        actual    = callable
-        challenge = ::Defi.send(:call)
-      else
-        actual    = callable.object
-        challenge = ::Defi.send(name, *args, **options)
-      end
-
-      o = Context.new(actual, challenge, @before_hooks.length, *@before_hooks + @after_hooks, **@lets)
-      o.instance_eval(&block)
-    end
-
-    def with(_message = nil, **new_lets, &block)
-      actual    = callable.object
-      challenge = ::Defi.send(:itself)
-
-      c = Context.new(actual, challenge, @before_hooks.length, *@before_hooks + @after_hooks, **@lets.merge(new_lets))
-      c.instance_eval(&block)
-    end
-
-    private
-
-    def method_missing(name, *args, &block)
-      @lets.fetch(name) { super }
-    end
-
-    def respond_to_missing?(name, include_private = false)
-      @lets.key?(name) || super
-    end
-  end
-end
-
-require_relative 'it'
-require_relative 'expectation_result_not_found_error'
-require_relative 'suspicious_success_error'

data/lib/fix/expectation_result_not_found_error.rb

@@ -1,5 +0,0 @@
-# frozen_string_literal: true
-
-module Fix
-  class ExpectationResultNotFoundError < ::RuntimeError; end
-end

data/lib/fix/it.rb

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-
-require 'spectus/expectation_target'
-require 'matchi/helper'
-
-module Fix
-  # Wraps the target of an expectation.
-  class It < ::Spectus::ExpectationTarget
-    include ::Matchi::Helper
-
-    # Create a new expection target
-    #
-    # @param callable [#call] The object to test.
-    def initialize(callable, **lets)
-      raise unless callable.respond_to?(:call)
-
-      @callable = callable
-      @lets     = lets
-    end
-
-    private
-
-    def method_missing(name, *args, &block)
-      @lets.fetch(name) { super }
-    end
-
-    def respond_to_missing?(name, include_private = false)
-      @lets.key?(name) || super
-    end
-  end
-end

data/lib/fix/suspicious_success_error.rb

@@ -1,5 +0,0 @@
-# frozen_string_literal: true
-
-module Fix
-  class SuspiciousSuccessError < ::StandardError; end
-end