Web site


test-unit-rails is a Rails adapter for test-unit 3. You can use full test-unit 3 features, RR integration and Capybara integration with test-unit-rails.

Rails supports Test::Unit bundled in Ruby 1.8 and MiniTest but doesn’t support test-unit 2. Rails with test-unit 2 works but is not fully worked.


Add the following codes to your Gemfile:

ruby group :development, :test do gem 'test-unit-rails' end

Update bundled gems:

sh % bundle update

Replace "require 'rails/test_help'" in your test/test_helper.rb with the following codes:

ruby # require 'rails/test_help' require 'test/unit/rails/test_help'

Now you can use full test-unit 3.x features, RR integration and Capybara integration.


LGPLv2.1 or later.

(Kouhei Sutou has a right to change the license including contributed patches.)


  • Kouhei Sutou
  • Haruka Yoshihara