RuboCop RSpec

Join the chat at Gem Version CircleCI Test Coverage Maintainability

RSpec-specific analysis for your projects, as an extension to RuboCop.


Just install the rubocop-rspec gem

gem install rubocop-rspec

or if you use bundler put this in your Gemfile

gem 'rubocop-rspec', require: false


You need to tell RuboCop to load the RSpec extension. There are three ways to do this:

RuboCop configuration file

Put this into your .rubocop.yml.

require: rubocop-rspec

Alternatively, use the following array notation when specifying multiple extensions.

  - rubocop-other-extension
  - rubocop-rspec

Now you can run rubocop and it will automatically load the RuboCop RSpec cops together with the standard cops.

Command line

rubocop --require rubocop-rspec

Rake task do |task|
  task.requires << 'rubocop-rspec'

Code Climate

rubocop-rspec is available on Code Climate as part of the rubocop engine. Learn More.


You can read more about RuboCop-RSpec in its official manual.

The Cops

All cops are located under lib/rubocop/cop/rspec, and contain examples/documentation.

In your .rubocop.yml, you may treat the RSpec cops just like any other cop. For example:

    - spec/my_poorly_named_spec_file.rb


Checkout the contribution guidelines.


rubocop-rspec is MIT licensed. See the accompanying file for the full text.