minitest 5.20.0 → 5.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 667a803a272949e7b05440f91a56155ea3977a5b9d364542801889c5a2fe0ff0
-  data.tar.gz: 862bf0ff3d24eea4bbe6c7f435ceef19aaa97748f6a87ec3fa51dc218ca79298
+  metadata.gz: f9144898bc998f49d23688386cb435165b7ba6fadf83acc47f8120992d2799c6
+  data.tar.gz: f90178ecc10c76e8d0cea4c2206972b3bbb899f552c53f1b22743e00d9898a02
 SHA512:
-  metadata.gz: 2284c84ae5f98a3454e9a95417e609ca1a8ef9af8ee8b1fad8f2aca2632fde6a309e266ef1d399d9a7d47337cdcba696500a1b36f1fa7d952615eb390a89e329
-  data.tar.gz: a76204f74c2caf693a4302065815b871863ae655372d25fc4d41e416b0d4935704c1e1068457b5cda934312e3915ae8a27595ca962c98e544dd45b54cac2aef7
+  metadata.gz: a157620a20602d17c8aaf088cc9c709401d7fd3507569fceb85d358c5519596fdb2bd71ef8b1b597942ba9ba5ef9b0af1530fb97a47fac28add36600516d2edc
+  data.tar.gz: 17c0fdb228c63bda818fbc4009c30c88138df74e325e087050843bef8128ea54afade9de4c0e5af6d5f734ad114d34dd97e4eed2ac4e577662144ad8c49f261e

checksums.yaml.gz.sig

@@ -1,4 +1,4 @@
-a�>�
-t��f��΋>+�e�(|��}��{xu�&��f�D��*�J�������[�o:S�/:��B��ؐ�O�֧ ��8���~�#[�g˯�v���0��v�hj	��Pο~�Z�P��@4��0�ӌ�W81&��������
-<�N��䀡IA�/k��_ ��H��'��\8���tR�
-p�TPڜ�p6��^��O��sR��-R���z@��������^JoP4���d_��� H��x|��
+
+��ި�f5e4|���8%8V�:��]X�o���q
+��uץ6 ��#�()��u��N������<�ƅ�v
+�������75��NY���x�z@�~�9�� {��e�\���E�N��jp�4�2ovX�l1��f�k�����Ru��qvO�d��%��
�������87y�5�4r����

data/History.rdoc

@@ -1,3 +1,206 @@
+=== 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:
+
+  * Fix incompatibility caused by minitest-hooks & rails invading minitest internals.
+  * Revert change from =~ to match? to allow for nil if $TERM undefined.
+
+=== 5.25.0 / 2024-08-13
+
+* 2 minor enhancements:
+
+  * Fixed some inefficiencies filtering and matching (mostly backtraces).
+  * Refactored siginfo handler to reduce runtime costs. Saved ~30%!
+
+* 5 bug fixes:
+
+  * Added missing rdoc to get back to 100% coverage.
+  * Cleaning up ancient code checking for defined?(Encoding) and the like.
+  * Disambiguated some shadowed variables in minitest/compress.
+  * Fixed an ironic bug if using string-literals AND Werror.
+  * Improve description of test:slow task. (stomar)
+
+=== 5.24.1 / 2024-06-29
+
+* 1 bug fix:
+
+  * Fix the error message when an extension is invalid value. (y-yagi)
+
+=== 5.24.0 / 2024-06-18
+
+* 2 minor enhancements:
+
+  * Added Minitest.register_plugin.
+  * Extended plugin system to work with modules/classes for opt-out plugins.
+
+* 1 bug fix:
+
+  * Removed anacronism, but allow load_plugins to exit gracefully if --disable=gems.
+
+=== 5.23.1 / 2024-05-21
+
+* 1 bug fix:
+
+  * Fully qualify the Queue class to avoid conflicts with other libraries. (rafaelfranca)
+
+=== 5.23.0 / 2024-05-15
+
+* 3 minor enhancements:
+
+  * Added -Werror to raise on any warning output. (byroot)
+  * Added UnexpectedWarning as a failure summary type, added count to output if activated.
+  * Added minitest/manual_plugins.rb w/ new Minitest.load method. (tenderlove)
+
+* 2 bug fixes:
+
+  * Allow empty_run! and reporter to display summary for empty runs. (zzak)
+  * Make test task verbose using either rake's -v or -t (was just -t).
+
+=== 5.22.3 / 2024-03-13
+
+* 1 minor enhancement:
+
+  * MASSIVE improvement of minitest's pride plugin output: Frequencies doubled! Sine waves shifted!! Comments improved!!! Colors rotated!!!! (havenwood)
+
+* 3 bug fixes:
+
+  * Improved wording on Minitest::Test#parallelize_me! to clarify it goes INSIDE your test class/describe.
+  * Minor changes to tests to pass when tests ran with extra flags (eg -p).
+  * Support Ruby 3.4's new error message format. (mame)
+
+=== 5.22.2 / 2024-02-07
+
+* 1 bug fix:
+
+  * Third time's a charm? Remember: 'ensure' is almost always the
+    wrong way to go (for results... it's great for cleaning up).
+
+=== 5.22.1 / 2024-02-06
+
+* 1 bug fix:
+
+  * Don't exit non-zero if no tests ran and no filter (aka, the test file is empty).
+    (I'm starting to think the exit 1 thing for @tenderlove was a mistake...)
+
+=== 5.22.0 / 2024-02-05
+
+* 1 minor enhancement:
+
+  * Added "did you mean" output if your --name filter matches nothing. (tenderlove)
+
+* 2 bug fixes:
+
+  * Big cleanup of test filtering. Much prettier / more functional.
+  * Fix situation where Assertion#location can't find the location. (pftg)
+
+=== 5.21.2 / 2024-01-17
+
+* 1 bug fix:
+
+  * Fixed bug in Minitest::Compress#compress formatting w/ nested patterns. Now recurses properly.
+
+=== 5.21.1 / 2024-01-11
+
+* 1 bug fix:
+
+  * Rails' default backtrace filter can't currently work with caller_locations, so reverting back to caller.
+
+=== 5.21.0 / 2024-01-11
+
+* 10 minor enhancements:
+
+  * Add include_all kw arg to assert_respond_to and refute_respond_to.
+  * Added --quiet flag to skip ProgressReporter (prints the dots). Minor speedup.
+  * Added Minitest::Compress#compress and added it to UnexpectedError.
+  * Added ability to initialize BacktraceFilter w/ custom regexp.
+  * Filter failure backtraces using backtrace_filter before calculating location. (thomasmarshall)
+  * Make BacktraceFilter#filter compatible with locations (still compares strings).
+  * Optimized Assertion#location ~30%.
+  * Output relative paths for all failures/errors/backtraces.
+  * Refactored location information in assertions, now using locations.
+  * Removed thread and mutex_m dependencies. (hsbt, eregon)
+
+* 2 bug fixes:
+
+  * Drop undocumented bt arg in #skip. Dunno why that ever happened, prolly for testing?
+  * Fix mock to work with ruby debugger enabled. (keithlayne)
+
 === 5.20.0 / 2023-09-06
 
 * 1 minor enhancement:
@@ -9,7 +212,7 @@
 * 2 minor enhancements:
 
   * Add metadata lazy accessor to Runnable / Result. (matteeyah)
-  * Only load minitest/unit (aka ancient MiniTest compatibility layer) if ENV["MT_COMPAT"]
+  * Only load minitest/unit (aka ancient MiniTest compatibility layer) if \ENV[\"MT_COMPAT\"]
 
 * 1 bug fix:
 
@@ -20,7 +223,7 @@
 * 3 bug fixes:
 
   * Avoid extra string allocations when filtering tests. (tenderlove)
-  * Only mention deprecated ENV['N'] if it is an integer string.
+  * Only mention deprecated \ENV[\'N\'] if it is an integer string.
   * Push up test_order to Minitest::Runnable to fix minitest/hell. (koic)
 
 === 5.18.0 / 2023-03-04
@@ -214,7 +417,7 @@
 
 * 3 bug fixes:
 
-  * Check `option[:filter]` klass before match. Fixes 2.6 warning. (y-yagi)
+  * Check \option[:filter] klass before match. Fixes 2.6 warning. (y-yagi)
   * Fixed Assertions#diff from recalculating if set to nil
   * Fixed spec section of readme to not use deprecated global expectations. (CheezItMan)
 

data/Manifest.txt

@@ -9,8 +9,11 @@ lib/minitest.rb
 lib/minitest/assertions.rb
 lib/minitest/autorun.rb
 lib/minitest/benchmark.rb
+lib/minitest/compress.rb
+lib/minitest/error_on_warning.rb
 lib/minitest/expectations.rb
 lib/minitest/hell.rb
+lib/minitest/manual_plugins.rb
 lib/minitest/mock.rb
 lib/minitest/parallel.rb
 lib/minitest/pride.rb

data/README.rdoc

@@ -1,10 +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
-vim  :: https://github.com/sunaku/vim-ruby-minitest
+clog :: https://github.com/minitest/minitest/blob/master/History.rdoc
 emacs:: https://github.com/arthurnn/minitest-emacs
+vim  :: https://github.com/vim-test/vim-test
 
 == DESCRIPTION:
 
@@ -94,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"
 
@@ -118,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
@@ -145,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"]
@@ -405,35 +412,41 @@ Using our example above, here is how we might implement MyCI:
 
 === What versions are compatible with what? Or what versions are supported?
 
-Minitest is a dependency of rails, which until fairly recently had an
+Minitest is a dependency of rails, which until very recently had an
 overzealous backwards compatibility policy. As such, I'm stuck
 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 2023-03-05)
+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 | rec ruby | minitest | status   |  EOL Date  |
-  |-------+----------+----------+----------+----------+------------|
-  |   7.0 | >= 2.7   |      3.1 | >= 5.1   | Current  | 2025-06-01?|
-  |   6.1 | >= 2.5   |      3.0 | >= 5.1   | Maint    | 2024-06-01?|
-  |   6.0 | >= 2.5   |      2.6 | >= 5.1   | Security | 2023-06-01 |
-  |   5.2 | >= 2.2.2 |      2.5 | ~> 5.1   | EOL      | 2022-06-01 |
+  | 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   | 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.2 | Current | 2026-03-31 |
-  |  3.1 | Maint   | 2025-03-31 |
-  |  3.0 | Maint   | 2024-03-31 |
-  |  2.7 | Security| 2023-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 |
 

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"
@@ -33,6 +49,7 @@ task :specs do
     /_includes/                            => "_include",
     /(must|wont)_(.*_of|nil|silent|empty)/ => '\1_be_\2',
     /must_raises/                          => "must_raise",
+    /(must|wont)_pattern/                  => '\1_pattern_match',
     /(must|wont)_predicate/                => '\1_be',
     /(must|wont)_path_exists/              => 'path_\1_exist',
   }
@@ -72,4 +89,9 @@ task :bugs do
   sh "for f in bug*.rb ; do echo $f; echo; #{Gem.ruby} -Ilib $f && rm $f ; done"
 end
 
+Minitest::TestTask.create :testW0 do |t|
+  t.warning = false
+  t.test_prelude = "$-w = nil"
+end
+
 # vim: syntax=Ruby

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

@@ -1,6 +1,7 @@
 # :stopdoc:
 
 class Hoe
+  # empty
 end
 
 module Hoe::Minitest
@@ -10,13 +11,14 @@ 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
 
     gem "minitest"
     require "minitest"
-    version = Minitest::VERSION.split(/\./).first(2).join(".")
+    version = Minitest::VERSION.split(".").first(2).join "."
 
     dependency "minitest", "~> #{version}", :development unless
       minitest? or ENV["MT_NO_ISOLATE"]