fix 0.18.2 → 0.20

data/lib/fix/set.rb

@@ -0,0 +1,210 @@
+# frozen_string_literal: true
+
+require_relative "doc"
+require_relative "run"
+require_relative "error/missing_subject_block"
+
+module Fix
+  # Collection of specifications that can be executed as a test suite.
+  #
+  # The Set class is a central component in Fix's architecture that handles:
+  # - Loading and organizing test specifications
+  # - Managing test execution and isolation
+  # - Reporting test results
+  # - Handling process management for test isolation
+  #
+  # It supports both named specifications (loaded via Fix[name]) and anonymous
+  # specifications (created directly via Fix blocks).
+  #
+  # @example Running a simple named specification
+  #   Fix[:Calculator].test { Calculator.new }
+  #
+  # @example Running a complex specification with multiple contexts
+  #   Fix[:UserSystem] do
+  #     with(role: "admin") do
+  #       on :access?, :settings do
+  #         it MUST be_true
+  #       end
+  #     end
+  #
+  #     with(role: "guest") do
+  #       on :access?, :settings do
+  #         it MUST be_false
+  #       end
+  #     end
+  #   end.test { UserSystem.new(role:) }
+  #
+  # @example Using match? for conditional testing
+  #   if Fix[:EmailValidator].match? { email }
+  #     puts "Email is valid"
+  #   end
+  #
+  # @api private
+  class Set
+    # List of specifications to be tested.
+    # Each specification is an array containing:
+    # - The test environment
+    # - The source location (file:line)
+    # - The requirement (MUST, SHOULD, or MAY)
+    # - The challenges to apply
+    #
+    # @return [Array] List of specifications
+    attr_reader :expected
+
+    class << self
+      # Loads specifications from a registered constant name.
+      #
+      # This method retrieves previously registered specifications and creates
+      # a new Set instance ready for testing. It's typically used in conjunction
+      # with Fix[name] syntax.
+      #
+      # @param name [String, Symbol] The constant name of the specifications
+      # @return [Set] A new Set instance containing the loaded specifications
+      # @raise [Fix::Error::SpecificationNotFound] If specification doesn't exist
+      #
+      # @example Loading a named specification
+      #   Fix::Set.load(:Calculator)
+      #
+      # @example Loading and testing in one go
+      #   Fix::Set.load(:EmailValidator).test { email }
+      #
+      # @api public
+      def load(name)
+        new(*Doc.fetch(name))
+      end
+    end
+
+    # Initialize a new Set with the given contexts.
+    #
+    # @param contexts [Array<Fix::Dsl>] List of specification contexts
+    #
+    # @example Creating a set with a single context
+    #   Fix::Set.new(calculator_context)
+    #
+    # @example Creating a set with multiple contexts
+    #   Fix::Set.new(base_context, admin_context, guest_context)
+    def initialize(*contexts)
+      @expected = randomize_specs(Doc.extract_specifications(*contexts))
+    end
+
+    # Checks if the subject matches all specifications without exiting.
+    #
+    # Unlike #test, this method:
+    # - Returns a boolean instead of exiting
+    # - Can be used in conditional logic
+    #
+    # @yield The block of code to be tested
+    # @yieldreturn [Object] The result of the code being tested
+    # @return [Boolean] true if all tests pass, false otherwise
+    #
+    # @example Basic usage
+    #   set.match? { Calculator.new } #=> true
+    #
+    # @example Conditional usage
+    #   if set.match? { user_input }
+    #     save_to_database(user_input)
+    #   end
+    #
+    # @api public
+    def match?(&subject)
+      raise Error::MissingSubjectBlock unless subject
+
+      expected.all? { |spec| run_spec(*spec, &subject) }
+    end
+
+    # Runs the test suite against the provided subject.
+    #
+    # This method:
+    # - Executes all specifications in random order
+    # - Runs each test in isolation using process forking
+    # - Reports results for each specification
+    # - Exits with failure if any test fails
+    #
+    # @yield The block of code to be tested
+    # @yieldreturn [Object] The result of the code being tested
+    # @return [Boolean] true if all tests pass
+    # @raise [SystemExit] When any test fails (exit code: 1)
+    #
+    # @example Basic usage
+    #   set.test { Calculator.new }
+    #
+    # @example Testing with parameters
+    #   set.test { Game.new(south_variant:, north_variant:) }
+    #
+    # @api public
+    def test(&subject)
+      match?(&subject) || exit_with_failure
+    end
+
+    # Returns a string representing the matcher.
+    #
+    # @return [String] a human-readable description of the matcher
+    #
+    # @api public
+    def to_s
+      "fix #{expected.inspect}"
+    end
+
+    private
+
+    # Randomizes the order of specifications for better isolation
+    #
+    # @param specifications [Array] The specifications to randomize
+    # @return [Array] Randomized specifications
+    def randomize_specs(specifications)
+      specifications.shuffle
+    end
+
+    # Runs a single specification in a forked process
+    #
+    # @param env [Fix::Dsl] The test environment
+    # @param location [String] The source location of the spec
+    # @param requirement [Object] The test requirement
+    # @param challenges [Array] The test challenges
+    # @yield The subject block to test against
+    # @return [Boolean] true if spec passed
+    def run_spec(env, location, requirement, challenges, &subject)
+      child_pid = ::Process.fork { execute_spec(env, location, requirement, challenges, &subject) }
+      _pid, process_status = ::Process.wait2(child_pid)
+      process_status.success?
+    end
+
+    # Executes a specification in its own process
+    #
+    # @param env [Fix::Dsl] The test environment
+    # @param location [String] The source location of the spec
+    # @param requirement [Object] The test requirement
+    # @param challenges [Array] The test challenges
+    # @yield The subject block to test against
+    def execute_spec(env, location, requirement, challenges, &subject)
+      result = Run.new(env, requirement, *challenges).test(&subject)
+      report_result(location, result)
+      exit_with_status(result.passed?)
+    end
+
+    # Reports the result of a specification
+    #
+    # @param location [String] The source location of the spec
+    # @param result [Object] The test result
+    def report_result(location, result)
+      puts "#{location} #{result.colored_string}"
+    end
+
+    # Exits the process with a failure status
+    #
+    # @return [void]
+    # @raise [SystemExit] Always
+    def exit_with_failure
+      ::Kernel.exit(false)
+    end
+
+    # Exits the process with the given status
+    #
+    # @param status [Boolean] The exit status
+    # @return [void]
+    # @raise [SystemExit] Always
+    def exit_with_status(status)
+      ::Kernel.exit(status)
+    end
+  end
+end

data/lib/fix.rb

@@ -1,28 +1,93 @@
 # frozen_string_literal: true
 
+require_relative "fix/doc"
+require_relative "fix/error/specification_not_found"
+require_relative "fix/set"
+require_relative "kernel"
+
 # Namespace for the Fix framework.
 #
-# @api public
+# Provides core functionality for managing and running test specifications.
+# Fix supports two modes of operation:
+# 1. Named specifications that can be referenced later
+# 2. Anonymous specifications for immediate testing
+#
+# @example Creating and running a named specification
+#   Fix :Answer do
+#     it MUST equal 42
+#   end
+#
+#   Fix[:Answer].test { 42 }
 #
+# @example Creating and running an anonymous specification
+#   Fix do
+#     it MUST be_positive
+#   end.test { 42 }
+#
+# @see Fix::Set
+# @see Fix::Builder
+#
+# @api public
 module Fix
-  # Specs are built with this method.
-  #
-  # @example 42 must be equal to 42
-  #   describe(42) do
-  #     it { MUST equal 42 }
-  #   end
-  #
-  # @param front_object [BasicObject] The front object.
-  # @param options      [Hash]        Some options.
-  # @param specs        [Proc]        The set of specs.
-  #
-  # @raise [SystemExit] The result of the test.
-  def self.describe(front_object, verbose: true, **options, &specs)
-    t = Test.new(front_object, verbose: verbose, **options, &specs)
-
-    print t.report.to_s if verbose
-    exit t.pass?
+  class << self
+    # Retrieves and loads a built specification for testing.
+    #
+    # @example Run a named specification
+    #   Fix[:Answer].test { 42 }
+    #
+    # @param name [String, Symbol] The constant name of the specification
+    # @return [Fix::Set] The loaded specification set ready for testing
+    # @raise [Fix::Error::SpecificationNotFound] If the named specification doesn't exist
+    def [](name)
+      name = normalize_name(name)
+      validate_specification_exists!(name)
+      Set.load(name)
+    end
+
+    # Lists all defined specification names.
+    #
+    # @example Get all specification names
+    #   Fix.specification_names #=> [:Answer, :Calculator, :UserProfile]
+    #
+    # @return [Array<Symbol>] Sorted array of specification names
+    def specification_names
+      Doc.constants.sort
+    end
+
+    # Checks if a specification is defined.
+    #
+    # @example Check for specification existence
+    #   Fix.spec_defined?(:Answer) #=> true
+    #
+    # @param name [String, Symbol] Name of the specification to check
+    # @return [Boolean] true if specification exists, false otherwise
+    def spec_defined?(name)
+      specification_names.include?(normalize_name(name))
+    end
+
+    private
+
+    # Converts any specification name into a symbol.
+    # This allows for consistent name handling regardless of input type.
+    #
+    # @param name [String, Symbol] The name to normalize
+    # @return [Symbol] The normalized name
+    # @example
+    #   normalize_name("Answer") #=> :Answer
+    #   normalize_name(:Answer)  #=> :Answer
+    def normalize_name(name)
+      String(name).to_sym
+    end
+
+    # Verifies the existence of a specification and raises an error if not found.
+    # This ensures early failure when attempting to use undefined specifications.
+    #
+    # @param name [Symbol] The specification name to validate
+    # @raise [Fix::Error::SpecificationNotFound] If specification doesn't exist
+    def validate_specification_exists!(name)
+      return if spec_defined?(name)
+
+      raise Error::SpecificationNotFound, name
+    end
   end
 end
-
-require_relative File.join('fix', 'test')

data/lib/kernel.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require_relative "fix/builder"
+
+# Extension of the global Kernel module to provide the Fix method.
+# This allows Fix to be called from anywhere in the application
+# without explicit namespace qualification.
+#
+# @api public
+module Kernel
+  # rubocop:disable Naming/MethodName
+
+  # This rule is disabled because Fix is intentionally capitalized to act as
+  # both a namespace and a method name, following Ruby conventions for DSLs.
+
+  # Defines a new test specification or creates an anonymous specification set.
+  # When a name is provided, the specification is registered globally and can
+  # be referenced later using Fix[name]. Anonymous specifications are executed
+  # immediately and cannot be referenced later.
+  #
+  # @example Creating a named specification for later use
+  #   Fix :Calculator do
+  #     on(:add, 2, 3) do
+  #       it MUST equal 5
+  #     end
+  #   end
+  #
+  #   # Later in the code:
+  #   Fix[:Calculator].test { Calculator.new }
+  #
+  # @example Creating and immediately testing an anonymous specification
+  #   Fix do
+  #     it MUST be_positive
+  #   end.test { 42 }
+  #
+  # @param name [String, Symbol, nil] The constant name for the specification
+  # @yield The specification definition block
+  # @yieldreturn [void]
+  # @return [Fix::Set] A collection of specifications ready for testing
+  #
+  # @see Fix::Builder
+  # @see Fix::Set
+  # @see Fix::Dsl
+  def Fix(name = nil, &)
+    ::Fix::Builder.build(name, &)
+  end
+
+  # rubocop:enable Naming/MethodName
+end

metadata

@@ -1,204 +1,93 @@
 --- !ruby/object:Gem::Specification
 name: fix
 version: !ruby/object:Gem::Version
-  version: 0.18.2
+  version: '0.20'
 platform: ruby
 authors:
 - Cyril Kato
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2019-10-08 00:00:00.000000000 Z
+date: 2025-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: aw
+  name: defi
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.6
+        version: 3.0.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.6
+        version: 3.0.1
 - !ruby/object:Gem::Dependency
-  name: defi
+  name: matchi
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.5
+        version: 4.1.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.5
+        version: 4.1.1
 - !ruby/object:Gem::Dependency
   name: spectus
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.9
+        version: 5.0.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.9
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.0'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-- !ruby/object:Gem::Dependency
-  name: rubocop
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.75'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.75'
-- !ruby/object:Gem::Dependency
-  name: rubocop-performance
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.5'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.5'
-- !ruby/object:Gem::Dependency
-  name: simplecov
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.17'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.17'
-- !ruby/object:Gem::Dependency
-  name: yard
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-description: Specing framework for Ruby.
-email:
-- contact@cyril.email
+        version: 5.0.2
+description: |
+  Fix is a modern Ruby testing framework built around a key architectural principle:
+  the complete separation between specifications and tests. It allows you to write
+  pure specification documents that define expected behaviors, and then independently
+  challenge any implementation against these specifications.
+email: contact@cyril.email
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".rubocop.yml"
-- ".rubocop_todo.yml"
-- ".travis.yml"
-- ".yardopts"
-- CODE_OF_CONDUCT.md
-- Gemfile
 - LICENSE.md
 - README.md
-- Rakefile
-- VERSION.semver
-- bin/console
-- bin/setup
-- checksum/fix-0.0.1.pre.gem.sha512
-- checksum/fix-0.1.0.gem.sha512
-- checksum/fix-0.1.0.pre.gem.sha512
-- checksum/fix-0.10.0.gem.sha512
-- checksum/fix-0.11.0.gem.sha512
-- checksum/fix-0.11.1.gem.sha512
-- checksum/fix-0.12.0.gem.sha512
-- checksum/fix-0.12.1.gem.sha512
-- checksum/fix-0.12.2.gem.sha512
-- checksum/fix-0.12.3.gem.sha512
-- checksum/fix-0.13.0.gem.sha512
-- checksum/fix-0.14.0.gem.sha512
-- checksum/fix-0.14.1.gem.sha512
-- checksum/fix-0.15.0.gem.sha512
-- checksum/fix-0.15.2.gem.sha512
-- checksum/fix-0.16.0.gem.sha512
-- checksum/fix-0.17.0.gem.sha512
-- checksum/fix-0.17.1.gem.sha512
-- checksum/fix-0.17.2.gem.sha512
-- checksum/fix-0.18.0.gem.sha512
-- checksum/fix-0.18.1.gem.sha512
-- checksum/fix-0.2.0.gem.sha512
-- checksum/fix-0.3.0.gem.sha512
-- checksum/fix-0.4.0.gem.sha512
-- checksum/fix-0.5.0.gem.sha512
-- checksum/fix-0.6.0.gem.sha512
-- checksum/fix-0.6.1.gem.sha512
-- checksum/fix-0.7.0.gem.sha512
-- checksum/fix-0.8.0.gem.sha512
-- checksum/fix-0.9.0.gem.sha512
-- checksum/fix-0.9.1.gem.sha512
-- fix.gemspec
 - lib/fix.rb
-- lib/fix/it.rb
-- lib/fix/on.rb
-- lib/fix/report.rb
-- lib/fix/test.rb
-- pkg_checksum
-homepage: https://github.com/fixrb/fix
+- lib/fix/builder.rb
+- lib/fix/doc.rb
+- lib/fix/dsl.rb
+- lib/fix/error/invalid_specification_name.rb
+- lib/fix/error/missing_specification_block.rb
+- lib/fix/error/missing_subject_block.rb
+- lib/fix/error/specification_not_found.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: {}
-post_install_message: 
+metadata:
+  bug_tracker_uri: https://github.com/fixrb/fix/issues
+  changelog_uri: https://github.com/fixrb/fix/blob/main/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/fix
+  homepage_uri: https://fixrb.dev
+  source_code_uri: https://github.com/fixrb/fix
+  rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -206,15 +95,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 3.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.3.27
+signing_key:
 specification_version: 4
-summary: Specing framework.
+summary: Happy Path to Ruby Testing
 test_files: []

data/.gitignore

@@ -1,11 +0,0 @@
-/.bundle/
-/.ruby-version
-/.yardoc
-/Gemfile.lock
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-.DS_Store

data/.rubocop.yml

@@ -1 +0,0 @@
-inherit_from: .rubocop_todo.yml

data/.rubocop_todo.yml

@@ -1,25 +0,0 @@
-# This configuration was generated by
-# `rubocop --auto-gen-config`
-# on 2019-10-09 00:10:57 +0200 using RuboCop version 0.75.0.
-# The point is for the user to remove these configuration records
-# one by one as the offenses are removed from the code base.
-# Note that changes in the inspected code, or installation of new
-# versions of RuboCop, may require this file to be generated again.
-
-# Offense count: 14
-Style/MixinUsage:
-  Exclude:
-    - 'test/examples/duck/test_app.rb'
-    - 'test/examples/empty/test_app.rb'
-    - 'test/examples/isolation/test_app_with_isolation_1.rb'
-    - 'test/examples/isolation/test_app_with_isolation_2.rb'
-    - 'test/examples/isolation/test_app_with_isolation_3.rb'
-    - 'test/examples/isolation/test_app_with_isolation_4.rb'
-    - 'test/examples/isolation/test_app_with_isolation_5.rb'
-    - 'test/examples/isolation/test_app_without_isolation_1.rb'
-    - 'test/examples/isolation/test_app_without_isolation_2.rb'
-    - 'test/examples/isolation/test_app_without_isolation_3.rb'
-    - 'test/examples/let/test_let.rb'
-    - 'test/examples/operation/test_app_1.rb'
-    - 'test/examples/operation/test_app_2.rb'
-    - 'test/test_exit_status.rb'