test_bench-fixture 1.4.0.2 → 2.1.0.0.pre1

data/lib/test_bench/fixture/fixture.rb

@@ -1,198 +1,187 @@
 module TestBench
   module Fixture
-    Error = Class.new(RuntimeError)
-
-    def self.build(cls, *args, session: nil, output: nil, error_policy: nil, factory_method: nil, **kwargs, &block)
-      assure_fixture(cls)
-
-      factory_method = factory_method(cls)
-
-      if kwargs.empty?
-        instance = factory_method.(*args, &block)
-      else
-        instance = factory_method.(*args, **kwargs, &block)
-      end
-
-      Session.configure(instance, session: session, output: output, error_policy: error_policy)
-
-      instance
-    end
-
-    def self.assure_fixture(cls)
-      unless cls.included_modules.include?(self)
-        raise Error, "Not a fixture class (Class: #{cls.inspect})"
-      end
-    end
-
-    def self.factory_method(cls)
-      if cls.respond_to?(:build)
-        cls.method(:build)
-      elsif cls.respond_to?(:new)
-        cls.method(:new)
-      else
-        raise Error, "Must be given a class (Argument: #{cls.inspect})"
-      end
-    end
-
-    def self.call(cls, *args, **kwargs, &block)
-      factory_method = factory_method(cls)
-
-      if factory_method.name == :new
-        last_parameter_type, _ = cls.instance_method(:initialize).parameters.last
-      else
-        last_parameter_type, _ = factory_method.parameters.last
-      end
-
-      if last_parameter_type == :block
-        instance = build(cls, *args, **kwargs, &block)
-        block = nil
-      else
-        instance = build(cls, *args, **kwargs)
-      end
-
-      instance.test_session.fixture(instance, &block)
-
-      instance
-    end
+    include TestBench::Session::Events
 
     def test_session
       @test_session ||= Session::Substitute.build
     end
     attr_writer :test_session
-    alias_method :session, :test_session
-    alias_method :session=, :test_session=
 
-    def inspect
-      original_test_session = test_session
-
-      self.test_session = "(not inspected; class is #{original_test_session.class})"
-
-      begin
-        super
-      ensure
-        self.test_session = original_test_session
-      end
+    def fixture_passed?
+      test_session.passed?
     end
+    alias :passed? :fixture_passed?
 
-    def comment(text, *additional_lines)
-      test_session.comment(text)
-
-      additional_lines.each do |text|
-        test_session.comment(text)
-      end
+    def comment(...)
+      Fixture.comment(test_session.telemetry, Commented, ...)
     end
 
-    def detail(text, *additional_lines)
-      test_session.detail(text)
+    def detail(...)
+      Fixture.comment(test_session.telemetry, Detailed, ...)
+    end
 
-      additional_lines.each do |text|
-        test_session.detail(text)
+    def assert(result)
+      if not [true, false, nil].include?(result)
+        raise TypeError, "Value #{result.inspect} isn't a boolean"
       end
-    end
 
-    def assert(value, caller_location: nil)
-      caller_location ||= caller[0]
+      result = false if result.nil?
 
-      test_session.assert(value, caller_location: caller_location)
+      test_session.assert(result)
     end
 
-    def refute(value, caller_location: nil)
-      caller_location ||= caller[0]
+    def refute(result)
+      if not [true, false, nil].include?(result)
+        raise TypeError, "Value #{result.inspect} isn't a boolean"
+      end
 
-      test_session.assert(!value, caller_location: caller_location)
+      negated_result = !result
+
+      test_session.assert(negated_result)
     end
 
-    def assert_raises(error_class=nil, message=nil, strict: nil, caller_location: nil, &block)
-      if error_class.nil?
+    def assert_raises(exception_class=nil, message=nil, strict: nil, &block)
+      if exception_class.nil?
         strict ||= false
-        error_class = StandardError
+        exception_class = StandardError
       else
         strict = true if strict.nil?
       end
 
-      caller_location ||= caller[0]
-
-      detail "Expected Error: #{error_class}#{' (strict)' if strict}"
-      detail "Expected Message: #{message.inspect}" unless message.nil?
+      detail "Expected exception: #{exception_class}#{' (strict)' if strict}"
+      if not message.nil?
+        detail "Expected message: #{message.inspect}"
+      end
 
       block.()
 
-      detail "(No error was raised)"
+      detail "(No exception was raised)"
 
-    rescue error_class => error
+    rescue exception_class => exception
 
-      detail "Raised error: #{error.inspect}#{" (subclass of #{error_class})" if error.class < error_class}"
+      detail "Raised exception: #{exception.inspect}#{" (subclass of #{exception_class})" if exception.class < exception_class}"
 
-      if strict && !error.instance_of?(error_class)
-        raise error
+      if strict && !exception.instance_of?(exception_class)
+        raise exception
       end
 
       if message.nil?
         result = true
       else
-        result = error.message == message
+        result = exception.message == message
       end
 
-      assert(result, caller_location: caller_location)
-
+      assert(result)
     else
-      assert(false, caller_location: caller_location)
+      assert(false)
     end
 
-    def refute_raises(error_class=nil, strict: nil, caller_location: nil, &block)
-      if error_class.nil?
+    def refute_raises(exception_class=nil, strict: nil, &block)
+      if exception_class.nil?
         strict ||= false
-        error_class = StandardError
+        exception_class = StandardError
       else
         strict = true if strict.nil?
       end
 
-      caller_location ||= caller[0]
-
-      detail "Prohibited Error: #{error_class}#{' (strict)' if strict}"
+      detail "Prohibited exception: #{exception_class}#{' (strict)' if strict}"
 
       block.()
 
-      detail "(No error was raised)"
-
-      result = true
+      detail "(No exception was raised)"
 
-    rescue error_class => error
+    rescue exception_class => exception
 
-      detail "Raised Error: #{error.inspect}"
+      detail "Raised exception: #{exception.inspect}#{" (subclass of #{exception_class})" if exception.class < exception_class}"
 
-      if strict && !error.instance_of?(error_class)
-        raise error
+      if strict && !exception.instance_of?(exception_class)
+        raise exception
       end
 
-      result = false
+      assert(false)
+    else
+      assert(true)
+    end
+
+    def context(title=nil, &block)
+      test_session.context(title, &block)
+    end
 
-    ensure
-      unless result.nil?
-        assert(result, caller_location: caller_location)
-      end
+    def context!(title=nil, &block)
+      test_session.context!(title, &block)
+    end
+
+    def test(title=nil, &block)
+      test_session.test(title, &block)
+    end
+
+    def test!(title=nil, &block)
+      test_session.test!(title, &block)
     end
 
-    def context(text=nil, &block)
-      test_session.context(text, &block)
+    def fail(message=nil)
+      test_session.fail(message)
     end
 
-    def test(text=nil, &block)
-      test_session.test(text, &block)
+    def fixture(fixture_class_or_object, *, **, &)
+      session = self.test_session
+
+      Fixture.(fixture_class_or_object, *, session:, **, &)
     end
 
-    def test!(text=nil, &block)
-      result = test(text, &block)
+    def self.comment(telemetry, event_class, text, *additional_texts, heading: nil, quote: nil)
+      texts = [text, *additional_texts]
 
-      unless result
-        raise Session::Abort.new, "Context aborted"
+      if quote.nil?
+        quote = texts.last.end_with?("\n")
       end
 
-      result
+      if quote
+        if heading.nil?
+          heading = !text.end_with?("\n")
+        end
+      end
+
+      if heading
+        heading = texts.shift
+      else
+        heading = nil
+      end
+
+      if quote
+        text = texts.join
+      else
+        text = texts.first
+      end
+
+      event = event_class.new
+      event.text = text
+      event.quote = quote
+      event.heading = heading
+
+      telemetry.record(event)
+
+      if not quote
+        texts[1..-1].each do |text|
+          comment(telemetry, event_class, text, heading: false, quote: false)
+        end
+      end
+    end
+
+    def self.output(fixture, styling: nil)
+      session = fixture.test_session
+
+      TestBench::Session::Output::Get.(session, styling:)
     end
 
-    def fixture(cls, *args, **kwargs, &block)
-      Fixture.(cls, *args, session: test_session, **kwargs, &block)
+    def self.call(fixture_class_or_object, ...)
+      if fixture_class_or_object.instance_of?(Class)
+        fixture_class = fixture_class_or_object
+        Actuate::Class.(fixture_class, ...)
+      else
+        object = fixture_class_or_object
+        Actuate::Object.(object, ...)
+      end
     end
   end
 end

data/lib/test_bench/fixture.rb

@@ -1,21 +1,8 @@
-unless RUBY_ENGINE == 'mruby'
-  require 'logger'
-  require 'stringio'
-end
+require 'test_bench/session'
 
-require 'test_bench/fixture/assertion_failure'
-
-require 'test_bench/fixture/output'
-require 'test_bench/fixture/output/null'
-require 'test_bench/fixture/output/log'
-require 'test_bench/fixture/output/capture'
-require 'test_bench/fixture/output/substitute'
-require 'test_bench/fixture/output/substitute/scope'
-require 'test_bench/fixture/output/multiple'
-
-require 'test_bench/fixture/error_policy'
-
-require 'test_bench/fixture/session'
-require 'test_bench/fixture/session/substitute'
+require 'test_bench/fixture/actuate/class'
+require 'test_bench/fixture/actuate/object'
 
 require 'test_bench/fixture/fixture'
+
+require 'test_bench/fixture/evaluate'

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: test_bench-fixture
 version: !ruby/object:Gem::Version
-  version: 1.4.0.2
+  version: 2.1.0.0.pre1
 platform: ruby
 authors:
 - Nathan Ladd
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-05-09 00:00:00.000000000 Z
+date: 2023-07-24 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: test_bench-session
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: test_bench-bootstrap
   requirement: !ruby/object:Gem::Requirement
@@ -31,27 +45,20 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/test_bench/fixture.rb
-- lib/test_bench/fixture/assertion_failure.rb
+- lib/test_bench/fixture/actuate/class.rb
+- lib/test_bench/fixture/actuate/object.rb
 - lib/test_bench/fixture/controls.rb
-- lib/test_bench/fixture/controls/caller_location.rb
-- lib/test_bench/fixture/controls/error.rb
-- lib/test_bench/fixture/controls/error/backtrace.rb
+- lib/test_bench/fixture/controls/exception.rb
 - lib/test_bench/fixture/controls/fixture.rb
+- lib/test_bench/fixture/controls/fixture/class.rb
+- lib/test_bench/fixture/controls/fixture/object.rb
+- lib/test_bench/fixture/controls/fixture/object/modules.rb
 - lib/test_bench/fixture/controls/output.rb
-- lib/test_bench/fixture/controls/output/log.rb
+- lib/test_bench/fixture/controls/random.rb
 - lib/test_bench/fixture/controls/result.rb
-- lib/test_bench/fixture/controls/test_file.rb
-- lib/test_bench/fixture/error_policy.rb
+- lib/test_bench/fixture/controls/title.rb
+- lib/test_bench/fixture/evaluate.rb
 - lib/test_bench/fixture/fixture.rb
-- lib/test_bench/fixture/output.rb
-- lib/test_bench/fixture/output/capture.rb
-- lib/test_bench/fixture/output/log.rb
-- lib/test_bench/fixture/output/multiple.rb
-- lib/test_bench/fixture/output/null.rb
-- lib/test_bench/fixture/output/substitute.rb
-- lib/test_bench/fixture/output/substitute/scope.rb
-- lib/test_bench/fixture/session.rb
-- lib/test_bench/fixture/session/substitute.rb
 homepage: https://github.com/test-bench/test-bench-fixture
 licenses:
 - MIT
@@ -67,12 +74,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
-rubygems_version: 3.3.4
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
-summary: Test object framework for Ruby and MRuby
+summary: ruby
 test_files: []

data/lib/test_bench/fixture/assertion_failure.rb

@@ -1,19 +0,0 @@
-module TestBench
-  module Fixture
-    class AssertionFailure < RuntimeError
-      def self.build(caller_location=nil)
-        caller_location ||= caller[0]
-
-        backtrace = [caller_location.to_s]
-
-        instance = new(message)
-        instance.set_backtrace(backtrace)
-        instance
-      end
-
-      def self.message
-        'Assertion failed'
-      end
-    end
-  end
-end

data/lib/test_bench/fixture/controls/caller_location.rb

@@ -1,66 +0,0 @@
-module TestBench
-  module Fixture
-    module Controls
-      module CallerLocation
-        def self.example(file: nil, line_number: nil, label: nil)
-          file ||= self.file
-          line_number ||= self.line_number
-          label ||= self.label
-
-          "#{file}:#{line_number}:in `#{label}'"
-        end
-
-        def self.file
-          'lib/some_dir/some_file.rb'
-        end
-
-        def self.line_number
-          11
-        end
-
-        def self.label
-          'some_method'
-        end
-
-        module Alternate
-          def self.example(line_number: nil)
-            line_number ||= self.line_number
-
-            CallerLocation.example(file: file, line_number: line_number)
-          end
-
-          def self.file
-            'lib/other_dir/other_file.rb'
-          end
-
-          def self.line_number
-            111
-          end
-        end
-
-        Implementation = self
-
-        module Test
-          def self.example(file: nil, line_number: nil)
-            file ||= self.file
-            line_number ||= self.line_number
-
-            TOPLEVEL_BINDING.receiver.instance_eval 'proc { caller[0] }.call', file, line_number
-          end
-
-          def self.file
-            'test/some_dir/some_test_file.rb'
-          end
-
-          def self.line_number
-            22
-          end
-
-          def self.label
-            'block in <main>'
-          end
-        end
-      end
-    end
-  end
-end

data/lib/test_bench/fixture/controls/error/backtrace.rb

@@ -1,31 +0,0 @@
-module TestBench
-  module Fixture
-    module Controls
-      module Error
-        module Backtrace
-          def self.example(depth: nil)
-            depth ||= self.depth
-
-            controls = [
-              CallerLocation,
-              CallerLocation::Alternate,
-              CallerLocation::Alternate
-            ].cycle.first(depth)
-
-            controls.map.with_index do |control, index|
-              line_number = index + 1
-
-              caller_location = control.example(line_number: line_number)
-
-              caller_location.to_s
-            end
-          end
-
-          def self.depth
-            3
-          end
-        end
-      end
-    end
-  end
-end

data/lib/test_bench/fixture/controls/error.rb

@@ -1,52 +0,0 @@
-module TestBench
-  module Fixture
-    module Controls
-      module Error
-        def self.example(message=nil, backtrace: nil, backtrace_depth: nil, cause: nil, cls: nil)
-          message ||= self.message
-          cls ||= Example
-
-          if backtrace == :none
-            backtrace = []
-          else
-            backtrace ||= Backtrace.example(depth: backtrace_depth)
-          end
-
-          if cause == true
-            cause = Cause.example
-          end
-
-          error = cls.new(message)
-          error.set_backtrace(backtrace)
-
-          if cause
-            begin
-              begin
-                raise cause
-              rescue cause.class
-                raise error
-              end
-            rescue cls
-            end
-          end
-
-          error
-        end
-
-        def self.message
-          'Some error'
-        end
-
-        Example = Class.new(RuntimeError)
-
-        module Cause
-          def self.example
-            Error.example("Some cause", cls: Example)
-          end
-
-          Example = Class.new(RuntimeError)
-        end
-      end
-    end
-  end
-end

data/lib/test_bench/fixture/controls/output/log.rb

@@ -1,45 +0,0 @@
-module TestBench
-  module Fixture
-    module Controls
-      module Output
-        module Log
-          module Level
-            def self.example
-              fatal
-            end
-
-            def self.unknown
-              :unknown
-            end
-
-            def self.fatal
-              :fatal
-            end
-
-            def self.error
-              :error
-            end
-
-            def self.warning
-              :warning
-            end
-
-            def self.info
-              :info
-            end
-
-            def self.debug
-              :debug
-            end
-
-            module Invalid
-              def self.example
-                :not_a_log_level
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end