Skip to content

A RuboCop extension focused on enforcing Rails best practices and coding conventions.

License

Notifications You must be signed in to change notification settings

nvasilevski/rubocop-rails

This branch is 1193 commits behind rubocop/rubocop-rails:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

6986c02 · Jun 21, 2021
Apr 6, 2021
May 24, 2021
Oct 18, 2018
Jun 21, 2021
Jun 21, 2021
Feb 25, 2021
Jun 21, 2021
Jun 21, 2021
Jun 15, 2021
Jun 12, 2021
Mar 22, 2019
Oct 18, 2018
Oct 26, 2018
Apr 6, 2021
Jan 24, 2020
Jun 21, 2021
May 24, 2021
Apr 24, 2021
Jan 1, 2021
Feb 25, 2021
May 24, 2021
Feb 25, 2021
May 21, 2019
Apr 21, 2021

Repository files navigation

RuboCop Rails

Gem Version CircleCI

A RuboCop extension focused on enforcing Rails best practices and coding conventions.

Note: This repository manages rubocop-rails gem (>= 2.0.0). rubocop-rails gem (<= 1.5.0) has been renamed to rubocop-rails_config gem.

Installation

Just install the rubocop-rails gem

gem install rubocop-rails

or if you use bundler put this in your Gemfile

gem 'rubocop-rails', require: false

Usage

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

RuboCop configuration file

Put this into your .rubocop.yml.

require: rubocop-rails

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

require:
  - rubocop-other-extension
  - rubocop-rails

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

Command line

rubocop --require rubocop-rails

Note: --rails option is required while rubocop command supports --rails option.

Rake task

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

The Cops

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

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

Rails/FindBy:
  Exclude:
    - lib/example.rb

Documentation

You can read a lot more about RuboCop Rails in its official docs.

Compatibility

Rails cops support the following versions:

  • Rails 4.2+

Readme Badge

If you use RuboCop Rails in your project, you can include one of these badges in your readme to let people know that your code is written following the community Rails Style Guide.

Rails Style Guide

Rails Style Guide

Here are the Markdown snippets for the two badges:

[![Rails Style Guide](https://img.shields.io/badge/code_style-rubocop-brightgreen.svg)](https://github.com/rubocop/rubocop-rails)

[![Rails Style Guide](https://img.shields.io/badge/code_style-community-brightgreen.svg)](https://rails.rubystyle.guide)

Contributing

Checkout the contribution guidelines.

License

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

About

A RuboCop extension focused on enforcing Rails best practices and coding conventions.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Ruby 100.0%