A long-lived project that still receives updates
Code style checking for RSpec files. A plugin for the RuboCop code style enforcing & linting tool.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

~> 1.61
 Project Readme

RuboCop RSpec

Join the chat at https://gitter.im/rubocop-rspec/Lobby Gem Version CI

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

  • Installation
    • Upgrading to RuboCop RSpec v3.x
    • Upgrading to RuboCop RSpec v2.x
  • Usage
  • Documentation
  • The Cops
  • Contributing
  • License

Installation

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

Upgrading to RuboCop RSpec v3.x

Read all the details in our Upgrade to Version 3.x document.

Upgrading to RuboCop RSpec v2.x

Read all the details in our Upgrade to Version 2.x document.

Usage

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.

require:
  - 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

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

Code Climate

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

Documentation

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:

RSpec/SpecFilePathFormat:
  Exclude:
    - spec/my_poorly_named_spec_file.rb

Contributing

Checkout the contribution guidelines.

License

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