rubocop/rubocop-rspec

GitHub: rubocop/rubocop-rspec

Stars: 855 | Forks: 291

# RuboCop RSpec [![Join the chat at https://gitter.im/rubocop-rspec/Lobby](https://badges.gitter.im/rubocop-rspec/Lobby.svg)](https://gitter.im/rubocop-rspec/Lobby) [![Gem Version](https://badge.fury.io/rb/rubocop-rspec.svg)](https://rubygems.org/gems/rubocop-rspec) ![CI](https://static.pigsec.cn/wp-content/uploads/repos/2026/06/caceac64e8101527.svg) [RSpec](https://rspec.info/)-specific analysis for your projects, as an extension to [RuboCop](https://github.com/rubocop/rubocop). - [Installation](#installation) - [Upgrading to RuboCop RSpec v3.x](#upgrading-to-rubocop-rspec-v3x) - [Upgrading to RuboCop RSpec v2.x](#upgrading-to-rubocop-rspec-v2x) - [Usage](#usage) - [Documentation](#documentation) - [The Cops](#the-cops) - [Contributing](#contributing) - [License](#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](https://docs.rubocop.org/rubocop-rspec/3.0/upgrade_to_version_3.html) document. ### Upgrading to RuboCop RSpec v2.x Read all the details in our [Upgrade to Version 2.x](https://docs.rubocop.org/rubocop-rspec/2.0/upgrade_to_version_2.html) 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`. plugins: rubocop-rspec Alternatively, use the following array notation when specifying multiple extensions. plugins: - 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 --plugin rubocop-rspec ### Rake task RuboCop::RakeTask.new do |task| task.plugins << 'rubocop-rspec' end ### Code Climate rubocop-rspec is available on Code Climate as part of the rubocop engine. [Learn More](https://marketing.codeclimate.com/changelog/55a433bbe30ba00852000fac/). ## Documentation You can read more about RuboCop RSpec in its [official manual](https://docs.rubocop.org/rubocop-rspec). ## The Cops All cops are located under [`lib/rubocop/cop/rspec`](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 ## License `rubocop-rspec` is MIT licensed. [See the accompanying file](MIT-LICENSE.md) for the full text.