= Test::Unit::Testcase - Setup and Teardown with blocks

If you find this plugin useful, please consider a donation to show your support!

  http://www.paypal.com/cgi-bin/webscr?cmd=_send-money
  
  Email address: jonathan.viney@gmail.com
  
== Instructions

The current implementation of <tt>setup</tt> and <tt>teardown</tt> by Test::Unit and Rails only allow
the setup method to be overridden once. In the following example, only the <tt>setup</tt> and <tt>teardown</tt>
methods in <tt>PersonTest</tt> will be executed:

  class Test::Unit::TestCase
    # This is overridden by the subclass and will not be called
    def setup
    end
    
    # This is overridden by the subclass and will not be called
    def teardown
    end
  end
  
  class PersonTest < Test::Unit::TestCase
    # This overrides the method in the superclass
    def setup
    end
    
    # This overrides the method in the superclass
    def teardown
    end
    
    # Only the setup and teardown methods in this class will be called
    def test_name
    end
  end
  
This behaviour is quite standard in object oriented programming, but in the case of <tt>Test::Unit</tt> it would be nice to be able to define
multiple <tt>setup</tt> and <tt>teardown</tt> methods.
  
This implementation of <tt>setup</tt> and <tt>teardown</tt> makes use of blocks, rather than full methods. The above example becomes:

  class Test::Unit::TestCase
    setup do
    end
    
    teardown do
    end
  end
  
  class PersonTest < Test::Unit::TestCase
    setup do
    end
    
    teardown do
    end
    
    def test_name
    end
  end
  
Both <tt>setup</tt> and <tt>teardown</tt> can be called in class definitions as many times as required and,
during testing, are executed in the order they are defined. 

Existing code will continue to work as before. Code containing <tt>setup</tt> and <tt>teardown</tt> methods do not have
to be converted to block format although it is recommended for consistency.
  
== Resources

Installation

* script/plugin install http://svn.viney.net.nz/things/rails/plugins/testcase_setup_and_teardown_with_blocks

Help

* Give me an email: jonathan dot viney AT gmail dot com