Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Minitest integration for Rails

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
test
.autotest
.gemtest
.gitignore
CHANGELOG.rdoc
Manifest.txt
README.rdoc
Rakefile
minitest-rails.gemspec

README.rdoc

minitest-rails

MiniTest integration for Rails 3.1.

Install

gem install minitest-rails

This installs the following gems:

minitest

Configure

Create a new rails app without Test::Unit:

rails new MyApp --skip-test-unit

Add minitest-rails to the :test and :development groups in Gemfile:

group :test, :development do
  gem 'minitest-rails'
end

Or, for the truly enlightened, add minitest-rails to the :test and :development groups in Isolate:

env :development, :test do
  gem 'minitest-rails'
end

Next run the installation generator with the following:

rails generate mini_test:install

This will add the minitest_helper.rb file to the test directory.

Usage

We aim to expose MiniTest with minimal changes for testing within Rails. Your test classes will inherit from MiniTest::Rails::ActiveSupport::TestCase a opposed to ActiveSupport::TestCase. You can use the MiniTest::Spec DSL. You can generate test files with the standard model, controller, resource, and other generators:

rails generate model User

And you can specify generating the tests using the MiniTest::Spec DSL on any of the generators by providing the --spec option:

rails generate model User --spec

And you can specify generating the fixture for a model by providing the --fixture option:

rails generate model User --fixture

You can also set these as defaults by adding the following to the config/application.rb file:

config.generators do |g|
  g.test_framework :mini_test, :spec => true, :fixture => true
end

Get Involved

Join the mailing list to get help or offer suggestions.

groups.google.com/forum/#!forum/minitest-rails

Something went wrong with that request. Please try again.