minitest 5.25.1 → 5.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 791576b6d19fd427617c1e5c02a7ddf55f3d214e75bdeeda4ec5ccb49bbad5d2
-  data.tar.gz: 95a6dccbd1cc86bf047b82e88725d50d0dd03dab9f1f6db0a02aad13f1398f10
+  metadata.gz: f9144898bc998f49d23688386cb435165b7ba6fadf83acc47f8120992d2799c6
+  data.tar.gz: f90178ecc10c76e8d0cea4c2206972b3bbb899f552c53f1b22743e00d9898a02
 SHA512:
-  metadata.gz: acde5c1dc093da1b6749b4e328fe5e0b86ba34c081b3d6e667165f8811ea3565774570e73216d67f8c337b5e3999193b2709a50bd69e0dc62ed211b86d087cb9
-  data.tar.gz: ee2390a10ef3ce15c17fef8d8387ff38509ac7c5bf9fd0bcbb1b6c160592821b268d713c0dc8c7357ddeaefb8ca08d0a04d96501c064e0c4f4781f7b3612bbb8
+  metadata.gz: a157620a20602d17c8aaf088cc9c709401d7fd3507569fceb85d358c5519596fdb2bd71ef8b1b597942ba9ba5ef9b0af1530fb97a47fac28add36600516d2edc
+  data.tar.gz: 17c0fdb228c63bda818fbc4009c30c88138df74e325e087050843bef8128ea54afade9de4c0e5af6d5f734ad114d34dd97e4eed2ac4e577662144ad8c49f261e

data/History.rdoc

@@ -1,3 +1,79 @@
+=== 5.26.2 / 2025-11-17
+
+* 5 bug fixes:
+
+  * Bumped minimum ruby to 3.1.
+  * Alias Spec#name to #inspect for cleaner output in repls.
+  * Fix pathing for Hoe::Minitest initialization to be more generic.
+  * Fixed refute_in_epsilon to use min of abs values. (wtn)
+  * Improved options processing and usage output to be more clear.
+
+=== 5.26.1 / 2025-11-08
+
+The Ocean Shores, Slightly Less Tipsy Edition!
+
+* 3 bug fixes:
+
+  * Add links to API doco in README.
+  * Add missing require thread.
+  * Bumped ruby version to include 4.0 (trunk). (hsbt)
+    (see also 5.14.2)
+
+=== 5.26.0 / 2025-10-07
+
+The Seattle.rb Nerd Party, Slightly Tipsy Edition!
+
+* 2 minor enhancements:
+
+  * Added extra documentation to Minitest::TestTask options.
+  * Make parallelize_me! a no-op when n_threads=1.
+
+* 9 bug fixes:
+
+  * Bypass parallel_executor entirely when n_threads=1.
+  * Don't require rubygems in Rakefile... it is 2025.
+  * Ensure that minitest exits non-zero on Interrupt. (tavianator)
+  * Fix Minitest.run sequence rdoc to include loop vars and read consistently.
+  * Fix call to parallel_executor.shutdown when it isn't defined.
+  * Removed some 1.8/1.9-based code from the assertions and expectations.
+  * Still fighting with rdoc? Yup. Still fighting with rdoc...
+  * Switched assert_equal's diff from Tempfile.open to Tempfile.create.
+  * Use Regexp.escape for BASE_RE in case pwd has special chars. (astra_1993)
+
+=== 5.25.5 / 2025-03-12
+
+* 4 bug fixes:
+
+  * Bumped minimum ruby to 2.7.
+  * Fixed expectation docs for must/wont_pattern_match. (jaredcwhite)
+  * Reorder Minitest::Test.ancestors to allow reaching Minitest::Assertions#skipped? (Edouard-chin)
+  * Update the ruby and rails compatibility tables. (bquorning)
+
+=== 5.25.4 / 2024-12-03
+
+* 1 bug fix:
+
+  * Fix for must_verify definition if only requiring minitest/mock (but why?).
+
+=== 5.25.3 / 2024-12-03
+
+* 5 bug fixes:
+
+  * Fixed assert_mock to fail instead of raise on unmet mock expectations.
+  * Fixed assert_mock to take an optional message argument.
+  * Fixed formatting of unmet mock expectation messages.
+  * Fixed missing must_verify expectation to match assert_mock.
+  * minitest/pride: Fixed to use true colors with *-direct terminals (bk2204)
+
+=== 5.25.2 / 2024-11-21
+
+* 4 bug fixes:
+
+  * Include class name in spec name. (thomasmarshall)
+  * Fixed 'redefining object_id' warning from ruby 3.4. (mattbrictson)
+  * Minitest top-level namespace no longer includes entire contents of README.rdoc. Too much!
+  * Refactored spec's describe to more cleanly determine the superclass and name
+
 === 5.25.1 / 2024-08-16
 
 * 2 bug fixes:

data/README.rdoc

@@ -1,11 +1,12 @@
 = minitest/{test,spec,mock,benchmark}
 
-home :: https://github.com/minitest/minitest
+home :: https://minite.st/
+code :: https://github.com/minitest/minitest
 bugs :: https://github.com/minitest/minitest/issues
 rdoc :: https://docs.seattlerb.org/minitest
 clog :: https://github.com/minitest/minitest/blob/master/History.rdoc
-vim  :: https://github.com/sunaku/vim-ruby-minitest
 emacs:: https://github.com/arthurnn/minitest-emacs
+vim  :: https://github.com/vim-test/vim-test
 
 == DESCRIPTION:
 
@@ -95,7 +96,9 @@ Given that you'd like to test the following class:
 
 === Unit tests
 
-Define your tests as methods beginning with +test_+.
+Define your tests as methods beginning with +test_+. Use
+{assertions}[/minitest/Minitest/Assertions.html] to test for results
+or state.
 
   require "minitest/autorun"
 
@@ -119,6 +122,9 @@ Define your tests as methods beginning with +test_+.
 
 === Specs
 
+Use {expectations}[/minitest/Minitest/Expectations.html] to check
+results or state. They must be wrapped in a value call (eg +_+).
+
   require "minitest/autorun"
 
   describe Meme do
@@ -146,7 +152,7 @@ For matchers support check out:
 
 === Benchmarks
 
-Add benchmarks to your tests.
+Add {benchmarks}[/minitest/Minitest/Benchmark.html] to your tests.
 
   # optionally run benchmarks, good for CI-only work!
   require "minitest/benchmark" if ENV["BENCH"]
@@ -412,33 +418,37 @@ supporting versions of ruby that are long past EOL. Hopefully I'll be
 able to support only current versions of ruby sometime in the near
 future.
 
-(As of 2024-05-10)
+NOTICE: At this point, I will only locally test/dev against the
+currently 3 supported (non-EOL) versions of ruby. I cannot and will
+not maintain that many builds.
+
+(As of 2025-02-03)
 
 Current versions of rails: (https://endoflife.date/rails)
 
   | rails | min ruby | minitest | status   |  EOL Date  |
   |-------+----------+----------+----------+------------|
-  |   7.1 | >= 2.7   | >= 5.1   | Current  | 2026-06-01?|
-  |   7.0 | >= 2.7   | >= 5.1   | Maint    | 2025-06-01?|
-  |   6.1 | >= 2.5   | >= 5.1   | Security | 2024-06-01?|
-  |   6.0 | >= 2.5   | >= 5.1   | EOL      | 2023-06-01 |
-  |   5.2 | >= 2.2.2 | ~> 5.1   | EOL      | 2022-06-01 |
+  |   8.1 | >= 3.2   | >= 5.1   | Current  | 2027-10-07 |
+  |   8.0 | >= 3.2   | >= 5.1   | Current  | 2026-11-07 |
+  |   7.2 | >= 3.1   | >= 5.1   | Security | 2026-08-09 |
+  |   7.1 | >= 2.7   | >= 5.1   | EOL      | 2025-10-01 |
 
 If you want to look at the requirements for a specific version, run:
 
-    gem spec -r --ruby rails -v 7.0.0
+    gem spec -r --ruby rails -v 8.0.0
 
 Current versions of ruby: (https://endoflife.date/ruby)
 
   | ruby | Status  |   EOL Date |
   |------+---------+------------|
-  |  3.3 | Current | 2027-03-31 |
-  |  3.2 | Maint   | 2026-03-31 |
-  |  3.1 | Security| 2025-03-31 |
+  |  3.4 | Current | 2028-03-31 |
+  |  3.3 | Maint   | 2027-03-31 |
+  |  3.2 | Security| 2026-03-31 |
+  |  3.1 | EOL     | 2025-03-31 |
   |  3.0 | EOL     | 2024-03-31 |
   |  2.7 | EOL     | 2023-03-31 |
   |  2.6 | EOL     | 2022-03-31 |
-  |  2.5 | EOL     | 2021-03-31 | DO YOU SEE WHAT I'M STUCK WITH???
+  |  2.5 | EOL     | 2021-03-31 |
 
 === How to test SimpleDelegates?
 

data/Rakefile

@@ -1,6 +1,5 @@
 # -*- ruby -*-
 
-require "rubygems"
 require "hoe"
 $:.unshift "lib" # to pick up lib/minitest/test_task.rb when minitest not installed
 
@@ -12,7 +11,24 @@ Hoe.spec "minitest" do
 
   license "MIT"
 
-  require_ruby_version [">= 2.6", "< 4.0"]
+  require_ruby_version ">= 3.1"
+
+  self.post_install_message = <<~EOM
+    NOTE: minitest 5 will be the last in the minitest family to support
+          ruby 1.8 to 2.7. If you need to keep using these versions,
+          you need to pin your dependency to minitest with something
+          like "~> 5.0". See History.rdoc to locate compatible
+          versions.
+
+          Further, minitest 6 will be dropping the following:
+
+          + MiniTest (it's been Minitest for >10 years)
+          + MiniTest::Unit
+          + MiniTest::Unit::TestCase
+          + assert_send (unless you argue for it well)
+          + assert_equal nil, obj
+          + mocks and stubs: moving minitest/mock.rb to its own gem
+  EOM
 end
 
 desc "Find missing expectations"

data/design_rationale.rb

@@ -2,25 +2,27 @@
 ###############################################################################
 describe Thingy do                     # class TestThingy < Minitest::Test
   before do                            #   def setup
-    do_some_setup                      #     super
-  end                                  #     do_some_setup
-                                       #   end
-  it "should do the first thing" do    #
-    1.must_equal 1                     #   def test_first_thing
-  end                                  #     assert_equal 1, 1
-                                       #   end
-  describe SubThingy do                # end
-    before do                          #
-      do_more_setup                    # class TestSubThingy < TestThingy
-    end                                #   def setup
                                        #     super
-    it "should do the second thing" do #     do_more_setup
-      2.must_equal 2                   #   end
-    end                                #
-  end                                  #   def test_second_thing
-end                                    #     assert_equal 2, 2
-                                       #   end
+    do_some_setup                      #     do_some_setup
+  end                                  #   end
+                                       #
+  it "should do the first thing" do    #   def test_first_thing
+    _(1).must_equal 1                  #     assert_equal 1, 1
+  end                                  #   end
                                        # end
+                                       #
+  describe SubThingy do                # class TestSubThingy < TestThingy
+    before do                          #   def setup
+                                       #     super
+      do_more_setup                    #     do_more_setup
+    end                                #   end
+                                       #
+    it "should do the second thing" do #   def test_second_thing
+      _(2).must_equal 2                #     assert_equal 2, 2
+    end                                #   end
+  end                                  # end
+end                                    #
+                                       #
 ###############################################################################
 # runs 2 specs                         # runs 3 tests
 ###############################################################################
@@ -33,7 +35,7 @@ class ThingySpec < Minitest::Spec
   end
 
   def test_should_do_the_first_thing
-    assert_equal 1, 1
+    _(1).must_equal 1
   end
 end
 
@@ -47,6 +49,6 @@ class SubThingySpec < ThingySpec
   remove_method :test_should_do_the_first_thing
 
   def test_should_do_the_second_thing
-    assert_equal 2, 2
+    _(2).must_equal 2
   end
 end

data/lib/hoe/minitest.rb

@@ -11,7 +11,8 @@ module Hoe::Minitest
 
   def initialize_minitest
     unless minitest? then
-      dir = "../../minitest/dev/lib"
+      dir = File.expand_path "../..", __FILE__
+
       Hoe.add_include_dirs dir if File.directory? dir
     end
 

data/lib/minitest/assertions.rb

@@ -62,11 +62,11 @@ module Minitest
       return "Expected: #{mu_pp exp}\n  Actual: #{mu_pp act}" unless
         expect
 
-      Tempfile.open "expect" do |a|
+      Tempfile.create "expect" do |a|
         a.puts expect
         a.flush
 
-        Tempfile.open "butwas" do |b|
+        Tempfile.create "butwas" do |b|
           b.puts butwas
           b.flush
 
@@ -196,6 +196,12 @@ module Minitest
         .split(":in ", 2).first # clean up noise
     end
 
+    def _caller_uplevel # :nodoc:
+      backtrace = caller
+      real_caller = Minitest.filter_backtrace(caller).first
+      backtrace.index(real_caller)
+    end
+
     E = "" # :nodoc:
 
     ##
@@ -219,7 +225,7 @@ module Minitest
         if Minitest::VERSION >= "6" then
           refute_nil exp, "Use assert_nil if expecting nil."
         else
-          warn "DEPRECATED: Use assert_nil if expecting nil from #{_where}. This will fail in Minitest 6."
+          warn "DEPRECATED: Use assert_nil if expecting nil. This will fail in Minitest 6.", uplevel: _caller_uplevel
         end
       end
 
@@ -368,15 +374,12 @@ module Minitest
     # error.
 
     def assert_pattern
-      raise NotImplementedError, "only available in Ruby 3.0+" unless RUBY_VERSION >= "3.0"
       flunk "assert_pattern requires a block to capture errors." unless block_given?
 
-      begin # TODO: remove after ruby 2.6 dropped
-        yield
-        pass
-      rescue NoMatchingPatternError => e
-        flunk e.message
-      end
+      yield
+      pass
+    rescue NoMatchingPatternError => e
+      flunk e.message
     end
 
     ##
@@ -471,7 +474,7 @@ module Minitest
     # Fails unless the call returns a true value
 
     def assert_send send_ary, m = nil
-      warn "DEPRECATED: assert_send. From #{_where}"
+      warn "DEPRECATED: assert_send.", uplevel: _caller_uplevel
 
       recv, msg, *args = send_ary
       m = message(m) {
@@ -500,14 +503,9 @@ module Minitest
       value = catch sym do
         begin
           yield
-        rescue ThreadError => e       # wtf?!? 1.8 + threads == suck
-          default += ", not :#{e.message[/uncaught throw \`(\w+?)\'/, 1]}"
-        rescue ArgumentError => e     # 1.9 exception
+        rescue ArgumentError => e     # 1.9+ exception
           raise e unless e.message.include? "uncaught throw"
           default += ", not #{e.message.split(/ /).last}"
-        rescue NameError => e         # 1.8 exception
-          raise e unless e.name == sym
-          default += ", not #{e.name.inspect}"
         end
         caught = false
       end
@@ -692,8 +690,8 @@ module Minitest
     # For comparing Floats.  Fails if +exp+ and +act+ have a relative error
     # less than +epsilon+.
 
-    def refute_in_epsilon a, b, epsilon = 0.001, msg = nil
-      refute_in_delta a, b, a * epsilon, msg
+    def refute_in_epsilon exp, act, epsilon = 0.001, msg = nil
+      refute_in_delta exp, act, [exp.abs, act.abs].min * epsilon, msg
     end
 
     ##
@@ -756,15 +754,12 @@ module Minitest
     # other exceptions will be raised as normal and generate a test error.
 
     def refute_pattern
-      raise NotImplementedError, "only available in Ruby 3.0+" unless RUBY_VERSION >= "3.0"
       flunk "refute_pattern requires a block to capture errors." unless block_given?
 
-      begin
-        yield
-        flunk "NoMatchingPatternError expected, but nothing was raised."
-      rescue NoMatchingPatternError
-        pass
-      end
+      yield
+      flunk "NoMatchingPatternError expected, but nothing was raised."
+    rescue NoMatchingPatternError
+      pass
     end
 
     ##

data/lib/minitest/autorun.rb

@@ -1,6 +1,6 @@
-require "minitest"
-require "minitest/spec"
-require "minitest/mock"
-require "minitest/hell" if ENV["MT_HELL"]
+require_relative "../minitest"
+require_relative "spec"
+require_relative "mock"
+require_relative "hell" if ENV["MT_HELL"]
 
 Minitest.autorun

data/lib/minitest/benchmark.rb

@@ -1,5 +1,5 @@
-require "minitest/test"
-require "minitest/spec"
+require_relative "test"
+require_relative "spec"
 
 module Minitest
   ##

data/lib/minitest/expectations.rb

@@ -125,7 +125,7 @@ module Minitest::Expectations
   infect_an_assertion :assert_output, :must_output, :block
 
   ##
-  # See Minitest::Assertions#assert_pattern_match
+  # See Minitest::Assertions#assert_pattern
   #
   #    _ { ... }.must_pattern_match [...]
   #
@@ -293,7 +293,7 @@ module Minitest::Expectations
   infect_an_assertion :refute_operator, :wont_be, :reverse
 
   ##
-  # See Minitest::Assertions#refute_pattern_match
+  # See Minitest::Assertions#refute_pattern
   #
   #    _ { ... }.wont_pattern_match [...]
   #

data/lib/minitest/hell.rb

@@ -1,4 +1,4 @@
-require "minitest/parallel"
+require_relative "parallel"
 
 class Minitest::Test
   parallelize_me!

data/lib/minitest/manual_plugins.rb

@@ -1,4 +1,4 @@
-require "minitest"
+require_relative "../minitest"
 
 ARGV << "--no-plugins"
 

data/lib/minitest/mock.rb

@@ -30,21 +30,16 @@ module Minitest # :nodoc:
     end
 
     overridden_methods.map(&:to_sym).each do |method_id|
+      old_w, $-w = $-w, nil
       define_method method_id do |*args, **kwargs, &b|
         if @expected_calls.key? method_id then
-          if kwargs.empty? then # FIX: drop this after 2.7 dead
-            method_missing(method_id, *args, &b)
-          else
-            method_missing(method_id, *args, **kwargs, &b)
-          end
+          method_missing(method_id, *args, **kwargs, &b)
         else
-          if kwargs.empty? then # FIX: drop this after 2.7 dead
-            super(*args, &b)
-          else
-            super(*args, **kwargs, &b)
-          end
+          super(*args, **kwargs, &b)
         end
       end
+    ensure
+      $-w = old_w
     end
 
     def initialize delegator = nil # :nodoc:
@@ -142,8 +137,8 @@ module Minitest # :nodoc:
     def verify
       @expected_calls.each do |name, expected|
         actual = @actual_calls.fetch name, nil # defaults to []
-        raise MockExpectationError, "expected #{__call name, expected[0]}" unless actual
-        raise MockExpectationError, "expected #{__call name, expected[actual.size]}, got [#{__call name, actual}]" if
+        raise MockExpectationError, "Expected #{__call name, expected[0]}" unless actual
+        raise MockExpectationError, "Expected #{__call name, expected[actual.size]}, got [#{__call name, actual}]" if
           actual.size < expected.size
       end
       true
@@ -152,11 +147,7 @@ module Minitest # :nodoc:
     def method_missing sym, *args, **kwargs, &block # :nodoc:
       unless @expected_calls.key? sym then
         if @delegator && @delegator.respond_to?(sym)
-          if kwargs.empty? then # FIX: drop this after 2.7 dead
-            return @delegator.public_send(sym, *args, &block)
-          else
-            return @delegator.public_send(sym, *args, **kwargs, &block)
-          end
+          return @delegator.public_send(sym, *args, **kwargs, &block)
         else
           raise NoMethodError, "unmocked method %p, expected one of %p" %
             [sym, @expected_calls.keys.sort_by(&:to_s)]
@@ -245,13 +236,28 @@ end
 
 module Minitest::Assertions
   ##
-  # Assert that the mock verifies correctly.
+  # Assert that the mock verifies correctly and fail if not.
 
-  def assert_mock mock
+  def assert_mock mock, msg = nil
     assert mock.verify
+  rescue MockExpectationError => e
+    msg = message(msg) { e.message }
+    flunk msg
   end
 end
 
+module Minitest::Expectations
+  ##
+  # See Minitest::Assertions#assert_mock.
+  #
+  #    _(collection).must_verify
+  #
+  # :method: must_verify
+
+  infect_an_assertion :assert_mock, :must_verify, :unary if
+    defined?(infect_an_assertion)
+end
+
 ##
 # Object extensions for Minitest::Mock.
 
@@ -302,18 +308,10 @@ class Object
     else
       metaclass.send :define_method, name do |*args, **kwargs, &blk|
         if val_or_callable.respond_to? :call then
-          if kwargs.empty? then # FIX: drop this after 2.7 dead
-            val_or_callable.call(*args, &blk)
-          else
-            val_or_callable.call(*args, **kwargs, &blk)
-          end
+          val_or_callable.call(*args, **kwargs, &blk)
         else
           if blk then
-            if block_kwargs.empty? then # FIX: drop this after 2.7 dead
-              blk.call(*block_args)
-            else
-              blk.call(*block_args, **block_kwargs)
-            end
+            blk.call(*block_args, **block_kwargs)
           end
           val_or_callable
         end

data/lib/minitest/parallel.rb

@@ -1,3 +1,5 @@
+require "thread"
+
 module Minitest
   module Parallel # :nodoc:
 

data/lib/minitest/pride.rb

@@ -1,4 +1,4 @@
-require "minitest"
+require_relative "../minitest"
 
 Minitest.load_plugins
 Minitest::PrideIO.pride!

data/lib/minitest/pride_plugin.rb

@@ -1,4 +1,4 @@
-require "minitest"
+require_relative "../minitest"
 
 module Minitest
   def self.plugin_pride_options opts, _options # :nodoc:
@@ -10,7 +10,7 @@ module Minitest
   def self.plugin_pride_init options # :nodoc:
     return unless PrideIO.pride?
 
-    klass = ENV["TERM"] =~ /^xterm|-256color$/ ? PrideLOL : PrideIO
+    klass = ENV["TERM"] =~ /^xterm|-(?:256color|direct)$/ ? PrideLOL : PrideIO
     io    = klass.new options[:io]
 
     self.reporter.reporters.grep(Minitest::Reporter).each do |rep|

data/lib/minitest/spec.rb

@@ -1,4 +1,4 @@
-require "minitest/test"
+require_relative "test"
 
 class Module # :nodoc:
   def infect_an_assertion meth, new_name, dont_flip = false # :nodoc:
@@ -38,7 +38,11 @@ class Module # :nodoc:
   end
 end
 
-Minitest::Expectation = Struct.new :target, :ctx # :nodoc:
+# :stopdoc:
+module Minitest # fucking hell rdoc...
+  Expectation = Struct.new :target, :ctx
+end
+# :startdoc:
 
 ##
 # Kernel extensions for minitest
@@ -81,14 +85,15 @@ module Kernel
 
   def describe desc, *additional_desc, &block # :doc:
     stack = Minitest::Spec.describe_stack
-    name  = [stack.last, desc, *additional_desc].compact.join("::")
-    sclas = stack.last || if Class === self && kind_of?(Minitest::Spec::DSL) then
-                            self
-                          else
-                            Minitest::Spec.spec_type desc, *additional_desc
-                          end
+    is_spec_class = Class === self && kind_of?(Minitest::Spec::DSL)
+    name  = [stack.last, desc, *additional_desc]
+    name.prepend self if stack.empty? && is_spec_class
+    sclas =
+      stack.last                 \
+      || (is_spec_class && self) \
+      || Minitest::Spec.spec_type(desc, *additional_desc)
 
-    cls = sclas.create name, desc
+    cls = sclas.create name.compact.join("::"), desc
 
     stack.push cls
     cls.class_eval(&block)
@@ -284,9 +289,8 @@ class Minitest::Spec < Minitest::Test
       defined?(@name) ? @name : super
     end
 
-    def to_s # :nodoc:
-      name # Can't alias due to 1.8.7, not sure why
-    end
+    alias to_s name
+    alias inspect name
 
     attr_reader :desc # :nodoc:
     alias specify it
@@ -342,7 +346,7 @@ class Minitest::Spec < Minitest::Test
   TYPES = DSL::TYPES # :nodoc:
 end
 
-require "minitest/expectations"
+require_relative "expectations"
 
 class Object # :nodoc:
   include Minitest::Expectations unless ENV["MT_NO_EXPECTATIONS"]