Update: See Make RuboCop Part of Your Tests (Updated) for a more up-to-date solution.

RuboCop is a static code analyzer, and can be a wonderful tool to help you keep your style consistent either across multiple developers, or just across a project that you work on by yourself.

This will show you how you can make it part of your specs, so you don’t forget to run it, and neither does your continuous integration tool (if applicable).

Gemfile

First, add the following to your Gemfile, making sure to not require the Rubocop library by default in Rails:

group :development, :test do
  gem 'rubocop', require: false
end

Minitest

If you are using Minitest, this is where I put my test (put yours where it makes the most sense to you).

In test/linters/rubocop_test.rb:

require 'test_helper'

class RuboCopTest < Minitest::Test
  def subject
    `rubocop`
  end

  def test_no_offenses_found
    assert_match(/no\ offenses\ detected/, subject)
  end
end

RSpec

If you are using RSpec, this is where I put my test (again, put yours where it makes the most sense to you).

In spec/linters/rubocop_spec.rb:

require 'spec_helper'

RSpec.describe 'rubocop analysis' do
  subject(:report) { `rubocop` }

  it 'has no offenses' do
    expect(report).to match(/no\ offenses\ detected/)
  end
end

RuboCop Settings

Now, you’ll likely notice that RuboCop can be a bit of a style… cop. To override any of the default settings, you’ll need to make sure to create a .rubocop.yml file, at the root of your project.

Minitest

To override the default RuboCop settings for Minitest, use something like the this:

In .rubocop.yml:

AllCops:
  Exclude:
    - 'Guardfile'
    - 'bin/*'
    - 'db/**/*'
    - 'config/**/*'
    - 'vendor/**/*'
    - 'test/test_helper\.rb'

Documentation:
  Enabled: false

# skips style of child classes and modules.
Style/ClassAndModuleChildren:
  Enabled: false

RSpec

To override the default RuboCop settings for RSpec, use something like the following:

AllCops:
  Exclude:
    - 'Guardfile'
    - 'bin/*'
    - 'db/**/*'
    - 'config/**/*'
    - 'vendor/**/*'
    - 'spec/rails_helper\.rb'
    - 'spec/spec_helper\.rb'

RSpec/DescribeClass:
  Exclude:
    - 'spec/features/*'
    - 'spec/views/**/*'
    - 'spec/lint/rubocop_spec\.rb'

Documentation:
  Enabled: false

# skips style of child classes and modules.
Style/ClassAndModuleChildren:
  Enabled: false

Metrics/BlockLength:
  ExcludedMethods: ['describe', 'context', 'shared_examples']