minitest 5.25.5 → 6.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e2ea23b9f86dd37b5f5f3d45fb451303827cbdf9414215d8f769da3624184325
-  data.tar.gz: 3d976e8b864261af92ba50d466235e4fa529f31d3560d60ec4deba8e724fc872
+  metadata.gz: 507bc02dff7669be704f151c1b52970df6a625a798ba3baadbb330440f6e4401
+  data.tar.gz: 12b89c4586b899dc4a0f6317cc99a1754db5dedc468cdbd8d2ae06f40926d33e
 SHA512:
-  metadata.gz: 1258d24412b8461fe9a94acb9b795a1cd2a25db2d16f924ce6367662478d9e0672532636b5a2ccd809f549ba8ba6ab8f0cbeb6e8a249b1b91161cc4297f31c92
-  data.tar.gz: 4d6a977e948f40d05e7786d07656616e9f3a4e4469a59e7b5a8e571b8f6821284989156ca4225e8e7a29cfe640bbaf544248697e14536f7c63946ffc2a34232e
+  metadata.gz: 4de7c54b989352c854e2b7769f9483c1b99dacb071752c419f55e82f3f714323d9294fc5820d5efa9e30baec7f5d346772b00dce72aa69d6d31a8b96cc57187c
+  data.tar.gz: e2b28dc14bd8caef238c4dc89007a25be3c41cc1eccaec266372c546687f2e94c3f878a4217fe1a969df21b7faef83db723ffe313cb8f850ada06682fe201875

data/History.rdoc

@@ -1,3 +1,135 @@
+=== 6.0.1 / 2025-12-26
+
+* 1 minor enhancement:
+
+  * Added new rake task `test:fu` to Minitest::TestTask, to only run
+    tests with FU (focused units?) in their name. This should mostly
+    obviate the need for the minitest-focus plugin.
+
+* 5 bug fixes:
+
+  * Fixed --help and --version exiting 1. (grosser)
+  * Fixed method signature of Minitest::Benchmark.run. (flavorjones)
+  * Flush stdout/stderr before exit./bin/minitest -Ilib ./bug1046.rb:1 < /dev/null (grosser)
+  * Improved usage banner output by reordering and reformatting.
+  * Normalize paths while processing file.rb:line args.
+
+=== 6.0.0 / 2025-12-17
+
+This is a major release. Read this.
+
+Please give feedback here: https://github.com/minitest/minitest/issues/1040
+
+Oh god... here we go... (again)
+
+* 8 deaths in the family(!!):
+
+  * Deleted MiniTest and MiniTest::Unit::TestCase compatibility namespaces.
+  * Deleted all use of Marshal for serialization.
+  * Deleted maglev? and rubinius? guard methods. LOL.
+  * Deleted all minitest/spec expectations from Object. Use _/value/expect.
+  * Dropped minitest/mock.rb. This has been extracted to the minitest-mock gem.
+  * assert_equal(nil, value) no longer allowed. Use assert_nil to be explicit.
+  * Removed assert_send. Use assert_predicate or assert_operator.
+  * Removed Minitest::Test#class_name.
+
+* 7 major (oft incompatible) changes:
+
+  * Big: Major refactored MT6's run path!
+    * Minitest.__run -> Minitest.run_all_suites
+    * Runnable.run -> Runnable.run_suite & Runnable.filter_runnable_methods
+    * Runnable.run_one_method -> Runnable.run
+    * Removed Minitest.run_one_method (might bring it back to raise?)
+  * Removed deprecated <tt>ENV["N"]</tt> to specify number of parallel tests. Use MT_CPU.
+  * Renamed +options[:filter]+ to +options[:include]+, added <tt>--include</tt> cmdline option.
+    * <tt>--name</tt> is still handled, but that will be removed in the future.
+  * Renamed Minitest::Runnable#test_order to #run_order.
+  * If #message is passed a proc then that proc overrides all other output.
+    * They are no longer chained!
+    * And it does less for formatting of your output.
+  * Removed reporter arg from with_info_handler as it has never(?) been used. (HACK?)
+  * Plugin loading is now opt-in!
+    * Require the plugin in your test_helper.
+    * Or use Minitest.load :x
+    * Or call Minitest.load_plugins for the old autoloading behavior.
+
+* 5 additions:
+
+  * Added minitest-sprint's minitest cmdline, now with line support!
+  * Added minitest-bisect. Run with minitest --bisect or -b.
+  * Added minitest-server.
+  * Added minitest/complete to help with shell's tab-completion of tests.
+  * Vendored latest version of path_expander.
+
+* 5 other:
+
+  * Bumped to ruby 3.2+.
+  * Removed obsolete conditional for CompositeReporter#prerecord.
+  * Removed obsolete version guards around Minitest::Result in reporters.
+  * assert_operator and assert_predicate both call assert_respond_to first.
+  * Assertions reuse themselves a lot more. Bumps assertion count in some places.
+
+=== 5.27.0 / 2025-12-11
+
+* 1 major enhancement:
+
+  * Adding post install message announcing the EOL for minitest 5!
+
+* 2 minor enhancements:
+
+  * Removed TestTask::Work#initialize since Queue can now initialize with an Enumerable! AMAZING!
+  * Use Kernel#warn uplevel argument for nicer warnings. (byroot)
+
+* 5 bug fixes:
+
+  * Cleaned up option aliasing a tad.
+  * Removed obsolete conditional for prerecord
+  * Removed obsolete guards around Warning.
+  * Removed obsolete version guards for pattern matching assertions.
+  * Switched all internal requires to require_relative.
+
+=== 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:

data/Manifest.txt

@@ -1,32 +1,41 @@
-.autotest
 History.rdoc
 Manifest.txt
 README.rdoc
 Rakefile
+bin/minitest
 design_rationale.rb
 lib/hoe/minitest.rb
 lib/minitest.rb
 lib/minitest/assertions.rb
 lib/minitest/autorun.rb
 lib/minitest/benchmark.rb
+lib/minitest/bisect.rb
+lib/minitest/complete.rb
 lib/minitest/compress.rb
 lib/minitest/error_on_warning.rb
 lib/minitest/expectations.rb
+lib/minitest/find_minimal_combination.rb
 lib/minitest/hell.rb
 lib/minitest/manual_plugins.rb
-lib/minitest/mock.rb
 lib/minitest/parallel.rb
+lib/minitest/path_expander.rb
 lib/minitest/pride.rb
 lib/minitest/pride_plugin.rb
+lib/minitest/server.rb
+lib/minitest/server_plugin.rb
 lib/minitest/spec.rb
+lib/minitest/sprint.rb
+lib/minitest/sprint_plugin.rb
 lib/minitest/test.rb
 lib/minitest/test_task.rb
-lib/minitest/unit.rb
 test/minitest/metametameta.rb
+test/minitest/test_bisect.rb
+test/minitest/test_find_minimal_combination.rb
 test/minitest/test_minitest_assertions.rb
 test/minitest/test_minitest_benchmark.rb
-test/minitest/test_minitest_mock.rb
 test/minitest/test_minitest_reporter.rb
 test/minitest/test_minitest_spec.rb
 test/minitest/test_minitest_test.rb
 test/minitest/test_minitest_test_task.rb
+test/minitest/test_server.rb
+test/minitest/test_path_expander.rb

data/README.rdoc

@@ -1,16 +1,17 @@
-= minitest/{test,spec,mock,benchmark}
+= minitest/{test,spec,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:
 
 minitest provides a complete suite of testing facilities supporting
-TDD, BDD, mocking, and benchmarking.
+TDD, BDD, and benchmarking.
 
     "I had a class with Jim Weirich on testing last week and we were
      allowed to choose our testing frameworks. Kirk Haines and I were
@@ -36,9 +37,6 @@ algorithms in a repeatable manner. Now you can assert that your newb
 co-worker doesn't replace your linear algorithm with an exponential
 one!
 
-minitest/mock by Steven Baker, is a beautifully tiny mock (and stub)
-object framework.
-
 minitest/pride shows pride in testing and adds coloring to your test
 output. I guess it is an example of how to write IO pipes too. :P
 
@@ -68,7 +66,6 @@ extract-method refactorings still apply.
 * minitest/autorun - the easy and explicit way to run all your tests.
 * minitest/test - a very fast, simple, and clean test system.
 * minitest/spec - a very fast, simple, and clean spec system.
-* minitest/mock - a simple and clean mock/stub system.
 * minitest/benchmark - an awesome way to assert your algorithm's performance.
 * minitest/pride - show your pride in testing!
 * minitest/test_task - a full-featured and clean rake task generator.
@@ -95,7 +92,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 +118,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 +148,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"]
@@ -185,85 +187,6 @@ outputs something like:
 
 Output is tab-delimited to make it easy to paste into a spreadsheet.
 
-=== Mocks
-
-Mocks and stubs defined using terminology by Fowler & Meszaros at
-https://www.martinfowler.com/bliki/TestDouble.html:
-
-"Mocks are pre-programmed with expectations which form a specification
-of the calls they are expected to receive. They can throw an exception
-if they receive a call they don't expect and are checked during
-verification to ensure they got all the calls they were expecting."
-
-  class MemeAsker
-    def initialize(meme)
-      @meme = meme
-    end
-
-    def ask(question)
-      method = question.tr(" ", "_") + "?"
-      @meme.__send__(method)
-    end
-  end
-
-  require "minitest/autorun"
-
-  describe MemeAsker, :ask do
-    describe "when passed an unpunctuated question" do
-      it "should invoke the appropriate predicate method on the meme" do
-        @meme = Minitest::Mock.new
-        @meme_asker = MemeAsker.new @meme
-        @meme.expect :will_it_blend?, :return_value
-
-        @meme_asker.ask "will it blend"
-
-        @meme.verify
-      end
-    end
-  end
-
-==== Multi-threading and Mocks
-
-Minitest mocks do not support multi-threading. If it works, fine, if it doesn't
-you can use regular ruby patterns and facilities like local variables. Here's
-an example of asserting that code inside a thread is run:
-
-  def test_called_inside_thread
-    called = false
-    pr = Proc.new { called = true }
-    thread = Thread.new(&pr)
-    thread.join
-    assert called, "proc not called"
-  end
-
-=== Stubs
-
-Mocks and stubs are defined using terminology by Fowler & Meszaros at
-https://www.martinfowler.com/bliki/TestDouble.html:
-
-"Stubs provide canned answers to calls made during the test".
-
-Minitest's stub method overrides a single method for the duration of
-the block.
-
-  def test_stale_eh
-    obj_under_test = Something.new
-
-    refute obj_under_test.stale?
-
-    Time.stub :now, Time.at(0) do   # stub goes away once the block is done
-      assert obj_under_test.stale?
-    end
-  end
-
-A note on stubbing: In order to stub a method, the method must
-actually exist prior to stubbing. Use a singleton method to create a
-new non-existing method:
-
-  def obj_under_test.fake_method
-    ...
-  end
-
 === Running Your Tests
 
 Ideally, you'll use a rake task to run your tests (see below), either
@@ -422,13 +345,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:
 
@@ -762,8 +682,8 @@ rematch                     :: Declutter your test files from large hardcoded da
                                and update them automatically when your code changes.
 rspec2minitest              :: Easily translate any RSpec matchers to Minitest
                                assertions and expectations.
-stubberry                   :: Multiple stubbing 'berries', sweet and useful 
-                               stub helpers and assertions. ( stub_must, 
+stubberry                   :: Multiple stubbing 'berries', sweet and useful
+                               stub helpers and assertions. ( stub_must,
                                assert_method_called, stubbing ORM objects by id )
 
 == Unknown Extensions:
@@ -794,7 +714,7 @@ Authors... Please send me a pull request with a description of your minitest ext
 
 == REQUIREMENTS:
 
-* Ruby 2.3+. No magic is involved. I hope.
+* Ruby 3.2+. No magic is involved. I hope.
 
 == INSTALL:
 

data/Rakefile

@@ -1,18 +1,23 @@
 # -*- ruby -*-
 
-require "rubygems"
 require "hoe"
 $:.unshift "lib" # to pick up lib/minitest/test_task.rb when minitest not installed
 
 Hoe.plugin :seattlerb
+Hoe.plugin :isolate
 Hoe.plugin :rdoc
+Hoe.plugin :cov
 
 Hoe.spec "minitest" do
   developer "Ryan Davis", "ryand-ruby@zenspider.com"
 
   license "MIT"
 
-  require_ruby_version [">= 2.7", "< 4.0"]
+  require_ruby_version ">= 3.2"
+
+  dependency "prism", "~> 1.5"
+
+  self.cov_filter = %w[ tmp ]
 end
 
 desc "Find missing expectations"

data/bin/minitest

@@ -0,0 +1,5 @@
+#!/usr/bin/env -S ruby
+
+require_relative "../lib/minitest/sprint"
+
+Minitest::Sprint.run

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