minitest 5.8.5 → 5.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8dad41a87490a39b8f9f9ccd35a6b33965d0caa3
-  data.tar.gz: c9ab496fbc15c655346c6819e4ff43702c8c1a20
+  metadata.gz: 7222450b56e3f834bababb2da8a48bb3d86221b9
+  data.tar.gz: fc32acc2e59ef4f4213d1fb04b05233618428a7e
 SHA512:
-  metadata.gz: 292cffb9720f07b7f97a657e89a9fa2e0db19b058ff13a2f596c8cc5420f75bc6501db4b8199a35b29a3bf8f4db04259c81a2d7641d30569b8e81bd2dc75bb56
-  data.tar.gz: bce829c8fb1208d812f342276bf30799a44fb86dc0415a3e320494934484bd102bc8cda8926b8178a8977ee6faa8bba9e00b2dda5aad9c5d982b462552be4c5d
+  metadata.gz: 543abb19775adc233fedb6a4970a8d9064e38d19aad6ba881f4464d6f800aefd3ccd7cc42ca24b2f0bd7ff4bf44310d4e6e379b6779cdf08496c1dbdb72db321
+  data.tar.gz: c780aa0cb535f5754e7b30f5d7450825ecdf9e1452819d4c8de53809f243c94463fb2b75c994295b637160976c454e18f5f18a3fac258037c271bed29ba97389

data/History.rdoc

@@ -1,9 +1,19 @@
-=== 5.8.5 / 2016-09-25
+=== 5.9.0 / 2016-05-16
 
-* 2 bug fixes:
+* 8 minor enhancements:
+
+  * Added Minitest.info_signal accessors to customize signal for test run info. (nate)
+  * Added assert_mock to make it more clear that you're testing w/ them.
+  * Added negative filter by test name. (utilum)
+  * Added warning to README that 1.8 and 1.9 support will be dropped in minitest 6.
+  * Automatically activate minitest/hell if $MT_HELL is defined.
+  * Improved default error messages for assert and refute. (bhenderson)
+  * minitest/hell now tries to require minitest/proveit
+  * mu_pp for strings prints out non-standard encodings to improve assert_equal diffs.
+
+* 1 bug fix:
 
-  * Re-release to refresh gem certificate signing. ugh.
-  * Fixed hoe/minitest to not augment load path if we're actually testing minitest.  
+  * Removed Interrupt from PASSTHROUGH_EXCEPTIONS (already handled). (waldyr)
 
 === 5.8.4 / 2016-01-21
 

data/Manifest.txt

@@ -23,4 +23,4 @@ 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_unit.rb
+test/minitest/test_minitest_test.rb

data/README.rdoc

@@ -1,4 +1,4 @@
-= minitest/{unit,spec,mock,benchmark}
+= minitest/{test,spec,mock,benchmark}
 
 home :: https://github.com/seattlerb/minitest
 bugs :: https://github.com/seattlerb/minitest/issues
@@ -22,12 +22,12 @@ TDD, BDD, mocking, and benchmarking.
 
     -- Wayne E. Seguin
 
-minitest/unit is a small and incredibly fast unit testing framework.
+minitest/test is a small and incredibly fast unit testing framework.
 It provides a rich set of assertions to make your tests clean and
 readable.
 
 minitest/spec is a functionally complete spec engine. It hooks onto
-minitest/unit and seamlessly bridges test assertions over to spec
+minitest/test and seamlessly bridges test assertions over to spec
 expectations.
 
 minitest/benchmark is an awesome way to assert the performance of your
@@ -41,7 +41,7 @@ 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
 
-minitest/unit is meant to have a clean implementation for language
+minitest/test is meant to have a clean implementation for language
 implementors that need a minimal set of methods to bootstrap a working
 test suite. For example, there is no magic involved for test-case
 discovery.
@@ -65,12 +65,13 @@ extract-method refactorings still apply.
 == FEATURES/PROBLEMS:
 
 * minitest/autorun - the easy and explicit way to run all your tests.
-* minitest/unit - a very fast, simple, and clean test system.
+* 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!
 * Incredibly small and fast runner, but no bells and whistles.
+* Written by squishy human beings. Software can never be perfect. We will all eventually die.
 
 == RATIONALE:
 
@@ -92,7 +93,7 @@ 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_+.
 
   require "minitest/autorun"
 
@@ -160,7 +161,7 @@ Add benchmarks to your tests.
 Or add them to your specs. If you make benchmarks optional, you'll
 need to wrap your benchmarks in a conditional since the methods won't
 be defined. In minitest 5, the describe name needs to match
-/Bench(mark)?$/.
+<tt>/Bench(mark)?$/</tt>.
 
   describe "Meme Benchmark" do
     if ENV["BENCH"] then
@@ -267,7 +268,7 @@ Ideally, you'll use a rake task to run your tests, either piecemeal or
 all at once. Both rake and rails ship with rake tasks for running your
 tests. BUT! You don't have to:
 
-    % ruby -Ilib:test test/minitest/test_minitest_unit.rb
+    % ruby -Ilib:test test/minitest/test_minitest_test.rb
     Run options: --seed 37685
 
     # Running:
@@ -279,14 +280,15 @@ tests. BUT! You don't have to:
     155 runs, 317 assertions, 0 failures, 0 errors, 0 skips
 
 There are runtime options available, both from minitest itself, and also
-provided via plugins. To see them, simply run with `--help`:
+provided via plugins. To see them, simply run with +--help+:
 
-    % ruby -Ilib:test test/minitest/test_minitest_unit.rb --help
+    % ruby -Ilib:test test/minitest/test_minitest_test.rb --help
     minitest options:
         -h, --help                       Display this help.
         -s, --seed SEED                  Sets random seed
         -v, --verbose                    Verbose. Show progress processing files.
         -n, --name PATTERN               Filter run on /pattern/ or string.
+        -e, --exclude PATTERN            Exclude /regexp/ or string from run.
 
     Known extensions: pride, autotest
         -p, --pride                      Pride. Show your testing pride!
@@ -297,8 +299,8 @@ provided via plugins. To see them, simply run with `--help`:
 To define a plugin, add a file named minitest/XXX_plugin.rb to your
 project/gem. That file must be discoverable via ruby's LOAD_PATH (via
 rubygems or otherwise). Minitest will find and require that file using
-Gem.find_files. It will then try to call plugin_XXX_init during
-startup. The option processor will also try to call plugin_XXX_options
+Gem.find_files. It will then try to call +plugin_XXX_init+ during
+startup. The option processor will also try to call +plugin_XXX_options+
 passing the OptionParser instance and the current options hash. This
 lets you register your own command-line options. Here's a totally
 bogus example:
@@ -324,7 +326,7 @@ bogus example:
 Minitest uses composite reporter to output test results using multiple
 reporter instances. You can add new reporters to the composite during
 the init_plugins phase. As we saw in +plugin_bonus_init+ above, you
-simply add your reporter instance to the composite via +<<+.
+simply add your reporter instance to the composite via <tt><<</tt>.
 
 +AbstractReporter+ defines the API for reporters. You may subclass it
 and override any method you want to achieve your desired behavior.
@@ -389,12 +391,12 @@ outputs a failure:
 
 Worker is a SimpleDelegate which in 1.9+ is a subclass of BasicObject.
 Expectations are put on Object (one level down) so the Worker
-(SimpleDelegate) hits `method_missing` and delegates down to the
-`Object.new` instance. That object doesn't respond to work so the test
+(SimpleDelegate) hits +method_missing+ and delegates down to the
++Object.new+ instance. That object doesn't respond to work so the test
 fails.
 
-You can bypass `SimpleDelegate#method_missing` by extending the worker
-with `Minitest::Expectations`. You can either do that in your setup at
+You can bypass <tt>SimpleDelegate#method_missing</tt> by extending the worker
+with <tt>Minitest::Expectations</tt>. You can either do that in your setup at
 the instance level, like:
 
     before do
@@ -426,17 +428,17 @@ Use a module. That's exactly what they're for:
       end
     end
 
-Remember, `describe` simply creates test classes. It's just ruby at
+Remember, +describe+ simply creates test classes. It's just ruby at
 the end of the day and all your normal Good Ruby Rules (tm) apply. If
 you want to extend your test using setup/teardown via a module, just
 make sure you ALWAYS call super. before/after automatically call super
 for you, so make sure you don't do it twice.
 
-=== Why am I seeing `uninitialized constant MiniTest::Test (NameError)`?
+=== Why am I seeing <tt>uninitialized constant MiniTest::Test (NameError)</tt>?
 
-Are you running the test with Bundler (e.g. via `bundle exec`)? If so, 
-in order to require minitest, you must first add the `gem 'minitest'`
-to your Gemfile and run `bundle`. Once it's installed, you should be 
+Are you running the test with Bundler (e.g. via <tt>bundle exec</tt> )? If so, 
+in order to require minitest, you must first add the <tt>gem 'minitest'</tt>
+to your Gemfile and run +bundle+. Once it's installed, you should be 
 able to require minitest and run your tests.
 
 == Prominent Projects using Minitest:
@@ -454,12 +456,12 @@ able to require minitest and run your tests.
 
 capybara_minitest_spec      :: Bridge between Capybara RSpec matchers and
                                Minitest::Spec expectations (e.g.
-                               page.must_have_content("Title")).
+                               <tt>page.must_have_content("Title")</tt>).
 color_pound_spec_reporter   :: Test names print Ruby Object types in color with
                                your Minitest Spec style tests.
 minispec-metadata           :: Metadata for describe/it blocks & CLI tag filter.
-                               E.g. `it "requires JS driver", js: true do` &
-                               `ruby test.rb --tag js` runs tests tagged :js.
+                               E.g. <tt>it "requires JS driver", js: true do</tt> &
+                               <tt>ruby test.rb --tag js</tt> runs tests tagged :js.
 minitest-around             :: Around block for minitest. An alternative to
                                setup/teardown dance.
 minitest-assert_errors      :: Adds Minitest assertions to test for errors raised
@@ -549,7 +551,7 @@ minitest-sequel             :: Minitest assertions to speed-up development and
                                testing of Ruby Sequel database setups.
 minitest-shared_description :: Support for shared specs and shared spec
                                subclasses
-minitest-should_syntax      :: RSpec-style +x.should == y+ assertions for
+minitest-should_syntax      :: RSpec-style <tt>x.should == y</tt> assertions for
                                Minitest.
 minitest-shouldify          :: Adding all manner of shoulds to Minitest (bad
                                idea)
@@ -606,6 +608,7 @@ Authors... Please send me a pull request with a description of your minitest ext
 == REQUIREMENTS:
 
 * Ruby 1.8.7+. No magic is involved. I hope.
+* NOTE: 1.8 and 1.9 will be dropped in minitest 6+.
 
 == INSTALL:
 

data/lib/hoe/minitest.rb

@@ -4,22 +4,16 @@ class Hoe
 end
 
 module Hoe::Minitest
-  def minitest?
-    self.name == "minitest"
-  end
-
   def initialize_minitest
-    unless minitest? then
-      dir = "../../minitest/dev/lib"
-      Hoe.add_include_dirs dir if File.directory? dir
-    end
+    dir = "../../minitest/dev/lib"
+    Hoe.add_include_dirs dir if File.directory? dir
 
     gem "minitest"
     require "minitest"
     version = Minitest::VERSION.split(/\./).first(2).join(".")
 
     dependency "minitest", "~> #{version}", :development unless
-      minitest? or ENV["MT_NO_ISOLATE"]
+      self.name == "minitest" or ENV["MT_NO_ISOLATE"]
   end
 
   def define_minitest_tasks
@@ -27,6 +21,6 @@ module Hoe::Minitest
 
     # make sure we use the gemmed minitest on 1.9
     self.test_prelude = 'gem "minitest"' unless
-      minitest? or ENV["MT_NO_ISOLATE"]
+      self.name == "minitest" or ENV["MT_NO_ISOLATE"]
   end
 end

data/lib/minitest.rb

@@ -7,7 +7,7 @@ require "minitest/parallel"
 # :include: README.rdoc
 
 module Minitest
-  VERSION = "5.8.5" # :nodoc:
+  VERSION = "5.9.0" # :nodoc:
   ENCS = "".respond_to? :encoding # :nodoc:
 
   @@installed_at_exit ||= false
@@ -39,6 +39,12 @@ module Minitest
 
   mc.send :attr_accessor, :extensions
 
+  ##
+  # The signal to use for dumping information to STDERR. Defaults to "INFO".
+
+  mc.send :attr_accessor, :info_signal
+  self.info_signal = "INFO"
+
   ##
   # Registers Minitest to run at process exit
 
@@ -181,6 +187,10 @@ module Minitest
         options[:filter] = a
       end
 
+      opts.on "-e", "--exclude PATTERN", "Exclude /regexp/ or string from run." do |a|
+        options[:exclude] = a
+      end
+
       unless extensions.empty?
         opts.separator ""
         opts.separator "Known extensions: #{extensions.join(", ")}"
@@ -286,6 +296,13 @@ module Minitest
         filter === m || filter === "#{self}##{m}"
       }
 
+      exclude = options[:exclude]
+      exclude = Regexp.new $1 if exclude =~ %r%/(.*)/%
+
+      filtered_methods.delete_if { |m|
+        exclude === m || exclude === "#{self}##{m}"
+      }
+
       return if filtered_methods.empty?
 
       with_info_handler reporter do
@@ -315,7 +332,7 @@ module Minitest
         end
       end
 
-      on_signal "INFO", handler, &block
+      on_signal ::Minitest.info_signal, handler, &block
     end
 
     SIGNALS = Signal.list # :nodoc:
@@ -612,6 +629,10 @@ module Minitest
       self.reporters = reporters
     end
 
+    def io # :nodoc:
+      reporters.first.io
+    end
+
     ##
     # Add another reporter to the mix.
 

data/lib/minitest/assertions.rb

@@ -1,3 +1,5 @@
+# encoding: UTF-8
+
 require "rbconfig"
 require "tempfile"
 require "stringio"
@@ -104,7 +106,15 @@ module Minitest
 
     def mu_pp obj
       s = obj.inspect
-      s = s.encode Encoding.default_external if defined? Encoding
+
+      if defined? Encoding then
+        s = s.encode Encoding.default_external
+
+        if String === obj && obj.encoding != Encoding.default_external then
+          s = "# encoding: #{obj.encoding}\n#{s}"
+        end
+      end
+
       s
     end
 
@@ -124,7 +134,7 @@ module Minitest
     def assert test, msg = nil
       self.assertions += 1
       unless test then
-        msg ||= "Failed assertion, no message given."
+        msg ||= "Expected #{mu_pp test} to be truthy."
         msg = msg.call if Proc === msg
         raise Minitest::Assertion, msg
       end
@@ -152,7 +162,8 @@ module Minitest
     #
     # If there is no visible difference but the assertion fails, you
     # should suspect that your #== is buggy, or your inspect output is
-    # missing crucial details.
+    # missing crucial details.  For nicer structural diffing, set
+    # Minitest::Test.make_my_diffs_pretty!
     #
     # For floats use assert_in_delta.
     #
@@ -252,6 +263,8 @@ module Minitest
     # "" if you require it to be silent. Pass in a regexp if you want
     # to pattern match.
     #
+    #   assert_output(/hey/) { method_with_output }
+    #
     # NOTE: this uses #capture_io, not #capture_subprocess_io.
     #
     # See also: #assert_silent
@@ -501,7 +514,7 @@ module Minitest
     # Fails if +test+ is truthy.
 
     def refute test, msg = nil
-      msg ||= "Failed refutation, no message given"
+      msg ||= message { "Expected #{mu_pp(test)} to not be truthy" }
       not assert !test, msg
     end
 

data/lib/minitest/autorun.rb

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

data/lib/minitest/benchmark.rb

@@ -18,8 +18,7 @@ module Minitest
     end
 
     def self.run reporter, options = {} # :nodoc:
-      # NOTE: this is truly horrible... but I don't see a way around this ATM.
-      @io = reporter.reporters.first.io
+      @io = reporter.io
       super
     end
 

data/lib/minitest/hell.rb

@@ -9,3 +9,9 @@ class Minitest::Test
     end
   end
 end
+
+begin
+  require "minitest/proveit"
+rescue LoadError
+  # do nothing
+end

data/lib/minitest/mock.rb

@@ -166,6 +166,15 @@ module Minitest # :nodoc:
   end
 end
 
+module Minitest::Assertions
+  ##
+  # Assert that the mock verifies correctly.
+
+  def assert_mock mock
+    assert mock.verify
+  end
+end
+
 ##
 # Object extensions for Minitest::Mock.
 

data/lib/minitest/test.rb

@@ -11,8 +11,7 @@ module Minitest
     require "minitest/assertions"
     include Minitest::Assertions
 
-    PASSTHROUGH_EXCEPTIONS = [NoMemoryError, SignalException, # :nodoc:
-                              Interrupt, SystemExit]
+    PASSTHROUGH_EXCEPTIONS = [NoMemoryError, SignalException, SystemExit] # :nodoc:
 
     class << self; attr_accessor :io_lock; end # :nodoc:
     self.io_lock = Mutex.new
@@ -273,7 +272,7 @@ module Minitest
         warn "\nCurrent: %s#%s %.2fs" % [self.class, self.name, Minitest.clock_time - t0]
       end
 
-      self.class.on_signal "INFO", handler, &block
+      self.class.on_signal ::Minitest.info_signal, handler, &block
     end
 
     include LifecycleHooks

data/lib/minitest/unit.rb

@@ -34,7 +34,7 @@ module Minitest
       Minitest.autorun
     end
 
-    def self.after_tests(&b)
+    def self.after_tests(&b) # :nodoc:
       from = caller.first
       warn "MiniTest::Unit.after_tests is now Minitest.after_run. From #{from}"
       Minitest.after_run(&b)