minitest 5.26.2 → 6.0.0.a1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b434a6ca2a7c9344e640e80ea64a4b5b1849f8b6afa49c6f00766c2be0d4860
-  data.tar.gz: 84ae1cd082c17c1abca248bfbe841ca362c9bcb96e97c64eb524b6e46a50f94b
+  metadata.gz: a01b47e47e72a229e83d2809ca755928bdd25f359c933e22c72b5ac8a171755f
+  data.tar.gz: 66fa45d45a03fb1432654237fa2dc74d955667223e22b11c81b589aafce07289
 SHA512:
-  metadata.gz: 592d2b5d8f7e33ea2c7ae8e598686df07108cd6bf3ae01bdc86871d16d17708db778716edfedb9bd6723972b7191615c9d29af7dba9b2231a70f0da394787c71
-  data.tar.gz: 407d3eb51b95f993a6809aa15ffbfa0630d31f0f18cf01854a2c68441fcda0555fdb2d2c83f41f7e605c8d4d4ade40e3785480f035e22492a54038e26900f0e7
+  metadata.gz: 7469ea92dcfe5adfe2ffe53178ad0acd4f5fc699359e52c7cfcb7519ce322294a0cd29c171bef2226618cb5d64f4f73069a2ef54fde664e78a31404e53d9b6bc
+  data.tar.gz: b12bf7908a6fcf0e22fbac91e2d68b7a30ba86a8cdb87dbe9b55adf617df6275afc6cbb97f0c4e197f762bd836aafe1c7f6e2fe22262eec5aa3eb1bae5e5699d

data/History.rdoc

@@ -1,3 +1,83 @@
+=== 6.0.0.a.1 / 2025-12-15
+
+This is an alpha level release in order to get feedback. I'm pretty
+settled on integrating minitest-sprint's minitest cmdline but less
+sold on having bisect+server integrated.
+
+Please give me 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 ENV["N"] to specify number of parallel tests. Use MT_CPU.
+  * Renamed options[:filter] to options[:include], added --include cmdline option.
+    * --name 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.
+
+* 1 voodoo:
+
+  * HACK: does anyone require minitest/test w/o minitest? that's crazy right?
+
+=== 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_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.
@@ -190,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
@@ -764,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:
@@ -796,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

@@ -4,14 +4,20 @@ 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"
+
+  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/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,8 +195,6 @@ module Minitest
         .split(":in ", 2).first # clean up noise
     end
 
-    E = "" # :nodoc:
-
     ##
     # Fails unless <tt>exp == act</tt> printing the difference between
     # the two, if possible.
@@ -212,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 from #{_where}. This will fail in Minitest 6."
-        end
-      end
+      refute_nil exp, message { "Use assert_nil if expecting nil" } if exp.nil? # don't count
 
-      result
+      assert exp == act, msg
     end
 
     ##
@@ -255,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
 
     ##
@@ -308,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
@@ -368,15 +358,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
 
     ##
@@ -389,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
@@ -448,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,21 +451,6 @@ module Minitest
       assert exp.equal?(act), msg
     end
 
-    ##
-    # +send_ary+ is a receiver, message and arguments.
-    #
-    # Fails unless the call returns a true value
-
-    def assert_send send_ary, m = nil
-      warn "DEPRECATED: assert_send. From #{_where}"
-
-      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
-    end
-
     ##
     # Fails if the block outputs anything to stderr or stdout.
     #
@@ -624,13 +595,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
 
@@ -654,8 +628,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
 
     ##
@@ -692,14 +665,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
 
     ##
@@ -725,9 +695,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
 
     ##
@@ -751,15 +720,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
 
     ##
@@ -770,6 +736,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 +759,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 "minitest"
-require "minitest/spec"
-require "minitest/mock"
-require "minitest/hell" if ENV["MT_HELL"]
+require_relative "../minitest"
+require_relative "spec"
+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
   ##