test_bench 1.0.0.0

data/lib/test_bench/controls/output/newline_character.rb

@@ -0,0 +1,11 @@
+module TestBench
+  module Controls
+    module Output
+      module NewlineCharacter
+        def self.example
+          StringIO.new.tap(&:puts).string
+        end
+      end
+    end
+  end
+end

data/lib/test_bench/controls/output/print_error.rb

@@ -0,0 +1,19 @@
+module TestBench
+  module Controls
+    module Output
+      module PrintError
+        def self.example(omit_backtrace_pattern: nil, reverse_backtraces: nil, writer: nil)
+          print_error = Example.new
+          print_error.omit_backtrace_pattern = omit_backtrace_pattern unless omit_backtrace_pattern.nil?
+          print_error.reverse_backtraces = reverse_backtraces unless reverse_backtraces.nil?
+          print_error.writer = writer unless writer.nil?
+          print_error
+        end
+
+        class Example
+          include TestBench::Output::PrintError
+        end
+      end
+    end
+  end
+end

data/lib/test_bench/controls/output/styling.rb

@@ -0,0 +1,29 @@
+module TestBench
+  module Controls
+    module Output
+      module Styling
+        def self.example
+          detect
+        end
+
+        def self.detect
+          :detect
+        end
+
+        def self.on
+          :on
+        end
+
+        def self.off
+          :off
+        end
+
+        module Invalid
+          def self.example
+            :not_a_styling_setting
+          end
+        end
+      end
+    end
+  end
+end

data/lib/test_bench/controls/output/summary/error.rb

@@ -0,0 +1,44 @@
+module TestBench
+  module Controls
+    module Output
+      module Summary
+        module Error
+          def self.example(writer: nil)
+            error_summary = Example.new
+            error_summary.writer = writer unless writer.nil?
+            error_summary
+          end
+
+          class Example
+            include TestBench::Fixture::Output
+            include TestBench::Output::Summary::Error
+
+            TestBench::Fixture::Output.instance_methods.each do |method|
+              define_method(method) do |*|
+              end
+            end
+          end
+
+          module Text
+            def self.example
+              <<~TEXT
+                Error Summary:
+                   1: #{file}
+                      #{error.backtrace[0]}: #{error} (#{error.class})
+
+              TEXT
+            end
+
+            def self.file
+              TestFile.filename
+            end
+
+            def self.error
+              Controls::Error.example
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/test_bench/controls/output/summary/run.rb

@@ -0,0 +1,59 @@
+module TestBench
+  module Controls
+    module Output
+      module Summary
+        module Run
+          def self.example(writer: nil, timer: nil)
+            run_summary = Example.new
+            run_summary.writer = writer unless writer.nil?
+            run_summary.timer = timer unless timer.nil?
+            run_summary
+          end
+
+          class Example
+            include TestBench::Fixture::Output
+            include TestBench::Output::Summary::Run
+
+            TestBench::Fixture::Output.instance_methods.each do |method|
+              define_method(method) do |*|
+              end
+            end
+          end
+
+          module Text
+            def self.example
+              <<~TEXT
+              Finished running 0 files
+              Ran 0 tests in 0.000s (0.0 tests/second)
+              0 passed, 0 skipped, 0 failed, 0 total errors
+
+              TEXT
+            end
+
+            module Pass
+              def self.example
+                <<~TEXT
+                Finished running 1 file
+                Ran 1 test in 0.000s (0.0 tests/second)
+                1 passed, 0 skipped, 0 failed, 0 total errors
+
+                TEXT
+              end
+            end
+
+            module Failure
+              def self.example
+                <<~TEXT
+                Finished running 1 file
+                Ran 1 test in 0.000s (0.0 tests/second)
+                0 passed, 0 skipped, 1 failed, 1 total error
+
+                TEXT
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/test_bench/controls/path.rb

@@ -0,0 +1,15 @@
+module TestBench
+  module Controls
+    module Path
+      def self.example
+        TestFile.filename
+      end
+
+      def self.alternate
+        TestFile::Alternate.filename
+      end
+
+      Directory = Controls::Directory
+    end
+  end
+end

data/lib/test_bench/controls/pattern.rb

@@ -0,0 +1,29 @@
+module TestBench
+  module Controls
+    module Pattern
+      def self.example
+        /#{text}/
+      end
+
+      def self.text
+        'some-pattern'
+      end
+
+      module None
+        def self.example
+          /#{text}/
+        end
+
+        def self.text
+          '\z.'
+        end
+      end
+
+      module Invalid
+        def self.text
+          '('
+        end
+      end
+    end
+  end
+end

data/lib/test_bench/controls/result.rb

@@ -0,0 +1,5 @@
+module TestBench
+  module Controls
+    Result = TestBench::Fixture::Controls::Result
+  end
+end

data/lib/test_bench/controls/test_file.rb

@@ -0,0 +1,5 @@
+module TestBench
+  module Controls
+    TestFile = TestBench::Fixture::Controls::TestFile
+  end
+end

data/lib/test_bench/controls/time.rb

@@ -0,0 +1,61 @@
+module TestBench
+  module Controls
+    module Time
+      def self.example(seconds_offset: nil)
+        seconds_offset ||= 0
+
+        year = self.year
+        month = self.month
+        day = self.day
+
+        hours = self.hours
+        minutes = self.minutes
+        seconds = self.seconds + seconds_offset
+
+        tz_offset = self.tz_offset
+
+        ::Time.new(year, month, day, hours, minutes, seconds, tz_offset)
+      end
+
+      def self.year
+        2000
+      end
+
+      def self.month
+        1
+      end
+
+      def self.day
+        1
+      end
+
+      def self.hours
+        11
+      end
+
+      def self.minutes
+        11
+      end
+
+      def self.seconds
+        11.0
+      end
+
+      def self.tz_offset
+        0
+      end
+
+      module Elapsed
+        def self.example
+          1.111
+        end
+
+        module Text
+          def self.example
+            "1.111s"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/test_bench/deactivation_variants.rb

@@ -0,0 +1,21 @@
+module TestBench
+  module DeactivationVariants
+    def _context(title=nil, &block)
+      test_session.fail! if Defaults.fail_session
+
+      context(title)
+    end
+
+    def _test(title=nil, &block)
+      test_session.fail! if Defaults.fail_session
+
+      test(title)
+    end
+
+    module Defaults
+      def self.fail_session
+        Environment::Boolean.fetch('TEST_BENCH_FAIL_DEACTIVATED_TESTS', true)
+      end
+    end
+  end
+end

data/lib/test_bench/environment/boolean.rb

@@ -0,0 +1,40 @@
+module TestBench
+  module Environment
+    module Boolean
+      Error = Class.new(RuntimeError)
+
+      def self.fetch(env_var, default_value=nil, env: nil)
+        value = get(env_var, env: env)
+
+        return default_value if value.nil?
+
+        value
+      end
+
+      def self.get(env_var, env: nil)
+        env ||= ::ENV
+
+        return nil unless env.key?(env_var)
+
+        text_value = env.fetch(env_var)
+
+        case text_value
+        when true_pattern
+          true
+        when false_pattern
+          false
+        else
+          raise Error, "Invalid boolean value for ENV variable #{env_var.inspect} (Value: #{text_value.inspect})"
+        end
+      end
+
+      def self.true_pattern
+        @true_pattern ||= %r{\A(?:on|yes|y|true|t|1)\z}ni
+      end
+
+      def self.false_pattern
+        @false_pattern ||= %r{\A(?:off|no|n|false|f|0)\z}ni
+      end
+    end
+  end
+end

data/lib/test_bench/fixtures.rb

@@ -0,0 +1,3 @@
+require 'ostruct'
+
+require 'test_bench/fixtures/configure_receiver'

data/lib/test_bench/fixtures/configure_receiver.rb

@@ -0,0 +1,80 @@
+module TestBench
+  module Fixtures
+    class ConfigureReceiver
+      include TestBench::Fixture
+
+      attr_reader :cls
+      attr_reader :default_attr_name
+
+      def args
+        @args ||= []
+      end
+
+      def kwargs
+        @kwargs ||= {}
+      end
+
+      def initialize(cls, default_attr_name, args=nil, kwargs=nil)
+        @cls = cls
+        @default_attr_name = default_attr_name
+        @args = args
+        @kwargs = kwargs
+      end
+
+      def self.build(cls, *args, attr_name:, **kwargs)
+        new(cls, attr_name, args, kwargs)
+      end
+
+      def call
+        test "Responds to configure" do
+          assert(cls.respond_to?(:configure))
+        end or return
+
+        context do
+          receiver = OpenStruct.new
+
+          instance = configure(receiver)
+
+          test "Attribute is set on receiver" do
+            refute(receiver.public_send(default_attr_name).nil?)
+          end
+
+          test "Returns the instance that was assigned" do
+            assert(receiver.public_send(default_attr_name).equal?(instance))
+          end
+        end
+
+        context "Optional Attribute Name" do
+          context "Given" do
+            receiver = OpenStruct.new
+            attr_name = :given_attr_name
+
+            configure(receiver, attr_name: attr_name)
+
+            test "Given attribute is set on receiver (Attribute: #{attr_name})" do
+              refute(receiver.public_send(attr_name).nil?)
+            end
+
+            test "Default attribute is not set on receiver" do
+              assert(receiver.public_send(default_attr_name).nil?)
+            end
+          end
+
+          context "Omitted" do
+            receiver = OpenStruct.new
+
+            configure(receiver)
+
+            test "Default attribute is set on receiver (Attribute: #{default_attr_name})" do
+              refute(receiver.public_send(default_attr_name).nil?)
+            end
+          end
+        end
+      end
+
+      def configure(receiver, attr_name: nil)
+        cls.configure(receiver, *args, attr_name: attr_name, **kwargs)
+      end
+    end
+  end
+end