Mry

Mry Migrates .Rubocop.Yml 💪

RuboCop has many many breaking changes, because it is before version 1.0. So, if you update your RuboCop version, .rubocop.yml breaks in many cases... This tool supports migrating .rubocop.yml. It automatically renames the configuration in your .rubocop.yml that was renamed by the updated RuboCop version. So, with this tool, you do not have to be afraid of updating RuboCop anymore!

Installation

Add this line to your application's Gemfile:

gem 'mry'

And then execute:

$ bundle

Or install it yourself as:

$ gem install mry

Usage

Update .rubocop.yml to latest release:

$ mry .rubocop.yml

Update .rubocop.yml to a specified version:

$ mry --target=0.51.0 .rubocop.yml

And you can specify the current RuboCop version. If you specify a new RuboCop version, mry adds cops that were added in this new RuboCop version to your .rubocop.yml. With this feature, you can check new RuboCop cops with mry.

$ mry --from=0.50.0 --target=0.51.0 .rubocop.yml
$ cat .rubocop.yml
...


# The following cops are added between 0.50.0 and 0.51.0.
# The configurations are default.
# If you want to use a cop by default, remove a configuration for the cop from here.
# If you want to disable a cop, change `Enabled` to false.

# Supports --auto-correct
Gemspec/OrderedDependencies:
  Description: Dependencies in the gemspec should be alphabetically sorted.
  Enabled: true
  Include:
  - "**/*.gemspec"
  TreatCommentsAsGroupSeparators: true

# Supports --auto-correct
Lint/RedundantWithObject:
  Description: Checks for redundant `with_object`.
  Enabled: true

...

Example

Development

How to support new version RuboCop

Run bin/check_rubocop_update script (depend on Ruby 2.6 or higher). This script displays renamed, added and deleted cop names.

# Clone rubocop repository if it does not exist.
$ git clone https://github.com/rubocop-hq/rubocop/ ~/path/to/rubocop/
$ bin/check_rubocop_update v0.55.0 v0.56.0 ~/path/to/rubocop/

(...log...)

:added:
- Lint/SplatKeywordArguments
- Performance/InefficientHashSearch
- Lint/ErbNewArguments
- Rails/AssertNot
- Rails/RefuteMethods
:renamed:
- :before:
  - Style/EmptyLineAfterGuardClause
  :after:
  - Layout/EmptyLineAfterGuardClause
- :before:
  - Style/MethodMissing
  :after:
  - Style/MethodMissingSuper
  - Style/MissingRespondToMissing
:deleted: []

Update lib/mry/added_cops.rb and lib/mry/rewriters.rb with this result.

Note: Mry does not support deleted cops and split cops. See #37 and #38.

Contributing

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

License

Copyright 2017-2018 Masataka Pocke Kuwabara

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.