Add custom RuboCop for `assert_not` over `refute`
Since at least cf4afc4 we have preferred `assert_not` methods over
`refute` methods. I have seen plenty of comments in PRs about this,
and we have tried to fix it a few times (5294ad8, e45f176, 8910f12,
41f50be, d4cfd54, 48a183e, and 211adb4), but the `refute` methods
keep sneaking back in.
This custom RuboCop will take care of enforcing this preference, so we
don't have to think about it again. I suspect there are other similar
stylistic preferences that could be solved with some custom RuboCops, so
I will definitely keep my eyes open. `assert_not` over `assert !` might
be a good candidate, for example.
I wasn't totally sure if `ci/custom_cops` was the best place to put
this, but nothing else seemed quite right. At one point I had it set up
as a gem, but I think custom cops like this would have limited value
in another context.
I want to see how code climate handles the new cops before
autocorrecting the existing violations. If things go as expected, I will
push another commit with those corrections.
2018-04-03 20:50:00 -04:00
|
|
|
require: './ci/custom_cops/lib/custom_cops'
|
|
|
|
|
2016-06-13 10:29:50 -04:00
|
|
|
AllCops:
|
2018-02-17 16:02:18 -05:00
|
|
|
TargetRubyVersion: 2.4
|
2016-08-06 11:45:37 -04:00
|
|
|
# RuboCop has a bunch of cops enabled by default. This setting tells RuboCop
|
2016-08-07 07:06:51 -04:00
|
|
|
# to ignore them, so only the ones explicitly set in this file are enabled.
|
2016-06-13 10:29:50 -04:00
|
|
|
DisabledByDefault: true
|
2016-08-06 11:45:37 -04:00
|
|
|
Exclude:
|
|
|
|
- '**/templates/**/*'
|
|
|
|
- '**/vendor/**/*'
|
2016-12-24 09:33:02 -05:00
|
|
|
- 'actionpack/lib/action_dispatch/journey/parser.rb'
|
2016-06-13 10:29:50 -04:00
|
|
|
|
Add custom RuboCop for `assert_not` over `refute`
Since at least cf4afc4 we have preferred `assert_not` methods over
`refute` methods. I have seen plenty of comments in PRs about this,
and we have tried to fix it a few times (5294ad8, e45f176, 8910f12,
41f50be, d4cfd54, 48a183e, and 211adb4), but the `refute` methods
keep sneaking back in.
This custom RuboCop will take care of enforcing this preference, so we
don't have to think about it again. I suspect there are other similar
stylistic preferences that could be solved with some custom RuboCops, so
I will definitely keep my eyes open. `assert_not` over `assert !` might
be a good candidate, for example.
I wasn't totally sure if `ci/custom_cops` was the best place to put
this, but nothing else seemed quite right. At one point I had it set up
as a gem, but I think custom cops like this would have limited value
in another context.
I want to see how code climate handles the new cops before
autocorrecting the existing violations. If things go as expected, I will
push another commit with those corrections.
2018-04-03 20:50:00 -04:00
|
|
|
# Prefer assert_not_x over refute_x
|
|
|
|
CustomCops/RefuteNot:
|
|
|
|
Include:
|
|
|
|
- '**/*_test.rb'
|
|
|
|
|
2016-08-06 11:45:37 -04:00
|
|
|
# Prefer &&/|| over and/or.
|
|
|
|
Style/AndOr:
|
2016-07-19 23:35:11 -04:00
|
|
|
Enabled: true
|
2016-06-13 10:29:50 -04:00
|
|
|
|
2016-08-06 11:45:37 -04:00
|
|
|
# Do not use braces for hash literals when they are the last argument of a
|
|
|
|
# method call.
|
|
|
|
Style/BracesAroundHashParameters:
|
2016-07-19 23:35:11 -04:00
|
|
|
Enabled: true
|
2017-08-12 07:31:46 -04:00
|
|
|
EnforcedStyle: context_dependent
|
2016-06-13 10:29:50 -04:00
|
|
|
|
2016-08-06 11:45:37 -04:00
|
|
|
# Align `when` with `case`.
|
2017-05-24 14:33:50 -04:00
|
|
|
Layout/CaseIndentation:
|
2016-07-19 23:35:11 -04:00
|
|
|
Enabled: true
|
2016-06-13 10:29:50 -04:00
|
|
|
|
2016-09-14 04:57:52 -04:00
|
|
|
# Align comments with method definitions.
|
2017-05-24 14:33:50 -04:00
|
|
|
Layout/CommentIndentation:
|
2016-09-14 04:57:52 -04:00
|
|
|
Enabled: true
|
|
|
|
|
2018-01-17 22:09:16 -05:00
|
|
|
Layout/ElseAlignment:
|
|
|
|
Enabled: true
|
|
|
|
|
2017-07-10 09:36:57 -04:00
|
|
|
Layout/EmptyLineAfterMagicComment:
|
|
|
|
Enabled: true
|
|
|
|
|
2016-08-06 11:45:37 -04:00
|
|
|
# In a regular class definition, no empty lines around the body.
|
2017-05-24 14:33:50 -04:00
|
|
|
Layout/EmptyLinesAroundClassBody:
|
2016-07-19 23:35:11 -04:00
|
|
|
Enabled: true
|
2016-06-13 10:29:50 -04:00
|
|
|
|
2017-02-12 06:44:15 -05:00
|
|
|
# In a regular method definition, no empty lines around the body.
|
2017-05-24 14:33:50 -04:00
|
|
|
Layout/EmptyLinesAroundMethodBody:
|
2017-02-12 06:44:15 -05:00
|
|
|
Enabled: true
|
|
|
|
|
2016-08-06 11:45:37 -04:00
|
|
|
# In a regular module definition, no empty lines around the body.
|
2017-05-24 14:33:50 -04:00
|
|
|
Layout/EmptyLinesAroundModuleBody:
|
2016-07-19 23:35:11 -04:00
|
|
|
Enabled: true
|
2016-07-17 03:10:45 -04:00
|
|
|
|
2017-07-16 05:11:03 -04:00
|
|
|
Layout/FirstParameterIndentation:
|
|
|
|
Enabled: true
|
|
|
|
|
2016-08-06 11:45:37 -04:00
|
|
|
# Use Ruby >= 1.9 syntax for hashes. Prefer { a: :b } over { :a => :b }.
|
|
|
|
Style/HashSyntax:
|
2016-07-19 23:35:11 -04:00
|
|
|
Enabled: true
|
2016-07-17 03:10:45 -04:00
|
|
|
|
2016-07-21 07:49:13 -04:00
|
|
|
# Method definitions after `private` or `protected` isolated calls need one
|
|
|
|
# extra level of indentation.
|
2017-05-24 14:33:50 -04:00
|
|
|
Layout/IndentationConsistency:
|
2016-07-19 23:35:11 -04:00
|
|
|
Enabled: true
|
2016-07-17 03:10:45 -04:00
|
|
|
EnforcedStyle: rails
|
|
|
|
|
2016-08-06 11:45:37 -04:00
|
|
|
# Two spaces, no tabs (for indentation).
|
2017-05-24 14:33:50 -04:00
|
|
|
Layout/IndentationWidth:
|
2016-07-19 23:35:11 -04:00
|
|
|
Enabled: true
|
2016-07-17 03:10:45 -04:00
|
|
|
|
2017-12-14 03:30:54 -05:00
|
|
|
Layout/LeadingCommentSpace:
|
|
|
|
Enabled: true
|
|
|
|
|
2017-05-24 14:33:50 -04:00
|
|
|
Layout/SpaceAfterColon:
|
2016-10-28 23:05:58 -04:00
|
|
|
Enabled: true
|
|
|
|
|
2017-05-24 14:33:50 -04:00
|
|
|
Layout/SpaceAfterComma:
|
2016-10-28 23:05:58 -04:00
|
|
|
Enabled: true
|
|
|
|
|
2017-05-24 14:33:50 -04:00
|
|
|
Layout/SpaceAroundEqualsInParameterDefault:
|
2016-10-28 23:05:58 -04:00
|
|
|
Enabled: true
|
|
|
|
|
2017-05-24 14:33:50 -04:00
|
|
|
Layout/SpaceAroundKeyword:
|
2016-10-28 23:05:58 -04:00
|
|
|
Enabled: true
|
|
|
|
|
2017-05-24 14:33:50 -04:00
|
|
|
Layout/SpaceAroundOperators:
|
2016-10-28 23:05:58 -04:00
|
|
|
Enabled: true
|
|
|
|
|
2017-12-12 06:00:50 -05:00
|
|
|
Layout/SpaceBeforeComma:
|
|
|
|
Enabled: true
|
|
|
|
|
2017-05-24 14:33:50 -04:00
|
|
|
Layout/SpaceBeforeFirstArg:
|
2016-10-28 23:05:58 -04:00
|
|
|
Enabled: true
|
|
|
|
|
2017-11-27 01:16:12 -05:00
|
|
|
Style/DefWithParentheses:
|
|
|
|
Enabled: true
|
|
|
|
|
2016-08-06 11:45:37 -04:00
|
|
|
# Defining a method with parameters needs parentheses.
|
|
|
|
Style/MethodDefParentheses:
|
|
|
|
Enabled: true
|
|
|
|
|
2017-07-09 08:06:36 -04:00
|
|
|
Style/FrozenStringLiteralComment:
|
|
|
|
Enabled: true
|
|
|
|
EnforcedStyle: always
|
2017-07-23 11:36:41 -04:00
|
|
|
Exclude:
|
|
|
|
- 'actionview/test/**/*.builder'
|
|
|
|
- 'actionview/test/**/*.ruby'
|
2017-07-24 16:20:53 -04:00
|
|
|
- 'actionpack/test/**/*.builder'
|
|
|
|
- 'actionpack/test/**/*.ruby'
|
2017-08-22 01:32:27 -04:00
|
|
|
- 'activestorage/db/migrate/**/*.rb'
|
2017-07-09 08:06:36 -04:00
|
|
|
|
2016-08-16 03:30:11 -04:00
|
|
|
# Use `foo {}` not `foo{}`.
|
2017-05-24 14:33:50 -04:00
|
|
|
Layout/SpaceBeforeBlockBraces:
|
2016-08-16 03:30:11 -04:00
|
|
|
Enabled: true
|
|
|
|
|
|
|
|
# Use `foo { bar }` not `foo {bar}`.
|
2017-05-24 14:33:50 -04:00
|
|
|
Layout/SpaceInsideBlockBraces:
|
2016-08-16 03:30:11 -04:00
|
|
|
Enabled: true
|
|
|
|
|
|
|
|
# Use `{ a: 1 }` not `{a:1}`.
|
2017-05-24 14:33:50 -04:00
|
|
|
Layout/SpaceInsideHashLiteralBraces:
|
2016-08-16 03:30:11 -04:00
|
|
|
Enabled: true
|
|
|
|
|
2017-05-24 14:33:50 -04:00
|
|
|
Layout/SpaceInsideParens:
|
2016-10-28 23:05:58 -04:00
|
|
|
Enabled: true
|
|
|
|
|
2016-08-06 11:45:37 -04:00
|
|
|
# Check quotes usage according to lint rule below.
|
|
|
|
Style/StringLiterals:
|
|
|
|
Enabled: true
|
|
|
|
EnforcedStyle: double_quotes
|
|
|
|
|
|
|
|
# Detect hard tabs, no hard tabs.
|
2017-05-24 14:33:50 -04:00
|
|
|
Layout/Tab:
|
2016-08-06 11:45:37 -04:00
|
|
|
Enabled: true
|
|
|
|
|
|
|
|
# Blank lines should not have any spaces.
|
2017-05-24 14:33:50 -04:00
|
|
|
Layout/TrailingBlankLines:
|
2016-08-06 11:45:37 -04:00
|
|
|
Enabled: true
|
|
|
|
|
|
|
|
# No trailing whitespace.
|
2017-05-24 14:33:50 -04:00
|
|
|
Layout/TrailingWhitespace:
|
2016-08-06 11:45:37 -04:00
|
|
|
Enabled: true
|
|
|
|
|
|
|
|
# Use quotes for string literals when they are enough.
|
|
|
|
Style/UnneededPercentQ:
|
2016-07-19 23:35:11 -04:00
|
|
|
Enabled: true
|
|
|
|
|
2016-07-21 07:49:13 -04:00
|
|
|
# Align `end` with the matching keyword or starting expression except for
|
|
|
|
# assignments, where it should be aligned with the LHS.
|
2016-07-19 23:35:11 -04:00
|
|
|
Lint/EndAlignment:
|
2016-08-06 11:45:37 -04:00
|
|
|
Enabled: true
|
2017-01-16 01:36:57 -05:00
|
|
|
EnforcedStyleAlignWith: variable
|
2018-01-17 22:09:16 -05:00
|
|
|
AutoCorrect: true
|
2016-08-06 11:45:37 -04:00
|
|
|
|
|
|
|
# Use my_method(my_arg) not my_method( my_arg ) or my_method my_arg.
|
|
|
|
Lint/RequireParentheses:
|
|
|
|
Enabled: true
|
2017-10-28 08:15:34 -04:00
|
|
|
|
2017-10-31 18:32:04 -04:00
|
|
|
Style/RedundantReturn:
|
|
|
|
Enabled: true
|
|
|
|
AllowMultipleReturnValues: true
|
|
|
|
|
2017-10-28 08:15:34 -04:00
|
|
|
Style/Semicolon:
|
|
|
|
Enabled: true
|
|
|
|
AllowAsExpressionSeparator: true
|
2018-02-22 01:26:48 -05:00
|
|
|
|
|
|
|
# Prefer Foo.method over Foo::method
|
|
|
|
Style/ColonMethodCall:
|
|
|
|
Enabled: true
|