BOXT Ruby Style Guide

This repo is now archived in favour of https://github.com/boxt/boxt_rubocop.

Ruby style guide and base Rubocop settings for Boxt Ruby projects.

For the most part we are using this Ruby style guide as the base guide, with any deviations can be found in the default.yml.

• Ruby 3.0

Add this line to your application's Gemfile:

group :development, :test do
  # ...
  gem "boxt_ruby_style_guide"
end

And then execute:

bundle

Add a .rubocop.yml file to the root of your project with the following settings:

inherit_gem:
  boxt_ruby_style_guide:
    - default.yml # use default cops
    - rails.yml # use Rails cops - see Additional Extensions/Cops
    - rspec.yml # use rspec cops - see Additional Extensions/Cops

NewCops is enabled by default.

The following Rubocop gems are also installed with this gem:

• rubocop-faker
• rubocop-rails
• rubocop-rake
• rubocop-rspec

To enable add the following to your .rubocop.yml file.

inherit_gem:
  boxt_ruby_style_guide:
  # .... add cops

require:
  - rubocop-faker # if your project is using the Faker gem then add this
  - rubocop-rails # if your project is a Rails app/engine then add this, plus the - rails.yml setting above
  - rubocop-rake # if your project is using rake then add this
  - rubocop-rspec # if your project is using rspec then add this, plus the - rspec.yml setting above

There are also some useful Rubocop editor plugins to help with in-editor linting.

• linter-rubocop
• rubocop-auto-correct

• rubocop

• ruby-rubocop

Bug reports and pull requests are welcome on GitHub at https://github.com/boxt/ruby_style_guide.

The gem is available as open source under the terms of the MIT License.