test-unit 3.6.7 → 3.6.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 238d27a3abf3ab70fa38affa00e2fd5944adde841397d1a5307b68eff94362c2
-  data.tar.gz: 6e6ef248d44e47e83bb45d24b160dfdccb32d167123534445d49c7358bcb3bcb
+  metadata.gz: 77117ca73bd85162cdd0b17656df48fe1abc9adaa1aa6f0ab7f0dc8f2eb3ff72
+  data.tar.gz: 1696e25b8ef8f4d0e519eddd363117895ad4a1f280b0ce6ef13147ec13b422d2
 SHA512:
-  metadata.gz: 44cb65959ff5ee6e9673901218b9a29494158a822682d9d12a4b5ba7ce21f965ef87fdf3a697b8d07c91ca7b1fe9f1f0cee7bf6b3da4d74485fd221dcc03fe2c
-  data.tar.gz: 327924d71d4ec015870afec579d9936a6e0425dada2c3b6185a10ce9a2f11e9b5666f9b41641fe994e4150a513d4dd659517181ab31158881595502a77cac708
+  metadata.gz: 5afdc71db023875667be801f4cba2e8b228fade97df6efb1060385a791acd2d790a3d6e83dd503b30043d14752074709e7bdf4ca07e9cb5dac53bf87a2edb06e
+  data.tar.gz: ee546e177616594c247235376f75aa79f7a1a048e9643f6cd9f823c3778ca96301cae7fcad93ad5026ce29b65dfdd4475249edea6b092dcb6cc03fc1bfa708e6

data/README.md

@@ -3,7 +3,7 @@
 [![Gem Version](https://badge.fury.io/rb/test-unit.png)](http://badge.fury.io/rb/test-unit)
 [![Build Status for Ruby 2.1+](https://github.com/test-unit/test-unit/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/test-unit/test-unit/actions/workflows/test.yml?query=branch%3Amaster+)
 
-* http://test-unit.github.io/
+* https://test-unit.github.io/
 * https://github.com/test-unit/test-unit
 
 ## Description

data/Rakefile

@@ -49,7 +49,7 @@ Packnga::ReleaseTask.new(spec) do |task|
 end
 
 task :test do
-  ruby("test/run-test.rb")
+  ruby("test/run.rb")
 end
 
 namespace :doc do

data/bin/test-unit

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require "test/unit"
+
+exit(Test::Unit::AutoRunner.run(true))

data/doc/text/getting-started.md

@@ -22,178 +22,52 @@ You will find the following lines.
 !!!plain
 gem list
 ...
-bundler (1.14.6)
+bundler (2.6.3, default: 2.6.2)
 ...
-test-unit (3.2.3)
+test-unit (3.6.8, 3.6.7)
 ~~~
 
 ## 3. Create gem template.
 
 Next, create a gem template using `bundler` command.
 This command generates package skeleton with a testing framework.
-However, this command can't generate test templates for `test-unit`.
 
-So, First create gem template with the `minitest` testing framework.
-(It's similar to `unit-test`).
-After that, replace some files for `test-unit`.
+The `bundle gem -t test-unit sample` command will generate a gem template with the `test-unit` testing framework.
 
-The `bundle gem -t minitest sample` command will generate the following files.
-
-~~~
-!!!plain
-.
-|-- Gemfile
-|-- README.md
-|-- Rakefile
-|-- bin
-|   |-- console
-|   `-- setup
-|-- lib
-|   |-- sample
-|   |   `-- version.rb
-|   `-- sample.rb
-|-- sample.gemspec  # <- Modify
-`-- test
-    |-- sample_test.rb # <- Modify
-    `-- test_helper.rb # <- Modify
-~~~
-
-## 4. Edit files for `test-unit`
-
-### 4.1. Edit gemspec
-
-Edit `sample.gemspec` like the below.
-Replace `minitest` line to `test-unit`.
-
-Before
-
-~~~
-!!!ruby
-  spec.add_development_dependency "minitest", "~> 5.0"
-~~~
-
-After
-
-~~~
-!!!ruby
-  spec.add_development_dependency "test-unit", "~> 3.2.3"
-~~~
-
-### 4.2. Edit `test/test_helper.rb`
-
-Next, edit the `test/test_helper.rb` file.
-
-Before
-
-~~~
-!!!ruby
-$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
-require 'sample'
-
-require 'minitest/autorun' # <-- Modify this line.
-~~~
-
-After
-
-~~~
-!!!ruby
-$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
-require 'sample'
-
-require 'test/unit' # <-- After modification.
-~~~
-
-### 4.3 Rakefile (No edit)
-
-This file doesn't need to modify.
-The output is the below.
-
-~~~
-!!!ruby
-require "bundler/gem_tasks"
-require "rake/testtask"
-
-Rake::TestTask.new(:test) do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList['test/**/*_test.rb']
-end
-
-task :default => :test
-~~~
-
-### 4.4 Edit `test/sample_test.rb`
-
-The bundler generate the file `test/sample_test.rb`.
-This file originally templates for `minitest`.
-
-Let's modify this file for `test-unit`
-
-before
-
-~~~
-!!!ruby
-require 'test_helper'
-
-class SampleTest < Minitest::Test # <- Modify here
-  def test_that_it_has_a_version_number
-    refute_nil ::Sample::VERSION
-  end
-
-  def test_it_does_something_useful
-    assert false
-  end
-end
-~~~
-
-After
-
-~~~
-!!!ruby
-require 'test_helper'
-
-class SampleTest < Test::Unit::TestCase # <- After modification
-  def test_that_it_has_a_version_number
-    refute_nil ::Sample::VERSION
-  end
-
-  def test_it_does_something_useful
-    assert false
-  end
-end
-~~~
-
-## 5. Execute test.
+## 4. Execute test.
 
 The `rake test` command execute test scenarios in the `test` directory.
 Now it tries to two tests. One will success the other one fails.
 
 ~~~
 !!!plain
-rake test
-Loaded suite
-/path/to/ruby/lib/ruby/gems/2.3.0/gems/rake-12.0.0/lib/rake/rake_test_loader
+$ rake test
+Loaded suite /path/to/ruby/lib/ruby/gems/3.4.0/gems/rake-13.2.1/lib/rake/rake_test_loader
 Started
 F
 ================================================================================
-Failure: <false> is not true.
-test_it_does_something_useful(SampleTest)
-/path/to/sample/test/sample_test.rb:9:in `test_it_does_something_useful'
-      6:   end
-      7:
-      8:   def test_it_does_something_useful
-  =>  9:     assert false
+Failure: test: something useful(SampleTest)
+/path/to/sample/test/sample_test.rb:13:in 'block in <class:SampleTest>'
      10:   end
-     11: end
+     11:
+     12:   test "something useful" do
+  => 13:     assert_equal("expected", "actual")
+     14:   end
+     15: end
+<"expected"> expected but was
+<"actual">
+
+diff:
+? expected
+? a     ual
+? ????     ??
 ================================================================================
-.
-
-Finished in 0.011521 seconds.
+Finished in 0.013737 seconds.
 --------------------------------------------------------------------------------
 2 tests, 2 assertions, 1 failures, 0 errors, 0 pendings, 0 omissions, 0 notifications
 50% passed
 --------------------------------------------------------------------------------
-173.60 tests/s, 173.60 assertions/s
+145.59 tests/s, 145.59 assertions/s
 rake aborted!
 Command failed with status (1)
 
@@ -201,7 +75,7 @@ Tasks: TOP => test
 (See full trace by running task with --trace)
 ~~~
 
-## 6. Create original tests.
+## 5. Create original tests.
 
 Let's create your original tests with the following rules.
 
@@ -239,7 +113,7 @@ module Sub
 end
 ~~~
 
-## 7. For more information
+## 6. For more information
 
 Let's read the official document.
 

data/doc/text/how-to.md

@@ -2,7 +2,7 @@
 
 ## Run all tests
 
-To make it easy to run all your tests, you can add a `run_test.rb` script
+To make it easy to run all your tests, you can add a `run.rb` script
 to your `test` directory. A simple example might look like:
 
     base_dir = File.expand_path(File.join(File.dirname(__FILE__), ".."))
@@ -17,19 +17,19 @@ to your `test` directory. A simple example might look like:
 
 Then it's easy to run tests via the command line with,
 
-    $ ruby test/run_test.rb
+    $ ruby test/run.rb
 
 ## Change test runner via the command line
 
 The output format can be changed via the command line with
 the `--runner` option. Simply tack it to the end:
 
-    ruby test/run_test.rb --runner tap
+    ruby test/run.rb --runner emacs
 
 
 ## Configure test-unit per-project
 
-Test::Unit reads `test-unit.yml` or `.test-unit.yml` in the current working
+Test::Unit reads `~/.test-unit.yml` or `test-unit.yml` in the current working
 directory as Test::Unit's configuration file. It can contain the following
 settings:
 

data/doc/text/news.md

@@ -1,5 +1,70 @@
 # News
 
+## 3.6.9 - 2025-06-29 {#version-3-6-9}
+
+### Improvements
+
+  * doc: test: Added one-line style to declare `Ractor` test.
+    * GH-261
+    * GH-309
+
+  * Used `require_relative` instead of `require` for internal library
+    files.
+    * GH-311
+    * GH-312
+    * GH-313
+    * GH-315
+
+  * Added the `--version` option.
+    * GH-314
+    * Patch by MSP-Greg
+
+### Thanks
+
+  * MSP-Greg
+
+## 3.6.8 - 2025-04-05 {#version-3-6-8}
+
+### Improvements
+
+  * `test-unit`: Added. You can use this instead of creating a custom
+    test run script.
+    * GH-288
+    * GH-289
+    * GH-291
+    * Suggested by gemmaro
+
+  * Updated the "how to" document.
+    * GH-292
+    * GH-293
+    * GH-294
+
+  * Updated the "getting started" document.
+    * GH-295
+    * GH-296
+
+  * Added support for `.test-unit` configuration file. It's useful for
+    specifying default options, and is handier than using `.test-unit.yml`.
+    * GH-300
+    * GH-302
+
+### Fixes
+
+  * parallel: thread: Fixed shutdown execution order.
+    * GH-282
+
+  * testcase: Fixed a bug that instance variables added during the test
+    runs are not garbage collected after each test run.
+    * GH-235
+    * GH-303
+    * Reported by akira yamada
+
+### Thanks
+
+  * gemmaro
+
+  * akira yamada
+
 ## 3.6.7 - 2024-12-17 {#version-3-6-7}
 
 ### Fixes

data/lib/test/unit/assertions.rb

@@ -3,11 +3,11 @@
 #             Copyright (c) 2009-2013 Kouhei Sutou. All rights reserved.
 # License:: Ruby license.
 
-require 'test/unit/assertion-failed-error'
-require 'test/unit/util/backtracefilter'
-require 'test/unit/util/memory-usage'
-require 'test/unit/util/method-owner-finder'
-require 'test/unit/diff'
+require_relative 'assertion-failed-error'
+require_relative 'util/backtracefilter'
+require_relative 'util/memory-usage'
+require_relative 'util/method-owner-finder'
+require_relative 'diff'
 
 begin
   require 'power_assert'

data/lib/test/unit/auto-runner-loader.rb

@@ -1,4 +1,4 @@
-require "test/unit/test-suite-creator"
+require_relative "test-suite-creator"
 
 module Test
   module Unit
@@ -8,7 +8,7 @@ module Test
         def check(test_case, method_name)
           return if @loaded
           return unless TestSuiteCreator.test_method?(test_case, method_name)
-          require "test/unit"
+          require_relative "../unit"
           @loaded = true
         end
       end

data/lib/test/unit/autorunner.rb

@@ -1,11 +1,12 @@
 require "English"
 require "optparse"
 
-require "test/unit/color-scheme"
-require "test/unit/priority"
-require "test/unit/attribute-matcher"
-require "test/unit/testcase"
-require "test/unit/test-suite-thread-runner"
+require_relative "color-scheme"
+require_relative "priority"
+require_relative "attribute-matcher"
+require_relative "testcase"
+require_relative "test-suite-thread-runner"
+require_relative "version"
 
 module Test
   module Unit
@@ -86,14 +87,14 @@ module Test
       end
 
       register_collector(:descendant) do |auto_runner|
-        require "test/unit/collector/descendant"
+        require_relative "collector/descendant"
         collector = Collector::Descendant.new
         collector.filter = auto_runner.filters
         collector.collect($0.sub(/\.rb\Z/, ""))
       end
 
       register_collector(:load) do |auto_runner|
-        require "test/unit/collector/load"
+        require_relative "collector/load"
         collector = Collector::Load.new
         unless auto_runner.pattern.empty?
           collector.patterns.replace(auto_runner.pattern)
@@ -109,7 +110,7 @@ module Test
 
       # JUST TEST!
       # register_collector(:xml) do |auto_runner|
-      #   require "test/unit/collector/xml"
+      #   require_relative "collector/xml"
       #   collector = Collector::XML.new
       #   collector.filter = auto_runner.filters
       #   collector.collect(auto_runner.to_run[0])
@@ -117,7 +118,7 @@ module Test
 
       # deprecated
       register_collector(:object_space) do |auto_runner|
-        require "test/unit/collector/objectspace"
+        require_relative "collector/objectspace"
         c = Collector::ObjectSpace.new
         c.filter = auto_runner.filters
         c.collect($0.sub(/\.rb\Z/, ""))
@@ -125,7 +126,7 @@ module Test
 
       # deprecated
       register_collector(:dir) do |auto_runner|
-        require "test/unit/collector/dir"
+        require_relative "collector/dir"
         c = Collector::Dir.new
         c.filter = auto_runner.filters
         unless auto_runner.pattern.empty?
@@ -171,6 +172,10 @@ module Test
         else
           load_global_config
         end
+        plain_text_config_file = ".test-unit"
+        if File.exist?(plain_text_config_file)
+          load_plain_text_config(plain_text_config_file)
+        end
         yield(self) if block_given?
       end
 
@@ -202,6 +207,8 @@ module Test
 
       def options
         @options ||= OptionParser.new do |o|
+          o.version = VERSION
+
           o.banner = "Test::Unit automatic runner."
           o.banner += "\nUsage: #{$0} [options] [-- untouched arguments]"
 
@@ -515,6 +522,15 @@ module Test
         @runner_options = @runner_options.merge(runner_options)
       end
 
+      def load_plain_text_config(file)
+        require "shellwords"
+        File.readlines(file, chomp: true).each do |line|
+          next if line.empty?
+          args = Shellwords.shellsplit(line)
+          @default_arguments.concat(args)
+        end
+      end
+
       private
       def default_runner
         runner = self.class.default_runner
@@ -624,6 +640,6 @@ module Test
   end
 end
 
-require "test/unit/runner/console"
-require "test/unit/runner/emacs"
-require "test/unit/runner/xml"
+require_relative "runner/console"
+require_relative "runner/emacs"
+require_relative "runner/xml"

data/lib/test/unit/collector/descendant.rb

@@ -1,4 +1,4 @@
-require 'test/unit/collector'
+require_relative '../collector'
 
 module Test
   module Unit

data/lib/test/unit/collector/dir.rb

@@ -1,5 +1,5 @@
-require 'test/unit/testsuite'
-require 'test/unit/collector'
+require_relative '../testsuite'
+require_relative '../collector'
 
 module Test
   module Unit

data/lib/test/unit/collector/load.rb

@@ -1,7 +1,7 @@
 require 'pathname'
 
-require 'test/unit/testsuite'
-require 'test/unit/collector'
+require_relative '../testsuite'
+require_relative '../collector'
 
 module Test
   module Unit

data/lib/test/unit/collector/objectspace.rb

@@ -2,7 +2,7 @@
 # Copyright:: Copyright (c) 2000-2003 Nathaniel Talbott. All rights reserved.
 # License:: Ruby license.
 
-require 'test/unit/collector'
+require_relative '../collector'
 
 module Test
   module Unit

data/lib/test/unit/collector/xml.rb

@@ -7,7 +7,7 @@
 
 # just test!!! don't use it yet!!!
 
-require 'test/unit/collector'
+require_relative '../collector'
 
 require 'rexml/document'
 require 'rexml/streamlistener'

data/lib/test/unit/color-scheme.rb

@@ -1,4 +1,4 @@
-require 'test/unit/color'
+require_relative 'color'
 
 module Test
   module Unit

data/lib/test/unit/data.rb

@@ -1,4 +1,4 @@
-require "test/unit/data-sets"
+require_relative "data-sets"
 
 module Test
   module Unit

data/lib/test/unit/error.rb

@@ -4,7 +4,7 @@
 # Copyright:: Copyright (c) 2000-2002 Nathaniel Talbott. All rights reserved.
 # License:: Ruby license.
 
-require 'test/unit/util/backtracefilter'
+require_relative 'util/backtracefilter'
 
 module Test
   module Unit

data/lib/test/unit/notification.rb

@@ -1,4 +1,4 @@
-require 'test/unit/util/backtracefilter'
+require_relative 'util/backtracefilter'
 
 module Test
   module Unit

data/lib/test/unit/omission.rb

@@ -1,4 +1,4 @@
-require 'test/unit/util/backtracefilter'
+require_relative 'util/backtracefilter'
 
 module Test
   module Unit

data/lib/test/unit/pending.rb

@@ -1,4 +1,4 @@
-require 'test/unit/util/backtracefilter'
+require_relative 'util/backtracefilter'
 
 module Test
   module Unit

data/lib/test/unit/runner/console.rb

@@ -3,13 +3,13 @@
 module Test
   module Unit
     AutoRunner.register_runner(:console) do |auto_runner|
-      require 'test/unit/ui/console/testrunner'
+      require_relative '../ui/console/testrunner'
       Test::Unit::UI::Console::TestRunner
     end
 
     AutoRunner.setup_option do |auto_runner, opts|
-      require 'test/unit/ui/console/outputlevel'
-      require 'test/unit/ui/console/testrunner'
+      require_relative '../ui/console/outputlevel'
+      require_relative '../ui/console/testrunner'
 
       output_levels = [
         ["silent", UI::Console::OutputLevel::SILENT],

data/lib/test/unit/runner/emacs.rb

@@ -1,7 +1,7 @@
 module Test
   module Unit
     AutoRunner.register_runner(:emacs) do |auto_runner|
-      require 'test/unit/ui/emacs/testrunner'
+      require_relative '../ui/emacs/testrunner'
       Test::Unit::UI::Emacs::TestRunner
     end
   end

data/lib/test/unit/runner/xml.rb

@@ -1,7 +1,7 @@
 module Test
   module Unit
     AutoRunner.register_runner(:xml) do |auto_runner|
-      require 'test/unit/ui/xml/testrunner'
+      require_relative '../ui/xml/testrunner'
       Test::Unit::UI::XML::TestRunner
     end
 

data/lib/test/unit/test-run-context.rb

@@ -0,0 +1,16 @@
+#--
+#
+# Author:: Tsutomu Katsube.
+# Copyright:: Copyright (c) 2025 Tsutomu Katsube. All rights reserved.
+# License:: Ruby license.
+
+module Test
+  module Unit
+    class TestRunContext
+      attr_reader :runner_class
+      def initialize(runner_class)
+        @runner_class = runner_class
+      end
+    end
+  end
+end

data/lib/test/unit/test-suite-creator.rb

@@ -5,7 +5,7 @@
 #   * Copyright (c) 2011 Kouhei Sutou <tt><kou@clear-code.com></tt>
 # License:: Ruby license.
 
-require "test/unit/data-sets"
+require_relative "data-sets"
 
 module Test
   module Unit

data/lib/test/unit/test-suite-runner.rb

@@ -8,13 +8,15 @@
 
 require "etc"
 
+require_relative "test-run-context"
+
 module Test
   module Unit
     class TestSuiteRunner
       @n_workers = Etc.respond_to?(:nprocessors) ? Etc.nprocessors : 1
       class << self
         def run_all_tests
-          yield
+          yield(TestRunContext.new(self))
         end
 
         def n_workers
@@ -30,11 +32,11 @@ module Test
         @test_suite = test_suite
       end
 
-      def run(result, &progress_block)
+      def run(result, run_context: nil, &progress_block)
         yield(TestSuite::STARTED, @test_suite.name)
         yield(TestSuite::STARTED_OBJECT, @test_suite)
         run_startup(result)
-        run_tests(result, &progress_block)
+        run_tests(result, run_context: run_context, &progress_block)
       ensure
         begin
           run_shutdown(result)
@@ -55,13 +57,13 @@ module Test
         end
       end
 
-      def run_tests(result, &progress_block)
+      def run_tests(result, run_context: nil, &progress_block)
         @test_suite.tests.each do |test|
-          run_test(test, result, &progress_block)
+          run_test(test, result, run_context: run_context, &progress_block)
         end
       end
 
-      def run_test(test, result)
+      def run_test(test, result, run_context: nil)
         finished_is_yielded = false
         finished_object_is_yielded = false
         previous_event_name = nil
@@ -91,7 +93,7 @@ module Test
         end
 
         if test.method(:run).arity == -2
-          test.run(result, runner_class: self.class, &event_listener)
+          test.run(result, run_context: run_context, &event_listener)
         else
           # For backward compatibility. There are scripts that overrides
           # Test::Unit::TestCase#run without keyword arguments.

data/lib/test/unit/test-suite-thread-runner.rb

@@ -6,26 +6,29 @@
 
 require_relative "sub-test-result"
 require_relative "test-suite-runner"
+require_relative "test-thread-run-context"
 
 module Test
   module Unit
     class TestSuiteThreadRunner < TestSuiteRunner
-      @task_queue = Thread::Queue.new
       class << self
-        def task_queue
-          @task_queue
-        end
-
         def run_all_tests
           n_workers = TestSuiteRunner.n_workers
 
+          queue = Thread::Queue.new
+          shutdowns = []
+          yield(TestThreadRunContext.new(self, queue, shutdowns))
+          n_workers.times do
+            queue << nil
+          end
+
           workers = []
           sub_exceptions = []
           n_workers.times do |i|
             workers << Thread.new(i) do |worker_id|
               begin
                 loop do
-                  task = @task_queue.pop
+                  task = queue.pop
                   break if task.nil?
                   catch do |stop_tag|
                     task.call(stop_tag)
@@ -36,31 +39,43 @@ module Test
               end
             end
           end
-
-          yield
-
-          n_workers.times do
-            @task_queue << nil
-          end
           workers.each(&:join)
+
+          shutdowns.each(&:call)
           sub_exceptions.each do |exception|
             raise exception
           end
         end
       end
 
+      def run(result, run_context: nil, &progress_block)
+        yield(TestSuite::STARTED, @test_suite.name)
+        yield(TestSuite::STARTED_OBJECT, @test_suite)
+        run_startup(result)
+        run_tests(result, run_context: run_context, &progress_block)
+      ensure
+        run_context.shutdowns << lambda do
+          begin
+            run_shutdown(result)
+          ensure
+            yield(TestSuite::FINISHED, @test_suite.name)
+            yield(TestSuite::FINISHED_OBJECT, @test_suite)
+          end
+        end
+      end
+
       private
-      def run_tests(result, &progress_block)
+      def run_tests(result, run_context: nil, &progress_block)
         @test_suite.tests.each do |test|
           if test.is_a?(TestSuite) or not @test_suite.parallel_safe?
-            run_test(test, result, &progress_block)
+            run_test(test, result, run_context: run_context, &progress_block)
           else
             task = lambda do |stop_tag|
               sub_result = SubTestResult.new(result)
               sub_result.stop_tag = stop_tag
-              run_test(test, sub_result, &progress_block)
+              run_test(test, sub_result, run_context: run_context, &progress_block)
             end
-            self.class.task_queue << task
+            run_context.queue << task
           end
         end
       end

data/lib/test/unit/test-thread-run-context.rb

@@ -0,0 +1,20 @@
+#--
+#
+# Author:: Tsutomu Katsube.
+# Copyright:: Copyright (c) 2025 Tsutomu Katsube. All rights reserved.
+# License:: Ruby license.
+
+require_relative "test-run-context"
+
+module Test
+  module Unit
+    class TestThreadRunContext < TestRunContext
+      attr_reader :queue, :shutdowns
+      def initialize(runner_class, queue, shutdowns)
+        super(runner_class)
+        @queue = queue
+        @shutdowns = shutdowns
+      end
+    end
+  end
+end

data/lib/test/unit/testcase.rb

@@ -6,24 +6,24 @@
 #   * Copyright (c) 2008-2012 Kouhei Sutou <tt><kou@clear-code.com></tt>
 # License:: Ruby license.
 
-require 'test/unit/attribute'
-require 'test/unit/fixture'
-require 'test/unit/exception-handler'
-require 'test/unit/assertions'
-require 'test/unit/failure'
-require 'test/unit/error'
-require 'test/unit/pending'
-require 'test/unit/omission'
-require 'test/unit/notification'
-require 'test/unit/priority'
-require 'test/unit/data'
-require 'test/unit/testsuite'
-require 'test/unit/test-suite-creator'
-require 'test/unit/assertion-failed-error'
-require 'test/unit/auto-runner-loader'
-require 'test/unit/util/backtracefilter'
-require 'test/unit/util/output'
-require 'test/unit/util/method-owner-finder'
+require_relative 'attribute'
+require_relative 'fixture'
+require_relative 'exception-handler'
+require_relative 'assertions'
+require_relative 'failure'
+require_relative 'error'
+require_relative 'pending'
+require_relative 'omission'
+require_relative 'notification'
+require_relative 'priority'
+require_relative 'data'
+require_relative 'testsuite'
+require_relative 'test-suite-creator'
+require_relative 'assertion-failed-error'
+require_relative 'auto-runner-loader'
+require_relative 'util/backtracefilter'
+require_relative 'util/output'
+require_relative 'util/method-owner-finder'
 
 module Test
   module Unit
@@ -401,6 +401,14 @@ module Test
         #     end
         #   end
         #
+        # @example Declares that test_do_something_with_ractor uses Ractor in one line
+        #
+        #   ractor def test_do_something_with_ractor
+        #     Ractor.new do
+        #       # ...
+        #     end
+        #   end
+        #
         # @since 3.4.6
         def ractor(options={})
           attribute(:ractor, true, options)
@@ -577,9 +585,11 @@ module Test
       # Runs the individual test method represented by this
       # instance of the fixture, collecting statistics, failures
       # and errors in result.
-      def run(result, runner_class: nil)
+      def run(result, run_context: nil)
         begin
           @_result = result
+          instance_variables_before = instance_variables
+          @internal_data.run_context = run_context
           @internal_data.test_started
           yield(STARTED, name)
           yield(STARTED_OBJECT, self)
@@ -621,6 +631,9 @@ module Test
           yield(FINISHED_OBJECT, self)
         ensure
           # @_result = nil # For test-spec's after_all :<
+          (instance_variables - instance_variables_before).each do |name|
+            remove_instance_variable(name)
+          end
         end
       end
 
@@ -856,6 +869,11 @@ module Test
         @internal_data.problem_occurred
       end
 
+      # Returns test suite runner class for easy to test.
+      def runner_class
+        @internal_data.run_context.runner_class
+      end
+
       # Notify that the test is passed. Normally, it is not needed
       # because #run calls it automatically. If you want to override
       # #run, it is not a good idea. Please contact test-unit
@@ -916,6 +934,7 @@ module Test
       class InternalData
         attr_reader :start_time, :elapsed_time
         attr_reader :test_data_label, :test_data
+        attr_accessor :run_context
         def initialize
           @start_time = nil
           @elapsed_time = nil
@@ -923,6 +942,7 @@ module Test
           @interrupted = false
           @test_data_label = nil
           @test_data = nil
+          @run_context = nil
         end
 
         def passed?

data/lib/test/unit/testresult.rb

@@ -3,12 +3,12 @@
 # Copyright:: Copyright (c) 2000-2002 Nathaniel Talbott. All rights reserved.
 # License:: Ruby license.
 
-require 'test/unit/util/observable'
-require 'test/unit/failure'
-require 'test/unit/error'
-require 'test/unit/omission'
-require 'test/unit/pending'
-require 'test/unit/notification'
+require_relative 'util/observable'
+require_relative 'failure'
+require_relative 'error'
+require_relative 'omission'
+require_relative 'pending'
+require_relative 'notification'
 
 module Test
   module Unit
@@ -76,7 +76,7 @@ module Test
          *@summary_generators.collect {|generator| __send__(generator)}].join(", ")
       end
 
-      # Returnes a string that shows result status.
+      # Returns a string that shows result status.
       def status
         if passed?
           if pending_count > 0

data/lib/test/unit/testsuite.rb

@@ -5,7 +5,7 @@
 # Copyright:: Copyright (c) 2008-2011 Kouhei Sutou. All rights reserved.
 # License:: Ruby license.
 
-require 'test/unit/error'
+require_relative 'error'
 require_relative 'test-suite-runner'
 
 module Test
@@ -47,9 +47,13 @@ module Test
 
       # Runs the tests and/or suites contained in this
       # TestSuite.
-      def run(result, runner_class: nil, &progress_block)
-        runner_class ||= TestSuiteRunner
-        runner_class.new(self).run(result) do |event, *args|
+      def run(result, run_context: nil, &progress_block)
+        if run_context
+          runner_class = run_context.runner_class
+        else
+          runner_class = TestSuiteRunner
+        end
+        runner_class.new(self).run(result, run_context: run_context) do |event, *args|
           case event
           when STARTED
             @start_time = Time.now

data/lib/test/unit/ui/console/testrunner.rb

@@ -12,13 +12,13 @@ rescue LoadError
 end
 require "pathname"
 
-require 'test/unit/color-scheme'
-require 'test/unit/code-snippet-fetcher'
-require 'test/unit/fault-location-detector'
-require 'test/unit/diff'
-require 'test/unit/ui/testrunner'
-require 'test/unit/ui/testrunnermediator'
-require 'test/unit/ui/console/outputlevel'
+require_relative '../../color-scheme'
+require_relative '../../code-snippet-fetcher'
+require_relative '../../fault-location-detector'
+require_relative '../../diff'
+require_relative '../testrunner'
+require_relative '../testrunnermediator'
+require_relative 'outputlevel'
 
 module Test
   module Unit

data/lib/test/unit/ui/emacs/testrunner.rb

@@ -1,4 +1,4 @@
-require 'test/unit/ui/console/testrunner'
+require_relative '../console/testrunner'
 
 module Test
   module Unit

data/lib/test/unit/ui/testrunner.rb

@@ -1,4 +1,4 @@
-require 'test/unit/ui/testrunnerutilities'
+require_relative 'testrunnerutilities'
 
 module Test
   module Unit

data/lib/test/unit/ui/testrunnermediator.rb

@@ -4,8 +4,8 @@
 # Copyright:: Copyright (c) 2000-2002 Nathaniel Talbott. All rights reserved.
 # License:: Ruby license.
 
-require 'test/unit/util/observable'
-require 'test/unit/testresult'
+require_relative '../util/observable'
+require_relative '../testresult'
 
 module Test
   module Unit
@@ -40,13 +40,13 @@ module Test
           start_time = Time.now
           begin
             with_listener(result) do
-              @test_suite_runner_class.run_all_tests do
+              @test_suite_runner_class.run_all_tests do |run_context|
                 catch do |stop_tag|
                   result.stop_tag = stop_tag
                   notify_listeners(RESET, @suite.size)
                   notify_listeners(STARTED, result)
 
-                  run_suite(result)
+                  run_suite(result, run_context)
                 end
               end
             end
@@ -65,11 +65,11 @@ module Test
         #
         # See GitHub#38
         #   https://github.com/test-unit/test-unit/issues/38
-        def run_suite(result=nil)
+        def run_suite(result=nil, run_context=nil)
           if result.nil?
             run
           else
-            @suite.run(result, runner_class: @test_suite_runner_class) do |channel, value|
+            @suite.run(result, run_context: run_context) do |channel, value|
               notify_listeners(channel, value)
             end
           end

data/lib/test/unit/ui/xml/testrunner.rb

@@ -7,8 +7,9 @@
 
 require 'erb'
 require 'time'
-require 'test/unit/ui/testrunner'
-require 'test/unit/ui/testrunnermediator'
+
+require_relative '../testrunner'
+require_relative '../testrunnermediator'
 
 module Test
   module Unit

data/lib/test/unit/util/observable.rb

@@ -4,7 +4,7 @@
 # Copyright:: Copyright (c) 2000-2002 Nathaniel Talbott. All rights reserved.
 # License:: Ruby license.
 
-require 'test/unit/util/procwrapper'
+require_relative 'procwrapper'
 
 module Test
   module Unit

data/lib/test/unit/version.rb

@@ -1,5 +1,5 @@
 module Test
   module Unit
-    VERSION = "3.6.7"
+    VERSION = "3.6.9"
   end
 end

data/lib/test/unit.rb

@@ -1,7 +1,7 @@
-require "test/unit/warning"
+require_relative "unit/warning"
 
-require 'test/unit/testcase'
-require 'test/unit/autorunner'
+require_relative 'unit/testcase'
+require_relative 'unit/autorunner'
 
 module Test # :nodoc:
   #
@@ -28,7 +28,7 @@ module Test # :nodoc:
   #
   # ## Notes
   #
-  # Test::Unit has grown out of and superceded Lapidary.
+  # Test::Unit has grown out of and superseded Lapidary.
   #
   #
   # ## Feedback
@@ -69,7 +69,7 @@ module Test # :nodoc:
   # Masaki Suketa, for his work on RubyUnit, which filled a vital need in
   # the Ruby world for a very long time. I'm also grateful for his help in
   # polishing Test::Unit and getting the RubyUnit compatibility layer
-  # right. His graciousness in allowing Test::Unit to supercede RubyUnit
+  # right. His graciousness in allowing Test::Unit to supersede RubyUnit
   # continues to be a challenge to me to be more willing to defer my own
   # rights.
   #
@@ -109,7 +109,7 @@ module Test # :nodoc:
   #
   # This software is provided "as is" and without any express or
   # implied warranties, including, without limitation, the implied
-  # warranties of merchantibility and fitness for a particular
+  # warranties of merchantability and fitness for a particular
   # purpose.
   #
   #

data/lib/test-unit.rb

@@ -1,11 +1,22 @@
 # Copyright (C) 2012-2015  Kouhei Sutou <kou@clear-code.com>
 
-require "test/unit/warning"
+require_relative "test/unit/warning"
 
 module Test
   module Unit
-    autoload :TestCase, "test/unit/testcase"
-    autoload :AutoRunner, "test/unit/autorunner"
+    class << self
+      def const_missing(name)
+        case name
+        when :AutoRunner, :TestCase
+          require_relative "test/unit/autorunner"
+          require_relative "test/unit/testcase"
+          singleton_class.remove_method(:const_missing)
+          const_get(name)
+        else
+          super
+        end
+      end
+    end
   end
 end
 
@@ -14,6 +25,6 @@ unless respond_to?(:run_test, true)
   # Is this API OK or dirty?
   def run_test
     self.class.send(:undef_method, :run_test)
-    require "test/unit"
+    require_relative "test/unit"
   end
 end

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: test-unit
 version: !ruby/object:Gem::Version
-  version: 3.6.7
+  version: 3.6.9
 platform: ruby
 authors:
 - Kouhei Sutou
 - Haruka Yoshihara
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-12-17 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: power_assert
@@ -33,7 +32,8 @@ description: |-
 email:
 - kou@cozmixng.org
 - yoshihara@clear-code.com
-executables: []
+executables:
+- test-unit
 extensions: []
 extra_rdoc_files: []
 files:
@@ -42,6 +42,7 @@ files:
 - PSFL
 - README.md
 - Rakefile
+- bin/test-unit
 - doc/text/getting-started.md
 - doc/text/how-to.md
 - doc/text/news.md
@@ -78,9 +79,11 @@ files:
 - lib/test/unit/runner/emacs.rb
 - lib/test/unit/runner/xml.rb
 - lib/test/unit/sub-test-result.rb
+- lib/test/unit/test-run-context.rb
 - lib/test/unit/test-suite-creator.rb
 - lib/test/unit/test-suite-runner.rb
 - lib/test/unit/test-suite-thread-runner.rb
+- lib/test/unit/test-thread-run-context.rb
 - lib/test/unit/testcase.rb
 - lib/test/unit/testresult.rb
 - lib/test/unit/testsuite.rb
@@ -113,7 +116,6 @@ metadata:
   source_code_uri: https://github.com/test-unit/test-unit
   documentation_uri: https://test-unit.github.io/test-unit/en/
   bug_tracker_uri: https://github.com/test-unit/test-unit/issues
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -128,8 +130,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.7
 specification_version: 4
 summary: An xUnit family unit testing framework for Ruby.
 test_files: []