168

I have test-unit installed and rspec installed (along with -core, -expectations, -mocks and -rails version 2.6.x). When I run the command rails new foo, it uses test-unit to generate the test stub files instead of rspec.

Is there an option where I can tell rails to use rspec to generate the tests instead?

1
  • A lot of these answers are about creating a rails app without minitest, then manually adding and installing the rspec gem. What would be more useful is an answer explaining how to include a flag to set it as default, or perhaps through a rails template?
    – alex
    Jul 5, 2023 at 20:13

5 Answers 5

278

The following should work:

at command line:

rails new MYAPP -T # The -T option tells rails not to include Test::Unit

in Gemfile:

gem 'rspec-rails'

at command line:

bundle install
rails g rspec:install
6
  • I think some of those steps are out of order, no? This looks like this would work though if done in the right order. Please edit your answer and I will mark it as accepted.
    – aarona
    Jul 18, 2011 at 5:13
  • 60
    You don't need the generator.rb initializer, this is taken care of by RSpec's railtie. All you need is rspec-rails within the development group of the Gemfile which is enough to require it for the generators. You also don't need to generate the app with -T, you can delete the test dir and it will work.
    – Ryan Bigg
    Jul 18, 2011 at 5:14
  • 1
    Can you edit the code from g.test_framework = :rspec to g.test_framework :rspec Jul 2, 2013 at 10:23
  • 8
    @RyanBigg: with -T option we'll have "rails/test_unit/railtie" commented out in application.rb
    – JNN
    Sep 12, 2013 at 20:16
  • 14
    When you add the rspec-rails gem, it's important to put it under test and development, or the generators won't use RSpec even if you follow the above steps. Jun 15, 2015 at 15:16
76

Create your new rails application as:

rails new <app_name> -T

Or remove your test directory from your existing application:

rm -rf test/

Make an entry in your Gemfile:

gem 'rspec-rails'

From the command line install the gem

$ bundle install

From the command line install rspec into your application:

$ rails g rspec:install

Now your rails application uses RSpec instead of test-unit.

1
  • 2
    'bundle install' step was missing from that list. Added.
    – cczona
    Oct 29, 2012 at 20:56
10

Once you created your rails application with:

rails new <app_name> -T  # to exclude Test::Unit

Add the RSpec gem to your Gemfile in the following way:

group :development, :test do
  gem "rspec-rails"
end

In Command line write:

bundle install  # this will install the missing gems

Now you need to install RSpec by running:

rails generate rspec:install

This will generate the following files:

create  .rspec
create  spec
create  spec/spec_helper.rb
create  spec/rails_helper.rb

I strongly recommended to read through all spec_helper and rails_helper comments to get a good understanding of what each option does.

Once everything is set you can run all your tests with:

bundle exec rspec

You can read more about the recommended spec_helper and rails_helper configurations on https://kolosek.com/rails-rspec-setup.

4

I'm a new developer and I just made a rails flag (-rspec) to address OP's problem. It gets rid of Test::Unit and inserts the rails-rspec gem with a bash script. The script can be modified to help linux developers by automatically adding therubyracer gem or create custom flags and gemsets. (maybe specifically going to that gem line and deleting the comment)

Here's the gist && I hope this helps someone out there. https://gist.github.com/MTen/8310116

1

There's no native way to do this with the rails CLI. Generate a new project without test-unit:

rails new rails-app --skip-test

And then follow rspec instructions to integrate it into the new Rails app.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.