RuboCop
RubyMine supports integration with RuboCop and enables you to fix its offenses right inside the IDE, for example, in the code editor.
![RuboCop offense RuboCop offense](https://resources.jetbrains.com/help/img/idea/2021.3/rubocop_editor_offense.png)
You can also check the entire project and display all RuboCop warnings in a single report.
![RuboCop inspection results RuboCop inspection results](https://resources.jetbrains.com/help/img/idea/2021.3/rubocop_inspection_by_name_results.png)
If necessary, you can enable the Standard wrapper and use it for analyzing project sources.
Install RuboCop/Standard gems
The RuboCop inspection is enabled in RubyMine by default and requires the 'rubocop' gem to be installed in the project’s SDK. If this gem is not installed, RubyMine will suggest doing this.
![Install Rubocop Install Rubocop](https://resources.jetbrains.com/help/img/idea/2021.3/rubocop_error.png)
If you want to use Standard to analyze your project, add the 'standard' gem to your Gemfile and install it.
Enable/Disable RuboCop and Standard inspections
To enable or disable RuboCop and Standard inspections, do the following:
Open the Settings/Preferences dialog Ctrl+Alt+S.
Go to the RuboCop inspection under .
page and enable/disable theIf necessary, enable the Use 'standard' gem option to use the Standard wrapper.
Fix RuboCop offenses in the editor
When RuboCop inspections are enabled, RubyMine highlights its offenses in the code editor. To see the warning description and fix it, do the following:
Place the caret at the highlighted area and press Ctrl+F1.
To fix the offense, press Alt+Enter. You can fix all suggested offenses in a file, or you can apply only specific fixes by a class offense or cop department.
Run Rubocop inspection
RubyMine enables you to find RuboCop offenses for the entire project by running a corresponding inspection. To do this, follow the steps below:
From the main menu, go to
Ctrl+Alt+Shift+I.In the popup, find RuboCop and press Enter.
In the Run 'RuboCop' dialog, specify the scope of files that you want to analyze. If necessary, enable Use 'standard' gem. Click OK.
Wait until RubyMine analyzes your project. In the Inspection Results tool window, you can explore RuboCop offenses and fix auto-correctable ones using the Fix all auto-correctable RuboCop offenses button.
You can also explore individual files and apply specific fixes by a class offense or cop department.
Map RuboCop and IDE severities
By default, RubyMine maps RuboCop severities and inspection severities in the following way:
RuboCop severity | Inspection severity |
---|---|
Refactor, Convention | Weak Warning |
Warning | Warning |
Error, Fatal | Error |
To change the default mapping, follow the steps below:
Open the Settings/Preferences dialog Ctrl+Alt+S.
Go to the RuboCop inspection.
page and select theConfigure how RuboCop severities map to inspection severities in the RuboCop Severities Mapping group.
.rubocop.yml
RubyMine takes into account all settings specified in the .rubocop.yml file. For example, if you disable some checks for a specified cop department, the editor will not show corresponding offenses. Moreover, these offenses won't be shown in the RuboCop inspection report.
How to: Run RuboCop for the opened file with custom options
Sometimes it is necessary to run RuboCop for the currently opened file with custom options. For example, this can be useful when RuboCop inspections are disabled, or you want to assign a shortcut for a specific RuboCop action.
In this example, we'll show how to use RuboCop as an external tool to correct layout offenses in the currently opened file.
Create a custom RuboCop action
In the Settings/Preferences dialog (Ctrl+Alt+S) , select Tools | External Tools.
Click
and specify the following settings:
Name: The menu command that will be displayed in the RubyMine interface (the Tools menu and context menus).
Group: The name of the group to which the command belongs. You can select an existing group or type the name of a new group.
Program: The name of the RuboCop executable.
Arguments: The arguments passed to the executable file, as you would specify them on the command line. Here we use
-x
RuboCop option to run only layout cops for the current file.Working directory: The path to the current working directory from which the tool is executed.
Click OK to add the tool and then apply the changes.
(Optional) Assign a shortcut for the created action. In the Settings/Preferences dialog (Ctrl+Alt+S) , select Keymap, find the Fix Layout action under the RuboCop node and specify a shortcut.
Run a custom RuboCop action
To run the created RuboCop action, go to the
main menu or use the context menu of a file.When the command runs, its output is displayed in the Run tool window: