mattly-minitest 1.4.2.1

data/.autotest

@@ -0,0 +1,15 @@
+# -*- ruby -*-
+
+require 'autotest/restart'
+
+Autotest.add_hook :initialize do |at|
+  at.extra_class_map["MiniSpec"]             = "test/test_mini_spec.rb"
+  at.extra_class_map["TestMiniTestTestCase"] = "test/test_mini_test.rb"
+
+  at.add_exception 'coverage.info'
+  at.add_exception 'coverage'
+end
+
+# require 'autotest/rcov'
+# Autotest::RCov.command = 'rcov_info'
+

data/History.txt

@@ -0,0 +1,175 @@
+=== 1.4.2 / 2009-06-25
+
+* 1 bug fix:
+
+  * Fixed info handler for systems that don't have siginfo.
+
+=== 1.4.1 / 2009-06-23
+
+* 1 major enhancement:
+
+  * Handle ^C and other fatal exceptions by failing
+
+* 1 minor enhancement:
+
+  * Added something to catch mixed use of test/unit and minitest if $DEBUG
+
+* 1 bug fix:
+
+  * Added SIGINFO handler for finding slow tests without verbose
+
+=== 1.4.0 / 2009-06-18
+
+* 5 minor enhancement:
+
+  * Added clarification doco.
+  * Added specs and mocks to autorun.
+  * Changed spec test class creation to be non-destructive.
+  * Updated rakefile for new hoe capabilities.
+  * describes are nestable (via subclass). before/after/def inherits, specs don't.
+
+* 3 bug fixes:
+
+  * Fixed location on must/wont.
+  * Switched to __name__ to avoid common ivar name.
+  * Fixed indentation in test file (1.9).
+
+=== 1.3.1 / 2009-01-20
+
+* 1 minor enhancement:
+
+  * Added miniunit/autorun.rb as replacement for test/unit.rb's autorun.
+
+* 16 bug fixes:
+
+  * 1.9 test fixes.
+  * Bug fixes from nobu and akira for really odd scenarios. They run ruby funny.
+  * Fixed (assert|refute)_match's argument order.
+  * Fixed LocalJumpError in autorun if exception thrown before at_exit.
+  * Fixed assert_in_delta (should be >=, not >).
+  * Fixed assert_raises to match Modules.
+  * Fixed capture_io to not dup IOs.
+  * Fixed indentation of capture_io for ruby 1.9 warning.
+  * Fixed location to deal better with custom assertions and load paths. (Yuki)
+  * Fixed order of (must|wont)_include in MiniTest::Spec.
+  * Fixed skip's backtrace.
+  * Got arg order wrong in *_match in tests, message wrong as a result.
+  * Made describe private. For some reason I thought that an attribute of Kernel.
+  * Removed disable_autorun method, added autorun.rb instead.
+  * assert_match escapes if passed string for pattern.
+  * instance_of? is different from ===, use instance_of.
+
+=== 1.3.0 / 2008-10-09
+
+* 2 major enhancements:
+
+  * renamed to minitest and pulled out test/unit compatibility.
+  * mini/test.rb is now minitest/unit.rb, everything else maps directly.
+
+* 12 minor enhancements:
+
+  * assert_match now checks that act can call =~ and converts exp to a
+    regexp only if needed.
+  * Added assert_send... seems useless to me tho.
+  * message now forces to string... ruby-core likes to pass classes and arrays :(
+  * Added -v handling and switched to @verbose from $DEBUG.
+  * Verbose output now includes test class name and adds a sortable running time!
+  * Switched message generation into procs for message deferment.
+  * Added skip and renamed fail to flunk.
+  * Improved output failure messages for assert_instance_of, assert_kind_of
+  * Improved output for assert_respond_to, assert_same.
+  * at_exit now exits false instead of errors+failures.
+  * Made the tests happier and more readable imhfo.
+  * Switched index(s) == 0 to rindex(s, 0) on nobu's suggestion. Faster.
+
+* 5 bug fixes:
+
+  * 1.9: Added encoding normalization in mu_pp.
+  * 1.9: Fixed backtrace filtering (BTs are expanded now)
+  * Added back exception_details to assert_raises. DOH.
+  * Fixed shadowed variable in mock.rb
+  * Fixed stupid muscle memory message bug in assert_send.
+
+=== 1.2.1 / 2008-06-10
+
+* 7 minor enhancements:
+
+  * Added deprecations everywhere in test/unit.
+  * Added test_order to TestCase. :random on mini, :sorted on test/unit (for now).
+  * Big cleanup in test/unit for rails. Thanks Jeremy Kemper!
+  * Minor readability cleanup.
+  * Pushed setup/run/teardown down to testcase allowing specialized testcases.
+  * Removed pp. Tests run 2x faster. :/
+  * Renamed deprecation methods and moved to test/unit/deprecate.rb.
+
+=== 1.2.0 / 2008-06-09
+
+* 2 major enhancements:
+
+  * Added Mini::Spec.
+  * Added Mini::Mock. Thanks Steven Baker!!
+
+* 23 minor enhancements:
+
+  * Added bin/use_miniunit to make it easy to test out miniunit.
+  * Added -n filtering, thanks to Phil Hagelberg!
+  * Added args argument to #run, takes ARGV from at_exit.
+  * Added test name output if $DEBUG.
+  * Added a refute (was deny) for every assert.
+  * Added capture_io and a bunch of nice assertions from zentest.
+  * Added deprecation mechanism for assert_no/not methods to test/unit/assertions.
+  * Added pp output when available.
+  * Added tests for all assertions. Pretty much maxed out coverage.
+  * Added tests to verify consistency and good naming.
+  * Aliased and deprecated all ugly assertions.
+  * Cleaned out test/unit. Moved autorun there.
+  * Code cleanup to make extensions easier. Thanks Chad!
+  * Got spec args reversed in all but a couple assertions. Much more readable.
+  * Improved error messages across the board. Adds your message to the default.
+  * Moved into Mini namespace, renamed to Mini::Test and Mini::Spec.
+  * Pulled the assertions into their own module...
+  * Removed as much code as I could while still maintaining full functionality.
+    * Moved filter_backtrace into MiniTest.
+    * Removed MiniTest::Unit::run. Unnecessary.
+    * Removed location_of_failure. Unnecessary.
+    * Rewrote test/unit's filter_backtrace. Flog from 37.0 to 18.1
+  * Removed assert_send. Google says it is never used.
+  * Renamed MiniTest::Unit.autotest to #run.
+  * Renamed deny to refute.
+  * Rewrote some ugly/confusing default assertion messages.
+  * assert_in_delta now defaults to 0.001 precision. Makes specs prettier.
+
+* 9 bug fixes:
+
+  * Fixed assert_raises to raise outside of the inner-begin/rescue.
+  * Fixed for ruby 1.9 and rubinius.
+  * No longer exits 0 if exception in code PRE-test run causes early exit.
+  * Removed implementors method list from mini/test.rb - too stale.
+  * assert_nothing_raised takes a class as an arg. wtf? STUPID
+  * ".EF" output is now unbuffered.
+  * Bunch of changes to get working with rails... UGH.
+    * Added stupid hacks to deal with rails not requiring their dependencies.
+    * Now bitch loudly if someone defines one of my classes instead of requiring.
+  * Fixed infect method to work better on 1.9.
+  * Fixed all shadowed variable warnings in 1.9.
+
+=== 1.1.0 / 2007-11-08
+
+* 4 major enhancements:
+
+  * Finished writing all missing assertions.
+  * Output matches original test/unit.
+  * Documented every method needed by language implementor.
+  * Fully switched over to self-testing setup.
+
+* 2 minor enhancements:
+
+  * Added deny (assert ! test), our favorite extension to test/unit.
+  * Added .autotest and fairly complete unit tests. (thanks Chad for help here)
+
+=== 1.0.0 / 2006-10-30
+
+* 1 major enhancement
+
+  * Birthday!
+

data/Manifest.txt

@@ -0,0 +1,13 @@
+.autotest
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+design_rationale.rb
+lib/minitest/autorun.rb
+lib/minitest/mock.rb
+lib/minitest/spec.rb
+lib/minitest/unit.rb
+test/test_mini_mock.rb
+test/test_mini_spec.rb
+test/test_mini_test.rb

data/README.txt

@@ -0,0 +1,60 @@
+= minitest/{unit,spec,mock}
+
+* http://rubyforge.org/projects/bfts
+
+== DESCRIPTION:
+
+minitest/unit is a small and fast replacement for ruby's huge and slow
+test/unit. This is meant to be clean and easy to use both as a regular
+test writer and for language implementors that need a minimal set of
+methods to bootstrap a working unit test suite.
+
+mini/spec is a functionally complete spec engine.
+
+mini/mock, by Steven Baker, is a beautifully tiny mock object framework.
+
+(This package was called miniunit once upon a time)
+
+== FEATURES/PROBLEMS:
+
+* Contains minitest/unit - a simple and clean test system (301 lines!).
+* Contains minitest/spec - a simple and clean spec system (52 lines!).
+* Contains minitest/mock - a simple and clean mock system (35 lines!).
+* Incredibly small and fast runner, but no bells and whistles.
+
+== RATIONALE:
+
+See design_rationale.rb to see how specs and tests work in minitest.
+
+== REQUIREMENTS:
+
++ Ruby 1.8, maybe even 1.6 or lower. No magic is involved.
+
+== INSTALL:
+
++ sudo gem install minitest
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) Ryan Davis, Seattle.rb
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,42 @@
+# -*- ruby -*-
+
+$TESTING_MINIUNIT = true
+
+require 'rubygems'
+require 'hoe'
+
+Hoe.plugin :seattlerb
+
+Hoe.spec 'minitest' do
+  developer 'Ryan Davis', 'ryand-ruby@zenspider.com'
+
+  self.rubyforge_name = "bfts"
+end
+
+def loc dir
+  system "find #{dir} -name \\*.rb | xargs wc -l | tail -1"
+end
+
+desc "stupid line count"
+task :dickwag do
+  puts
+  puts "miniunit"
+  puts
+  print " lib  loc"; loc "lib"
+  print " test loc"; loc "test"
+  print " totl loc"; loc "lib test"
+  print " flog = "; system "flog -s lib"
+
+  puts
+  puts "test/unit"
+  puts
+  Dir.chdir File.expand_path("~/Work/svn/ruby/ruby_1_8") do
+    print " lib  loc"; loc "lib/test"
+    print " test loc"; loc "test/testunit"
+    print " totl loc"; loc "lib/test test/testunit"
+    print " flog = "; system "flog -s lib/test"
+  end
+  puts
+end
+
+# vim: syntax=Ruby

data/design_rationale.rb

@@ -0,0 +1,52 @@
+# Specs:                               # Equivalent Unit Tests:
+###############################################################################
+describe Thingy do                     # class TestThingy < MiniTest::Unit::TestCase
+  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
+                                       # end
+###############################################################################
+# runs 2 specs                         # runs 3 tests
+###############################################################################
+# The specs generate:
+
+class ThingySpec < MiniTest::Spec
+  def setup
+    super
+    do_some_setup
+  end
+
+  def test_should_do_the_first_thing
+    assert_equal 1, 1
+  end
+end
+
+class SubThingySpec < ThingySpec
+  def setup
+    super
+    do_more_setup
+  end
+
+  # because only setup/teardown is inherited, not specs
+  remove_method :test_should_do_the_first_thing
+
+  def test_should_do_the_second_thing
+    assert_equal 2, 2
+  end
+end

data/lib/minitest/autorun.rb

@@ -0,0 +1,5 @@
+require 'minitest/unit'
+require 'minitest/spec'
+require 'minitest/mock'
+
+MiniTest::Unit.autorun

data/lib/minitest/mock.rb

@@ -0,0 +1,31 @@
+class MockExpectationError < StandardError; end
+
+module MiniTest
+  class Mock
+    def initialize
+      @expected_calls = {}
+      @actual_calls = Hash.new {|h,k| h[k] = [] }
+    end
+
+    def expect(name, retval, args=[])
+      n, r, a = name, retval, args # for the closure below
+      @expected_calls[name] = { :retval => retval, :args => args }
+      self.class.__send__(:define_method, name) { |*x|
+        raise ArgumentError unless @expected_calls[n][:args].size == x.size
+        @actual_calls[n] << { :retval => r, :args => x }
+        retval
+      }
+      self
+    end
+
+    def verify
+      @expected_calls.each_key do |name|
+        expected = @expected_calls[name]
+        msg = "expected #{name}, #{expected.inspect}"
+        raise MockExpectationError, msg unless
+          @actual_calls.has_key? name and @actual_calls[name].include?(expected)
+      end
+      true
+    end
+  end
+end

data/lib/minitest/spec.rb

@@ -0,0 +1,125 @@
+#!/usr/bin/ruby -w
+
+require 'minitest/unit'
+
+class Module
+  def infect_with_assertions pos_prefix, neg_prefix, skip_re, map = {}
+    MiniTest::Assertions.public_instance_methods(false).each do |meth|
+      meth = meth.to_s
+
+      new_name = case meth
+                 when /^assert/ then
+                   meth.sub(/^assert/, pos_prefix.to_s)
+                 when /^refute/ then
+                   meth.sub(/^refute/, neg_prefix.to_s)
+                 end
+      next unless new_name
+      next if new_name =~ skip_re
+
+      regexp, replacement = map.find { |re, _| new_name =~ re }
+      new_name.sub! regexp, replacement if replacement
+
+      # warn "%-22p -> %p %p" % [meth, new_name, regexp]
+      self.class_eval <<-EOM
+        def #{new_name} *args, &block
+          return MiniTest::Spec.current.#{meth}(*args, &self)     if Proc === self
+          return MiniTest::Spec.current.#{meth}(args.first, self) if args.size == 1
+          return MiniTest::Spec.current.#{meth}(self, *args)
+        end
+      EOM
+    end
+  end
+end
+
+Object.infect_with_assertions(:must, :wont,
+                              /^(must|wont)$|wont_(throw)|
+                                 must_(block|not?_|nothing|raise$)/x,
+                              /(must_throw)s/                 => '\1',
+                              /(?!not)_same/                  => '_be_same_as',
+                              /_in_/                          => '_be_within_',
+                              /_operator/                     => '_be',
+                              /_includes/                     => '_include',
+                              /(must|wont)_(.*_of|nil|empty)/ => '\1_be_\2',
+                              /must_raises/                   => 'must_raise')
+
+class Object
+  alias :must_be_close_to :must_be_within_delta
+  alias :wont_be_close_to :wont_be_within_delta
+end
+
+module Kernel
+  def describe desc, &block
+    stack = MiniTest::Spec.describe_stack
+    prev  = MiniTest::Spec.description_stack.join(' ')
+    name  = "#{prev} #{desc}".split(/\W+/).map { |s| s.capitalize }.join + "Spec"
+    cls   = Object.class_eval "class #{name} < #{stack.last}; end; #{name}"
+
+    cls.nuke_test_methods!
+
+    stack.push cls
+    MiniTest::Spec.description_stack.push desc
+    cls.class_eval(&block)
+    MiniTest::Spec.description_stack.pop
+    stack.pop
+  end
+  private :describe
+end
+
+class MiniTest::Spec < MiniTest::Unit::TestCase
+  @@describe_stack = [MiniTest::Spec]
+  def self.describe_stack
+    @@describe_stack
+  end
+
+  @@description_stack = []
+  def self.description_stack
+    @@description_stack
+  end
+  
+  def self.current
+    @@current_spec
+  end
+
+  def initialize name
+    super
+    @@current_spec = self
+  end
+
+  def self.nuke_test_methods!
+    self.public_instance_methods.grep(/^test_/).each do |name|
+      send :undef_method, name rescue nil
+    end
+  end
+
+  def self.define_inheritable_method name, &block
+    super_method = self.superclass.instance_method name
+
+    define_method name do
+      super_method.bind(self).call if super_method # regular super() warns
+      instance_eval(&block)
+    end
+  end
+
+  def self.before(type = :each, &block)
+    raise "unsupported before type: #{type}" unless type == :each
+    define_inheritable_method :setup, &block
+  end
+
+  def self.after(type = :each, &block)
+    raise "unsupported after type: #{type}" unless type == :each
+    define_inheritable_method :teardown, &block
+  end
+
+  def self.it desc, &block
+    define_method "test_#{description_stack.join(' ').gsub(/\W+/, '_')}_#{desc.gsub(/\W+/, '_').downcase}", &block
+  end
+  
+  # beacuse test names are really just comments, and therefore a code smell
+  def self.expect(desc=nil, &block)
+    @minitest_expection_counter ||= 0; @minitest_expectation_counter += 1
+    desc ||= "[#{@minitest_expection_counter}]"
+    name = ["test_", description_stack, desc].flatten.join('_')
+    define_method name, &block
+  end
+  
+end