fix 0.21 → 1.0.0.beta1

data/lib/fix/it.rb

@@ -0,0 +1,31 @@
+# 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

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

data/lib/fix.rb

@@ -1,179 +1,25 @@
 # frozen_string_literal: true
 
-require_relative "fix/doc"
-require_relative "fix/error/missing_specification_block"
-require_relative "fix/error/specification_not_found"
-require_relative "fix/set"
-require_relative "kernel"
-
-# The Fix framework namespace provides core functionality for managing and running test specifications.
-# Fix offers a unique approach to testing by clearly separating specifications from their implementations.
-#
-# Fix supports two primary modes of operation:
-# 1. Named specifications that can be stored and referenced later
-# 2. Anonymous specifications for immediate one-time testing
-#
-# Available matchers through the Matchi library include:
-# - Basic Comparison: eq, eql, be, equal
-# - Type Checking: be_an_instance_of, be_a_kind_of
-# - State & Changes: change(object, method).by(n), by_at_least(n), by_at_most(n), from(old).to(new), to(new)
-# - Value Testing: be_within(delta).of(value), match(regex), satisfy { |value| ... }
-# - Exceptions: raise_exception(class)
-# - State Testing: be_true, be_false, be_nil
-# - Predicate Matchers: be_*, have_*  (e.g., be_empty, have_key)
-#
-# @example Creating and running a named specification with various matchers
-#   Fix :Calculator do
-#     on(:add, 0.1, 0.2) do
-#       it SHOULD be 0.3                     # Technically true but fails due to floating point precision
-#       it MUST be_an_instance_of(Float)     # Type checking
-#       it MUST be_within(0.0001).of(0.3)    # Proper floating point comparison
-#     end
-#
-#     on(:divide, 1, 0) do
-#       it MUST raise_exception ZeroDivisionError  # Exception testing
-#     end
-#   end
-#
-#   Fix[:Calculator].test { Calculator.new }
-#
-# @example Using state change matchers
-#   Fix :UserAccount do
-#     on(:deposit, 100) do
-#       it MUST change(account, :balance).by(100)
-#       it SHOULD change(account, :updated_at)
-#     end
-#
-#     on(:update_status, :premium) do
-#       it MUST change(account, :status).from(:basic).to(:premium)
-#     end
-#   end
-#
-# @example Using predicate matchers
-#   Fix :Collection do
-#     with items: [] do
-#       it MUST be_empty          # Tests empty?
-#       it MUST_NOT have_errors   # Tests has_errors?
-#     end
-#   end
-#
-# @example Complete specification with multiple matchers
-#   Fix :Product do
-#     let(:price) { 42.99 }
+# Namespace for the Fix framework.
 #
-#     it MUST be_an_instance_of Product     # Type checking
-#     it MUST_NOT be_nil                    # Nil checking
-#
-#     on(:price) do
-#       it MUST be_within(0.01).of(42.99)   # Floating point comparison
-#     end
-#
-#     with category: "electronics" do
-#       it MUST satisfy { |p| p.valid? }    # Custom validation
-#
-#       on(:save) do
-#         it MUST change(product, :updated_at)  # State change
-#         it SHOULD_NOT raise_exception         # Exception checking
-#       end
-#     end
-#   end
-#
-# @see Fix::Set For managing collections of specifications
-# @see Fix::Doc For storing and retrieving specifications
-# @see Fix::Dsl For the domain-specific language used in specifications
-# @see Fix::Matcher For the complete list of available matchers
-#
-# @api public
 module Fix
-  # Creates a new specification set, optionally registering it under a name.
-  #
-  # @param name [Symbol, nil] Optional name to register the specification under.
-  #   If nil, creates an anonymous specification for immediate use.
-  # @yieldreturn [void] Block containing the specification definition using Fix DSL
-  # @return [Fix::Set] A new specification set ready for testing
-  # @raise [Fix::Error::MissingSpecificationBlock] If no block is provided
-  #
-  # @example Create a named specification
-  #   Fix :StringValidator do
-  #     on(:validate, "hello@example.com") do
-  #       it MUST be_valid_email
-  #       it MUST satisfy { |result| result.errors.empty? }
-  #     end
-  #   end
-  #
-  # @example Create an anonymous specification
-  #   Fix do
-  #     it MUST be_positive
-  #     it MUST be_within(0.1).of(42.0)
-  #   end.test { 42 }
-  #
-  # @api public
-  def self.spec(name = nil, &block)
-    raise Error::MissingSpecificationBlock if block.nil?
-
-    Set.build(name, &block)
-  end
-
-  # Retrieves a previously registered specification by name.
-  #
-  # @param name [Symbol] The constant name of the specification to retrieve
-  # @return [Fix::Set] The loaded specification set ready for testing
-  # @raise [Fix::Error::SpecificationNotFound] If the named specification doesn't exist
-  #
-  # @example
-  #   # Define a specification with multiple matchers
-  #   Fix :EmailValidator do
-  #     on(:validate, "test@example.com") do
-  #       it MUST be_valid
-  #       it MUST_NOT raise_exception
-  #       it SHOULD satisfy { |result| result.score > 0.8 }
-  #     end
-  #   end
-  #
-  #   # Later, retrieve and use it
-  #   Fix[:EmailValidator].test { MyEmailValidator }
-  #
-  # @see #spec For creating new specifications
-  # @see Fix::Set#test For running tests against a specification
-  # @see Fix::Matcher For available matchers
-  #
-  # @api public
-  def self.[](name)
-    raise Error::SpecificationNotFound, name unless key?(name)
-
-    Set.load(name)
-  end
-
-  # Lists all defined specification names.
-  #
-  # @return [Array<Symbol>] Sorted array of registered specification names
-  #
-  # @example
-  #   Fix :First do; end
-  #   Fix :Second do; end
-  #
-  #   Fix.keys #=> [:First, :Second]
+  # Specs are built with this method.
   #
-  # @api public
-  def self.keys
-    Doc.constants.sort
-  end
-
-  # Checks if a specification is registered under the given name.
-  #
-  # @param name [Symbol] The name to check for
-  # @return [Boolean] true if a specification exists with this name, false otherwise
-  #
-  # @example
-  #   Fix :Example do
-  #     it MUST be_an_instance_of(Example)
+  # @example 42 must be equal to 42
+  #   describe(42) do
+  #     it { MUST equal 42 }
   #   end
   #
-  #   Fix.key?(:Example)  #=> true
-  #   Fix.key?(:Missing)  #=> false
+  # @param front_object [BasicObject] The front object.
+  # @param options      [Hash]        Some options.
+  # @param specs        [Proc]        The set of specs.
   #
-  # @api public
-  def self.key?(name)
-    keys.include?(name)
+  # @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)
   end
 end
+
+require_relative 'kernel'
+require_relative File.join('fix', 'context')

data/lib/kernel.rb

@@ -1,103 +1,9 @@
 # frozen_string_literal: true
 
-# Extension of the global Kernel module to provide the Fix method.
-# This module provides a global entry point to the Fix testing framework,
-# allowing specifications to be defined and managed from anywhere in the application.
-#
-# The Fix method can be used in two main ways:
-# 1. Creating named specifications for reuse
-# 2. Creating anonymous specifications for immediate testing
-#
-# @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.
-  #
-  # Specifications can use three levels of requirements, following RFC 2119:
-  # - MUST/MUST_NOT: Absolute requirements or prohibitions
-  # - SHOULD/SHOULD_NOT: Strong recommendations that can be ignored with good reason
-  # - MAY: Optional features that can be implemented or not
-  #
-  # Available matchers include:
-  # - Basic Comparison: eq(expected), eql(expected), be(expected), equal(expected)
-  # - Type Checking: be_an_instance_of(class), be_a_kind_of(class)
-  # - State & Changes: change(object, method).by(n), by_at_least(n), by_at_most(n),
-  #                   from(old).to(new), to(new)
-  # - Value Testing: be_within(delta).of(value), match(regex),
-  #                 satisfy { |value| ... }
-  # - Exceptions: raise_exception(class)
-  # - State Testing: be_true, be_false, be_nil
-  # - Predicate Matchers: be_* (e.g., be_empty), have_* (e.g., have_key)
-  #
-  # @example Creating a named specification with multiple contexts and matchers
-  #   Fix :Calculator do
-  #     on(:add, 2, 3) do
-  #       it MUST eq 5
-  #       it MUST be_an_instance_of(Integer)
-  #     end
-  #
-  #     with precision: :high do
-  #       on(:divide, 10, 3) do
-  #         it MUST be_within(0.001).of(3.333)
-  #       end
-  #     end
-  #
-  #     on(:divide, 1, 0) do
-  #       it MUST raise_exception ZeroDivisionError
-  #     end
-  #   end
-  #
-  # @example Creating and immediately testing an anonymous specification
-  #   Fix do
-  #     it MUST be_positive
-  #     it SHOULD be_even
-  #     it MAY be_prime
-  #   end.test { 42 }
-  #
-  # @example Testing state changes
-  #   Fix :Account do
-  #     on(:deposit, 100) do
-  #       it MUST change(account, :balance).by(100)
-  #       it SHOULD change(account, :updated_at)
-  #     end
-  #
-  #     on(:withdraw, 50) do
-  #       it MUST change(account, :balance).by(-50)
-  #       it MUST_NOT change(account, :status)
-  #     end
-  #   end
-  #
-  # @example Using predicates and custom matchers
-  #   Fix :Collection do
-  #     with items: [] do
-  #       it MUST be_empty
-  #       it MUST_NOT have_errors
-  #       it SHOULD satisfy { |c| c.valid? && c.initialized? }
-  #     end
-  #   end
-  #
-  # @param name [Symbol, nil] Optional name to register the specification under
-  # @yield Block containing the specification definition using Fix DSL
-  # @return [Fix::Set] A specification set ready for testing
-  # @raise [Fix::Error::MissingSpecificationBlock] If no block is provided
-  # @raise [Fix::Error::InvalidSpecificationName] If name is not a valid constant name
-  #
-  # @see Fix::Set For managing collections of specifications
-  # @see Fix::Dsl For the domain-specific language used in specifications
-  # @see Fix::Matcher For the complete list of available matchers
-  # @see https://tools.ietf.org/html/rfc2119 For details about requirement levels
-  #
-  # @api public
-  def Fix(name = nil, &block)
-    ::Fix.spec(name, &block)
+  def Fix(subject, **lets, &block)
+    ::Fix.describe(subject, **lets, &block)
   end
-
   # rubocop:enable Naming/MethodName
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fix
 version: !ruby/object:Gem::Version
-  version: '0.21'
+  version: 1.0.0.beta1
 platform: ruby
 authors:
 - Cyril Kato
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-01-03 00:00:00.000000000 Z
+date: 2020-01-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: defi
@@ -16,47 +16,113 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.1
+        version: 2.0.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.1
+        version: 2.0.3
 - !ruby/object:Gem::Dependency
-  name: matchi
+  name: spectus
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.1.1
+        version: 3.1.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.1.1
+        version: 3.1.1
 - !ruby/object:Gem::Dependency
-  name: spectus
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.0.2
-  type: :runtime
+        version: '2.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !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'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-performance
+  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: 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.
+        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
 executables: []
 extensions: []
@@ -65,28 +131,17 @@ files:
 - LICENSE.md
 - README.md
 - lib/fix.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/fix/context.rb
+- lib/fix/expectation_result_not_found_error.rb
+- lib/fix/it.rb
+- lib/fix/suspicious_success_error.rb
 - lib/kernel.rb
 homepage: https://fixrb.dev/
 licenses:
 - MIT
 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:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -94,15 +149,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.0
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
-rubygems_version: 3.3.27
-signing_key:
+rubygems_version: 3.1.2
+signing_key: 
 specification_version: 4
-summary: Happy Path to Ruby Testing
+summary: Specing framework for Ruby.
 test_files: []

data/lib/fix/doc.rb

@@ -1,118 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "error/invalid_specification_name"
-
-module Fix
-  # The Doc module serves as a central registry for storing and managing test specifications.
-  # It provides functionality for:
-  # - Storing specification classes in a structured way
-  # - Managing the lifecycle of specification documents
-  # - Extracting test specifications from context objects
-  # - Validating specification names
-  #
-  # The module acts as a namespace for specifications, allowing them to be:
-  # - Registered with unique names
-  # - Retrieved by name when needed
-  # - Protected from name collisions
-  # - Organized in a hierarchical structure
-  #
-  # @example Registering a new specification
-  #   Fix::Doc.add(:Calculator, calculator_specification_class)
-  #
-  # @example Retrieving specification contexts
-  #   contexts = Fix::Doc.fetch(:Calculator)
-  #   specifications = Fix::Doc.extract_specifications(*contexts)
-  #
-  # @api private
-  module Doc
-    # Retrieves the array of test contexts associated with a named specification.
-    # These contexts define the test environment and requirements for the specification.
-    #
-    # @param name [Symbol] The name of the specification to retrieve
-    # @return [Array<Fix::Dsl>] Array of context classes for the specification
-    # @raise [NameError] If the specification name doesn't exist in the registry
-    #
-    # @example Retrieving contexts for a calculator specification
-    #   contexts = Fix::Doc.fetch(:Calculator)
-    #   contexts.each do |context|
-    #     # Process each context...
-    #   end
-    #
-    # @api private
-    def self.fetch(name)
-      const_get("#{name}::CONTEXTS")
-    end
-
-    # Extracts complete test specifications from a list of context classes.
-    # This method processes contexts to build a list of executable test specifications.
-    #
-    # Each extracted specification contains:
-    # - The test environment
-    # - The source file location
-    # - The requirement level (MUST, SHOULD, or MAY)
-    # - The list of challenges to execute
-    #
-    # @param contexts [Array<Fix::Dsl>] List of context classes to process
-    # @return [Array<Array>] Array of specification arrays where each contains:
-    #   - [0] environment [Fix::Dsl] The test environment instance
-    #   - [1] location [String] The test file location ("path:line")
-    #   - [2] requirement [Object] The test requirement (MUST, SHOULD, or MAY)
-    #   - [3] challenges [Array] Array of test challenges to execute
-    #
-    # @example Extracting specifications from contexts
-    #   contexts = Fix::Doc.fetch(:Calculator)
-    #   specifications = Fix::Doc.extract_specifications(*contexts)
-    #   specifications.each do |env, location, requirement, challenges|
-    #     # Process each specification...
-    #   end
-    #
-    # @api private
-    def self.extract_specifications(*contexts)
-      contexts.flat_map do |context|
-        extract_context_specifications(context)
-      end
-    end
-
-    # Registers a new specification class under the given name in the registry.
-    # The name must be a valid Ruby constant name to ensure proper namespace organization.
-    #
-    # @param name [Symbol] The name to register the specification under
-    # @param klass [Class] The specification class to register
-    # @raise [Fix::Error::InvalidSpecificationName] If name is not a valid constant name
-    # @return [void]
-    #
-    # @example Adding a new specification
-    #   class CalculatorSpec < Fix::Dsl
-    #     # specification implementation...
-    #   end
-    #   Fix::Doc.add(:Calculator, CalculatorSpec)
-    #
-    # @example Invalid name handling
-    #   # This will raise Fix::Error::InvalidSpecificationName
-    #   Fix::Doc.add(:"invalid-name", some_class)
-    #
-    # @api private
-    def self.add(name, klass)
-      const_set(name, klass)
-    rescue ::NameError => _e
-      raise Error::InvalidSpecificationName, name
-    end
-
-    # Extracts test specifications from a single context class.
-    # This method processes public methods in the context to build
-    # a list of executable test specifications.
-    #
-    # @param context [Fix::Dsl] The context class to process
-    # @return [Array<Array>] Array of specification arrays
-    #
-    # @api private
-    def self.extract_context_specifications(context)
-      env = context.new
-      env.public_methods(false).map do |public_method|
-        [env] + env.public_send(public_method)
-      end
-    end
-
-    private_class_method :extract_context_specifications
-  end
-end