Gettings Started

To start using RuboCop, enable it in Repository Settings.

To customize RuboCop, use the standard RuboCop config file, rubocop.yml.

Versioning

If your Gemfile.lock contains dependency to RuboCop, Sider uses the locked version. Otherwise, Sider assumes you are using the latest version of RuboCop.

Default Configuration

Sider uses our recommended configuration if your repository does not have .rubocop.yml. The configuration is available as a RubyGem, called MeowCop.

• ​MeowCop​

Configuration via sideci.yml

Example settings for RuboCop under rubocop:

linter:
  rubocop:
    gems:
      - foo_gem
    config: .myrubocop.yml
    rails: false
    safe: true

Options

You can use several options to fine-tune analysis to your project:

Details of options are below:

gems

This option allows you to install RuboCop plugins or configuration gems during analysis.

linter:
  rubocop:
    gems:
      - rubocop-rspec
      - name: meowcop
        version: 1.17.0

You can specify either the name or the name and version of the gems you want to install. If the version is omitted, Sider will try to install the version specified in Gemfile.lock.

If you do not specify gems option, RuboCop analysis will start with the following pre-installed gems:

meowcop, onkcop, deka_eiwakun, forkwell_cop, cookstyle, rubocop-rails_config, salsify_rubocop,
otacop, unasukecop, sanelint, hint-rubocop_style, rubocop-salemove, mad_rubocop, unifacop,
ws-style, rubocop-config-umbrellio, pulis, gc_ruboconfig, fincop, rubocop-github, ezcater_rubocop,
rubocop-rspec, rubocop-verbose, rubocop-cask, rubocop-thread_safety

config

RuboCop uses the .rubocop.yml in the root directory of your project by default. Using this option, you can override this behavior. For example, if your .rubocop.yml is in a different directory, you could use the configoption like this:

linter:
  rubocop:
    options:
      config: lint_yml/.rubocop.yml

rails

This option controls whether to run Rails Cops. If it is omitted, Sider automatically determines whether to run Rails Cops or not.

This option is used for the case that you do not wish Sider to run Rails Cops even though your project is a Ruby on Rails project.

linter:
  rubocop:
    options:
      rails: false

safe

This option controls to cops RuboCop inspects. If true, RuboCop will inspect cops which have been set Safe: true and Enabled: true in .rubocop.yml.

When you use this option, RuboCop version must be after 0.60.0.