Branched miniunit into minitest w/o test/unit compatibility

zenspider · zenspider · commit 17bc421f953a · 2008-10-09T10:24:41.000-08:00
[git-p4: depot-paths = "//src/minitest/dev/": change = 4312]
diff --git a/.autotest b/.autotest
@@ -0,0 +1,13 @@
+# -*- ruby -*-
+
+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'
+
diff --git a/History.txt b/History.txt
@@ -0,0 +1,83 @@
+=== 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!
+
diff --git a/Manifest.txt b/Manifest.txt
@@ -0,0 +1,17 @@
+.autotest
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/use_miniunit
+lib/mini/mock.rb
+lib/mini/spec.rb
+lib/mini/test.rb
+lib/test/unit.rb
+lib/test/unit/assertions.rb
+lib/test/unit/deprecate.rb
+lib/test/unit/error.rb
+lib/test/unit/testcase.rb
+test/test_mini_mock.rb
+test/test_mini_spec.rb
+test/test_mini_test.rb
diff --git a/README.txt b/README.txt
@@ -0,0 +1,57 @@
+= mini/{test,spec,mock}
+
+* http://rubyforge.org/projects/bfts
+
+== DESCRIPTION:
+
+mini/test is a completely minimial drop-in replacement for ruby's
+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.
+
+== FEATURES/PROBLEMS:
+
+* Contains mini/test - a simple and clean test system (301 lines!).
+* Contains mini/spec - a simple and clean spec system (52 lines!).
+* Contains mini/mock - a simple and clean mock system (35 lines!).
+* Fully test/unit compatible assertions.
+* Allows test/unit to be required, firing up an autorunner.
+* Incredibly small and fast runner, but no bells and whistles.
+* Incompatible at the runner level.
+
+== REQUIREMENTS:
+
++ Ruby 1.8, maybe even 1.6 or lower. No magic is involved.
+
+== INSTALL:
+
++ sudo gem install miniunit
+
+== 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.
diff --git a/Rakefile b/Rakefile
@@ -0,0 +1,65 @@
+# -*- ruby -*-
+
+$TESTING_MINIUNIT = true
+
+require 'rubygems'
+require 'hoe'
+require './lib/mini/test.rb'
+
+Hoe.new('miniunit', Mini::Test::VERSION) do |miniunit|
+  miniunit.rubyforge_name = "bfts"
+
+  miniunit.developer('Ryan Davis', 'ryand-ruby@zenspider.com')
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |t|
+    t.verbose = true
+    t.rcov_opts << "--include-file lib/test"
+    t.rcov_opts << "--no-color"
+  end
+
+  task :rcov_info do
+    pattern = ENV['PATTERN'] || "test/test_*.rb"
+    ruby "-Ilib -S rcov --text-report --include-file lib/test --save coverage.info #{pattern}"
+  end
+
+  task :rcov_overlay do
+    rcov, eol = Marshal.load(File.read("coverage.info")).last[ENV["FILE"]], 1
+    puts rcov[:lines].zip(rcov[:coverage]).map { |line, coverage|
+      bol, eol = eol, eol + line.length
+      [bol, eol, "#ffcccc"] unless coverage
+    }.compact.inspect
+  end
+rescue LoadError
+  # skip
+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
diff --git a/bin/use_miniunit b/bin/use_miniunit
@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby
+
+require 'rbconfig'
+
+use_miniunit = ARGV.shift
+sitelib = Config::CONFIG["sitelibdir"]
+projdir = File.dirname(File.dirname(File.expand_path(__FILE__)))
+minidir = File.join(projdir, "lib")
+
+case use_miniunit
+when /^y/ then
+  File.symlink File.join(minidir, "mini"), File.join(sitelib, "mini")
+  File.symlink File.join(minidir, "test"), File.join(sitelib, "test")
+  puts "Added links to #{sitelib}"
+when /^n/ then
+  File.unlink File.join(sitelib, "mini")
+  File.unlink File.join(sitelib, "test")
+  puts "Removed links from #{sitelib}"
+else
+  pgm = File.basename __FILE__
+  puts "usage: #{pgm} (yes|no)"
+  exit 1
+end
diff --git a/lib/mini/mock.rb b/lib/mini/mock.rb
@@ -0,0 +1,31 @@
+class MockExpectationError < StandardError; end
+
+require 'mini/test'
+
+class Mini::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
diff --git a/lib/mini/spec.rb b/lib/mini/spec.rb
@@ -0,0 +1,82 @@
+#!/usr/bin/ruby -w
+
+require 'mini/test'
+
+class Module
+  def infect_with_assertions pos_prefix, neg_prefix, skip_re, map = {}
+    Mini::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 Mini::Spec.current.#{meth}(*args, &self)     if Proc === self
+          return Mini::Spec.current.#{meth}(args.first, self) if args.size == 1
+          return Mini::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
+    cls = Class.new(Mini::Spec)
+    Object.const_set desc.to_s.split(/\W+/).map { |s| s.capitalize }.join, cls
+
+    cls.class_eval(&block)
+  end
+end
+
+class Mini::Spec < Mini::Test::TestCase
+  def self.current
+    @@current_spec
+  end
+
+  def initialize name
+    super
+    @@current_spec = self
+  end
+
+  def self.before(type = :each, &block)
+    raise "unsupported before type: #{type}" unless type == :each
+    define_method :setup, &block
+  end
+
+  def self.after(type = :each, &block)
+    raise "unsupported after type: #{type}" unless type == :each
+    define_method :teardown, &block
+  end
+
+  def self.it desc, &block
+    define_method "test_#{desc.gsub(/\W+/, '_').downcase}", &block
+  end
+end
diff --git a/lib/mini/test.rb b/lib/mini/test.rb
diff --git a/test/test_mini_mock.rb b/test/test_mini_mock.rb
diff --git a/test/test_mini_spec.rb b/test/test_mini_spec.rb
diff --git a/test/test_mini_test.rb b/test/test_mini_test.rb
