minitest 5.27.0 → 6.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f9144898bc998f49d23688386cb435165b7ba6fadf83acc47f8120992d2799c6
-  data.tar.gz: f90178ecc10c76e8d0cea4c2206972b3bbb899f552c53f1b22743e00d9898a02
+  metadata.gz: e0f8b6988a17af9be0525c9517ad1fe600b55c1068997c1e396e05b1769037af
+  data.tar.gz: 5c1a38b4c98d4ee9aec32c78b80c3bfe310988d2d7ff233dcff690b6113a640b
 SHA512:
-  metadata.gz: a157620a20602d17c8aaf088cc9c709401d7fd3507569fceb85d358c5519596fdb2bd71ef8b1b597942ba9ba5ef9b0af1530fb97a47fac28add36600516d2edc
-  data.tar.gz: 17c0fdb228c63bda818fbc4009c30c88138df74e325e087050843bef8128ea54afade9de4c0e5af6d5f734ad114d34dd97e4eed2ac4e577662144ad8c49f261e
+  metadata.gz: 04db7b8165fbfe50f59dbb1ff663897fa564724e1202ccf897804b35e5b00ed0b2e8c3ddef0540e0c88abdecab36269e120c950faa452cd4c28463d864db7b82
+  data.tar.gz: 8c7c6a2a30a78c7e49cf66fdc4c10593855e1adff708078e9c98b6530ba058d9ee2542122e5cce28787b5e370a0c6e424eb7d080e3d8e580556ee1af898a284a

data/History.rdoc

@@ -1,3 +1,111 @@
+=== 6.0.3 / 2026-03-31
+
+* 1 bug fix:
+
+  * assert_same(nil, value) no longer allowed. Use assert_nil to be explicit. (paddor)
+
+=== 6.0.2 / 2026-02-23
+
+* 7 bug fixes:
+
+  * Added missing drb dependency from minitest-server. (y-yagi)
+  * Cleaned up bisect's sub-commands to load files directly, not ruby+require.
+  * Fixed bisect to use same cmd ($0) to run tests as original invocation.
+  * load server_plugin if server is loaded. (y-yagi)
+  * Manipulate local args instead of ARGV in Sprint.run.
+  * Only show --bisect in usage if using minitest.
+  * Remove -Itest:lib from bisect's rb_flags since bin/minitest adds them.
+
+=== 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:

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_path_expander.rb
+test/minitest/test_server.rb

data/README.rdoc

@@ -1,4 +1,4 @@
-= minitest/{test,spec,mock,benchmark}
+= minitest/{test,spec,benchmark}
 
 home :: https://minite.st/
 code :: https://github.com/minitest/minitest
@@ -11,7 +11,7 @@ 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
@@ -37,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
 
@@ -69,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.
@@ -191,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
@@ -687,6 +604,9 @@ minitest-happy              :: GLOBALLY ACTIVATE MINITEST PRIDE! RAWR!
 minitest-have_tag           :: Adds Minitest assertions to test for the existence of
                                HTML tags, including contents, within a provided string.
 minitest-heat               :: Reporting that builds a heat map of failure locations
+minitest-holdify            :: Stop maintaining large expected values in your
+                               test/fixture files! Hold them automatically.
+                               Update them effortlessly.
 minitest-hooks              :: Around and before_all/after_all/around_all hooks
 minitest-hyper              :: Pretty, single-page HTML reports for your Minitest runs
 minitest-implicit-subject   :: Implicit declaration of the test subject.
@@ -761,12 +681,10 @@ mongoid-minitest            :: Minitest matchers for Mongoid.
 mutant-minitest             :: Minitest integration for mutant.
 pry-rescue                  :: A pry plugin w/ minitest support. See
                                pry-rescue/minitest.rb.
-rematch                     :: Declutter your test files from large hardcoded data
-                               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:
@@ -797,7 +715,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

@@ -4,31 +4,23 @@ 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 ">= 3.1"
+  require_ruby_version ">= 3.2"
 
-  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.
+  dependency "prism", "~> 1.5"
+  dependency "drb",   "~> 2.0"
 
-          Further, minitest 6 will be dropping the following:
+  self.rdoc_locations << "l:/home/www/minite.st/html/docs"
 
-          + 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
+  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/lib/minitest/assertions.rb

@@ -186,9 +186,8 @@ module Minitest
     # Fails unless +obj+ is empty.
 
     def assert_empty obj, msg = nil
-      msg = message(msg) { "Expected #{mu_pp obj} to be empty" }
-      assert_respond_to obj, :empty?
-      assert obj.empty?, msg
+      msg = message(msg) { "Expected #{mu_pp(obj)} to be empty" }
+      assert_predicate obj, :empty?, msg
     end
 
     def _where # :nodoc:
@@ -196,14 +195,6 @@ 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:
-
     ##
     # Fails unless <tt>exp == act</tt> printing the difference between
     # the two, if possible.
@@ -218,18 +209,11 @@ module Minitest
     # See also: Minitest::Assertions.diff
 
     def assert_equal exp, act, msg = nil
-      msg = message(msg, E) { diff exp, act }
-      result = assert exp == act, msg
+      msg = message(msg, nil) { diff exp, act }
 
-      if nil == exp then
-        if Minitest::VERSION >= "6" then
-          refute_nil exp, "Use assert_nil if expecting nil."
-        else
-          warn "DEPRECATED: Use assert_nil if expecting nil. This will fail in Minitest 6.", uplevel: _caller_uplevel
-        end
-      end
+      refute_nil exp, message { "Use assert_nil if expecting nil" } if exp.nil? # don't count
 
-      result
+      assert exp == act, msg
     end
 
     ##
@@ -261,8 +245,7 @@ module Minitest
       msg = message(msg) {
         "Expected #{mu_pp collection} to include #{mu_pp obj}"
       }
-      assert_respond_to collection, :include?
-      assert collection.include?(obj), msg
+      assert_operator collection, :include?, obj, msg
     end
 
     ##
@@ -314,6 +297,7 @@ module Minitest
 
     def assert_operator o1, op, o2 = UNDEFINED, msg = nil
       return assert_predicate o1, op, msg if UNDEFINED == o2
+      assert_respond_to o1, op
       msg = message(msg) { "Expected #{mu_pp o1} to be #{op} #{mu_pp o2}" }
       assert o1.__send__(op, o2), msg
     end
@@ -392,6 +376,7 @@ module Minitest
     #   str.must_be :empty?
 
     def assert_predicate o1, op, msg = nil
+      assert_respond_to o1, op, include_all:true
       msg = message(msg) { "Expected #{mu_pp o1} to be #{op}" }
       assert o1.__send__(op), msg
     end
@@ -451,9 +436,7 @@ module Minitest
     # include_all defaults to false to match Object#respond_to?
 
     def assert_respond_to obj, meth, msg = nil, include_all: false
-      msg = message(msg) {
-        "Expected #{mu_pp obj} (#{obj.class}) to respond to ##{meth}"
-      }
+      msg = message(msg) { "Expected #{mu_pp obj} (#{obj.class}) to respond to ##{meth}" }
       assert obj.respond_to?(meth, include_all), msg
     end
 
@@ -465,22 +448,10 @@ module Minitest
         data = [mu_pp(act), act.object_id, mu_pp(exp), exp.object_id]
         "Expected %s (oid=%d) to be the same as %s (oid=%d)" % data
       }
-      assert exp.equal?(act), msg
-    end
 
-    ##
-    # +send_ary+ is a receiver, message and arguments.
-    #
-    # Fails unless the call returns a true value
+      refute_nil exp, message { "Use assert_nil if expecting nil" } if exp.nil? # don't count
 
-    def assert_send send_ary, m = nil
-      warn "DEPRECATED: assert_send.", uplevel: _caller_uplevel
-
-      recv, msg, *args = send_ary
-      m = message(m) {
-        "Expected #{mu_pp recv}.#{msg}(*#{mu_pp args}) to return true"
-      }
-      assert recv.__send__(msg, *args), m
+      assert exp.equal?(act), msg
     end
 
     ##
@@ -627,13 +598,16 @@ module Minitest
     end
 
     ##
-    # Returns a proc that will output +msg+ along with the default message.
+    # Returns a proc that delays generation of an output message. If
+    # +msg+ is a proc (eg, from another +message+ call) return +msg+
+    # as-is. Otherwise, return a proc that will output +msg+ along
+    # with the value of the result of the block passed to +message+.
 
-    def message msg = nil, ending = nil, &default
+    def message msg = nil, ending = ".", &default
+      return msg if Proc === msg
       proc {
-        msg = msg.call.chomp(".") if Proc === msg
         custom_message = "#{msg}.\n" unless msg.nil? or msg.to_s.empty?
-        "#{custom_message}#{default.call}#{ending || "."}"
+        "#{custom_message}#{default.call}#{ending}"
       }
     end
 
@@ -657,8 +631,7 @@ module Minitest
 
     def refute_empty obj, msg = nil
       msg = message(msg) { "Expected #{mu_pp obj} to not be empty" }
-      assert_respond_to obj, :empty?
-      refute obj.empty?, msg
+      refute_predicate obj, :empty?, msg
     end
 
     ##
@@ -695,14 +668,11 @@ module Minitest
     end
 
     ##
-    # Fails if +collection+ includes +obj+.
+    # Fails if +obj+ includes +sub+.
 
-    def refute_includes collection, obj, msg = nil
-      msg = message(msg) {
-        "Expected #{mu_pp collection} to not include #{mu_pp obj}"
-      }
-      assert_respond_to collection, :include?
-      refute collection.include?(obj), msg
+    def refute_includes obj, sub, msg = nil
+      msg = message(msg) { "Expected #{mu_pp obj} to not include #{mu_pp sub}" }
+      refute_operator obj, :include?, sub, msg
     end
 
     ##
@@ -728,9 +698,8 @@ module Minitest
 
     def refute_match matcher, obj, msg = nil
       msg = message(msg) { "Expected #{mu_pp matcher} to not match #{mu_pp obj}" }
-      assert_respond_to matcher, :=~
       matcher = Regexp.new Regexp.escape matcher if String === matcher
-      refute matcher =~ obj, msg
+      refute_operator matcher, :=~, obj, msg
     end
 
     ##
@@ -770,6 +739,7 @@ module Minitest
 
     def refute_operator o1, op, o2 = UNDEFINED, msg = nil
       return refute_predicate o1, op, msg if UNDEFINED == o2
+      assert_respond_to o1, op
       msg = message(msg) { "Expected #{mu_pp o1} to not be #{op} #{mu_pp o2}" }
       refute o1.__send__(op, o2), msg
     end
@@ -792,6 +762,7 @@ module Minitest
     #   str.wont_be :empty?
 
     def refute_predicate o1, op, msg = nil
+      assert_respond_to o1, op
       msg = message(msg) { "Expected #{mu_pp o1} to not be #{op}" }
       refute o1.__send__(op), msg
     end

data/lib/minitest/autorun.rb

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

data/lib/minitest/benchmark.rb

@@ -17,7 +17,7 @@ module Minitest
       self.class.io
     end
 
-    def self.run reporter, options = {} # :nodoc:
+    def self.run klass, method_name, reporter # :nodoc:
       @io = reporter.io
       super
     end