minitest 5.26.0 → 5.26.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ecf3d390663e8f655908e6feef0796c5666930f979a0010e27d5adf4956b0bfc
-  data.tar.gz: be16818cbc164296bdacde79856532e5695bd6e45dec7d28e624e75bbccbf465
+  metadata.gz: 0b434a6ca2a7c9344e640e80ea64a4b5b1849f8b6afa49c6f00766c2be0d4860
+  data.tar.gz: 84ae1cd082c17c1abca248bfbe841ca362c9bcb96e97c64eb524b6e46a50f94b
 SHA512:
-  metadata.gz: 4690ff166d9757befd4365ca3ca77443e4252c32132e91933093548b179ae051cade595e1a085e373e9f6a32b4677d38073cfc1b6e386a00bf77edc8cffad487
-  data.tar.gz: 923c90aaff33957818b8fcb053bf9fb28c01953ec910d42114cd3ba09204a0166e85824fb7188bc944f12a7855c47c0e6f63a39d2f45fcb37f25b8176416cd18
+  metadata.gz: 592d2b5d8f7e33ea2c7ae8e598686df07108cd6bf3ae01bdc86871d16d17708db778716edfedb9bd6723972b7191615c9d29af7dba9b2231a70f0da394787c71
+  data.tar.gz: 407d3eb51b95f993a6809aa15ffbfa0630d31f0f18cf01854a2c68441fcda0555fdb2d2c83f41f7e605c8d4d4ade40e3785480f035e22492a54038e26900f0e7

data/History.rdoc

@@ -1,3 +1,24 @@
+=== 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!

data/README.rdoc

@@ -95,7 +95,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 +121,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 +151,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"]
@@ -422,13 +427,10 @@ Current versions of rails: (https://endoflife.date/rails)
 
   | rails | min ruby | minitest | status   |  EOL Date  |
   |-------+----------+----------+----------+------------|
+  |   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   | Current  | 2026-08-09 |
-  |   7.1 | >= 2.7   | >= 5.1   | Security | 2025-10-01 |
-  |   7.0 | >= 2.7   | >= 5.1   | Security | 2025-04-01 |
-  |   6.1 | >= 2.5   | >= 5.1   | EOL      | 2024-10-01 |
-  |   6.0 | >= 2.5   | >= 5.1   | EOL      | 2023-06-01 |
-  |   5.2 | >= 2.2.2 | ~> 5.1   | EOL      | 2022-06-01 |
+  |   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:
 

data/Rakefile

@@ -11,7 +11,7 @@ Hoe.spec "minitest" do
 
   license "MIT"
 
-  require_ruby_version [">= 2.7", "< 4.0"]
+  require_ruby_version ">= 3.1"
 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

@@ -687,8 +687,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
 
     ##

data/lib/minitest/mock.rb

@@ -33,17 +33,9 @@ module Minitest # :nodoc:
       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
@@ -155,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)]
@@ -320,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/spec.rb

@@ -290,6 +290,7 @@ class Minitest::Spec < Minitest::Test
     end
 
     alias to_s name
+    alias inspect name
 
     attr_reader :desc # :nodoc:
     alias specify it

data/lib/minitest.rb

@@ -10,7 +10,7 @@ require_relative "minitest/compress"
 # runtime. See +Minitest.run+ for more information.
 
 module Minitest
-  VERSION = "5.26.0" # :nodoc:
+  VERSION = "5.26.2" # :nodoc:
 
   @@installed_at_exit ||= false
   @@after_run = []
@@ -147,26 +147,32 @@ module Minitest
     orig_args = args.dup
 
     OptionParser.new do |opts|
-      opts.banner  = "minitest options:"
+      opts.program_name = "minitest"
       opts.version = Minitest::VERSION
 
+      opts.banner = [
+        "Usage: rake test [A=options]        (see Minitest::TestTask for more options)",
+        "minitest [paths] [options]   (with minitest-sprint gem)",
+        "ruby path/to/test.rb [options]\n\n",
+      ].join "\n   or: "
+
       opts.on "-h", "--help", "Display this help." do
         puts opts
         exit
       end
 
-      opts.on "--no-plugins", "Bypass minitest plugin auto-loading (or set $MT_NO_PLUGINS)."
+      opts.on "--no-plugins", "Bypass minitest plugin auto-loading (or env: MT_NO_PLUGINS=1)."
 
-      desc = "Sets random seed. Also via env. Eg: SEED=n rake"
+      desc = "Sets random seed. Also via env, eg: SEED=42"
       opts.on "-s", "--seed SEED", Integer, desc do |m|
-        options[:seed] = m.to_i
+        options[:seed] = m
       end
 
-      opts.on "-v", "--verbose", "Verbose. Show progress processing files." do
+      opts.on "-v", "--verbose", "Verbose. Print each name as they run." do
         options[:verbose] = true
       end
 
-      opts.on "-q", "--quiet", "Quiet. Show no progress processing files." do
+      opts.on "-q", "--quiet", "Quiet. Show no dots while processing files." do
         options[:quiet] = true
       end
 
@@ -174,7 +180,7 @@ module Minitest
         options[:show_skips] = true
       end
 
-      opts.on "-n", "--name PATTERN", "Filter run on /regexp/ or string." do |a|
+      opts.on "-n", "--name PATTERN", "Include /regexp/ or string for run." do |a|
         options[:filter] = a
       end
 
@@ -182,21 +188,28 @@ module Minitest
         options[:exclude] = a
       end
 
+      # omg wtf
+      def opts.short_alias(from, to) = top.short[to] = top.short[from]
+      def opts.long_alias(from, to)  = top.long[to]  = top.long[from]
+
+      # these will work but won't show up in --help output:
+      opts.long_alias  "name", "include"
+      opts.short_alias "n",       "i"
+      opts.short_alias "e",       "x"
+
       opts.on "-S", "--skip CODES", String, "Skip reporting of certain types of results (eg E)." do |s|
         options[:skip] = s.chars.to_a
       end
 
-      ruby27plus = ::Warning.respond_to? :[]=
-
       opts.on "-W[error]", String, "Turn Ruby warnings into errors" do |s|
         options[:Werror] = true
         case s
         when "error", "all", nil then
           require "minitest/error_on_warning"
           $VERBOSE = true
-          ::Warning[:deprecated] = true if ruby27plus
+          ::Warning[:deprecated] = true
         else
-          ::Warning[s.to_sym] = true if ruby27plus # check validity of category
+          ::Warning[s.to_sym] = true # check validity of category
         end
       end
 
@@ -411,6 +424,7 @@ module Minitest
       pos = Regexp.new $1 if pos.kind_of?(String) && pos =~ %r%/(.*)/%
       neg = Regexp.new $1 if neg.kind_of?(String) && neg =~ %r%/(.*)/%
 
+      # at most 1-2% slower than a 1-pass version, stop optimizing this
       filtered_methods = self.runnable_methods
         .select { |m| !pos ||  pos === m || pos === "#{self}##{m}"  }
         .reject { |m|  neg && (neg === m || neg === "#{self}##{m}") }
@@ -574,7 +588,7 @@ module Minitest
     def skipped?
       raise NotImplementedError, "subclass responsibility"
     end
-  end
+  end # Runnable
 
   ##
   # Shared code for anything that can get passed to a Reporter. See
@@ -626,7 +640,7 @@ module Minitest
     def error?
       self.failures.any? UnexpectedError
     end
-  end
+  end # Reportable
 
   ##
   # This represents a test result in a clean way that can be
@@ -680,7 +694,7 @@ module Minitest
         "#{failure.result_label}:\n#{self.location}:\n#{failure.message}\n"
       }.join "\n"
     end
-  end
+  end # Result
 
   ##
   # Defines the API for Reporters. Subclass this and override whatever
@@ -730,7 +744,7 @@ module Minitest
     def synchronize &block # :nodoc:
       @mutex.synchronize(&block)
     end
-  end
+  end # AbstractReportera
 
   class Reporter < AbstractReporter # :nodoc:
     ##
@@ -885,7 +899,7 @@ module Minitest
       self.warnings   = aggregate[UnexpectedWarning].size
       self.skips      = aggregate[Skip].size
     end
-  end
+  end # StatisticsReporter
 
   ##
   # A reporter that prints the header, summary, and failure details at
@@ -963,7 +977,7 @@ module Minitest
       "%d runs, %d assertions, %d failures, %d errors, %d skips%s" %
         [count, assertions, failures, errors, skips, extra.join]
     end
-  end
+  end # SummaryReporter
 
   ##
   # Dispatch to multiple reporters as one.
@@ -1014,7 +1028,7 @@ module Minitest
     def report # :nodoc:
       self.reporters.each(&:report)
     end
-  end
+  end # CompositeReporter
 
   ##
   # Represents run failures.

data/test/minitest/test_minitest_assertions.rb

@@ -142,8 +142,7 @@ class TestMinitestAssertions < Minitest::Test
     exp[1] = Object.new
     act[1] = Object.new
     act_obj = act[1]
-    # TODO: switch to endless when 2.7 is dropped
-    act_obj.define_singleton_method(:inspect) { "#<Object:0xXXXXXX>" }
+    def act_obj.inspect = "#<Object:0xXXXXXX>"
     msg = <<~EOM.chomp % [act]
            No visible difference in the Hash#inspect output.
            You should look at the implementation of #== on Hash or its members.
@@ -1280,12 +1279,16 @@ class TestMinitestAssertions < Minitest::Test
   end
 
   def test_refute_in_epsilon_triggered
-    assert_triggered "Expected |10000 - 9990| (10) to not be <= 10.0." do
-      @tc.refute_in_epsilon 10_000, 9990
+    assert_triggered "Expected |10000 - 9991| (9) to not be <= 9.991." do
+      @tc.refute_in_epsilon 10_000, 9991
       flunk
     end
   end
 
+  def test_refute_in_epsilon_minimum
+    @tc.refute_in_epsilon 10_000, 9990
+  end
+
   def test_refute_includes
     @assertion_count = 2
 

data/test/minitest/test_minitest_mock.rb

@@ -368,11 +368,7 @@ class TestMinitestMock < Minitest::Test
     end
 
     assert_silent do
-      if RUBY_VERSION > "3" then
-        mock.foo arg1, arg2, arg3
-      else
-        mock.foo arg1, arg2, **arg3 # oddity just for ruby 2.7
-      end
+      mock.foo arg1, arg2, arg3
     end
 
     assert_mock mock
@@ -401,8 +397,8 @@ class TestMinitestMock < Minitest::Test
       mock.foo k1: arg1, k2: arg2
     end
 
-    # basically testing ruby ... need ? for ruby < 2.7 :(
-    assert_match(/missing keyword: :?k3/, e.message)
+    # basically testing ruby
+    assert_match(/missing keyword: :k3/, e.message)
   end
 
   def test_mock_block_is_passed_keyword_args__block_bad_extra
@@ -416,8 +412,7 @@ class TestMinitestMock < Minitest::Test
       mock.foo k1: arg1, k2: arg2, k3: arg3
     end
 
-    # basically testing ruby ... need ? for ruby < 2.7 :(
-    assert_match(/unknown keyword: :?k3/, e.message)
+    assert_match(/unknown keyword: :k3/, e.message)
   end
 
   def test_mock_block_is_passed_keyword_args__block_bad_value

data/test/minitest/test_minitest_spec.rb

@@ -108,7 +108,7 @@ describe Minitest::Spec do
   end
 
   it "needs to catch an expected exception" do
-    @assertion_count = 2
+    @assertion_count -= 2
 
     expect { raise "blah" }.must_raise RuntimeError
     expect { raise Minitest::Assertion }.must_raise Minitest::Assertion
@@ -939,6 +939,16 @@ class TestMeta < MetaMetaMetaTestCase
     assert_equal "ExampleB::random_method::addl_context", spec_c.name
   end
 
+  def test_inspect
+    spec_a = describe ExampleA do; end
+    spec_b = describe ExampleB, :random_method do; end
+    spec_c = describe ExampleB, :random_method, :addl_context do; end
+
+    assert_equal "ExampleA", spec_a.inspect
+    assert_equal "ExampleB::random_method", spec_b.inspect
+    assert_equal "ExampleB::random_method::addl_context", spec_c.inspect
+  end
+
   def test_name2
     assert_equal "NamedExampleA", NamedExampleA.name
     assert_equal "NamedExampleB", NamedExampleB.name

data.tar.gz.sig

@@ -1,2 +1 @@
-����I?����g��!�E%�ws�7����Q\aS�Œ8x�N���X��4�T~�h���������{>t$>�;5G��
-I���B�u����|K-&�?�Z%��^:i�/UP�p!��}�ڿ��QB�
+W����d�`)Z�x��q~6��8���2aM�?�1�����Mi#ן���!�5���y��%PJ�5�N]\�k�j6_k�(�C����)H�ݘ�Pf�ܶ[��H:;H�S�9ά�HS��^�����q�?<���qm���WŽ3��2�
m�{����.x�]9��R>y�x�x���ʂ�>�4#�D!BӖ�r��'@�#淼B����;ͻ�f8��F�����ڦ�1<dMO{adz�����)Cc�

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: minitest
 version: !ruby/object:Gem::Version
-  version: 5.26.0
+  version: 5.26.2
 platform: ruby
 authors:
 - Ryan Davis
@@ -175,10 +175,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.7'
-  - - "<"
-    - !ruby/object:Gem::Version
-      version: '4.0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

metadata.gz.sig

@@ -1,2 +1,2 @@
-UA�Xf�v ���d�-$#����,�w��L�Vn�FxE�$XP�	�@���_�*8�e7m�N��Tt��Q�}"6����=y��n�.�:Rb�I3�S-���Z�)��Җ���tRH,Z��g��QkŪ
-yd[!"�;U�#�rȔq�_�FD]B��NH���l��4S����Rɰ��9~K�ڵd/N٦�Ϫp�����:mI�݀�".�KO�3w	E� ��K�ڑ��g����9�L�!�}@�d٠Y
+�,YX�R���f�3]L�7�R /�"��t�`lޚ 5�	/��vkY�l�)m��3F���U�')�⽃�B˴�K�O��:���l?��V\�{n
+dlL�t,Y�(됛&,�	��rr\���E�����K�%3%<�#���CE�T՚[h\o9m�A����
�r���{):8g�h�P���@�ITj`2(6T��j��;�u�d�.��]?JF��P=��yMn����eZyY�R�!]qZ�h���R����K�;:�U2