The project is in a healthy, maintained state
A RuboCop extension focused on enforcing RSpec. A place where no one is officially employed, but where useful cops can gather.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Dependencies

Runtime

 Project Readme

Rubocop::Rspec::Extra

GitHub top language GitHub Gem Version Ruby Style Guide CI Maintainability

A RuboCop extension focused on enforcing RSpec. A place where no one is officially employed, but where useful cops can gather.

Installation

Just install the rubocop-rspec-extra gem

gem install rubocop-rspec-extra

or if you use bundler put this in your Gemfile

gem 'rubocop-rspec-extra', require: false

Usage

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

RuboCop configuration file

Put this into your .rubocop.yml.

require: rubocop-rspec-extra

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

require:
  - rubocop-rspec
  - rubocop-rspec-extra

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

Command line

rubocop --require rubocop-rspec-extra

Rake task

RuboCop::RakeTask.new do |task|
  task.requires << 'rubocop-rspec-extra'
end

The Cops

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

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

RSpec/Extra/RestrictBlockTag:
  Exclude:
    - spec/my_poorly_named_spec_file.rb

Contributing

Checkout the contribution guidelines.

License

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