Cut 1.32

.github/ISSUE_TEMPLATE/bug_report.md

@@ -38,7 +38,7 @@ output by `rubocop -V`, include them as well. Here's an example:
 
 ```
 $ [bundle exec] rubocop -V
-1.31.2 (using Parser 2.7.2.0, rubocop-ast 1.1.1, running on ruby 2.7.2 x86_64-linux)
+1.32.0 (using Parser 2.7.2.0, rubocop-ast 1.1.1, running on ruby 2.7.2 x86_64-linux)
   - rubocop-performance 1.9.1
   - rubocop-rspec 2.0.0
 ```

CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ## master (unreleased)
 
+## 1.32.0 (2022-07-21)
+
 ### New features
 
 * [#10820](https://github.com/rubocop/rubocop/pull/10820): Add new `Style/EmptyHeredoc` cop. ([@koic][])

CONTRIBUTING.md

@@ -17,7 +17,7 @@ do so.
 
 ```console
 $ rubocop -V
-1.31.2 (using Parser 2.7.2.0, rubocop-ast 1.1.1, running on ruby 2.7.2 x86_64-linux)
+1.32.0 (using Parser 2.7.2.0, rubocop-ast 1.1.1, running on ruby 2.7.2 x86_64-linux)
   - rubocop-performance 1.9.1
   - rubocop-rspec 2.0.0
 ```

README.md

@@ -53,7 +53,7 @@ To prevent an unwanted RuboCop update you might want to use a conservative versi
 in your `Gemfile`:
 
 ```rb
-gem 'rubocop', '~> 1.31', require: false
+gem 'rubocop', '~> 1.32', require: false
 ```
 
 See [our versioning policy](https://docs.rubocop.org/rubocop/versioning.html) for further details.

config/default.yml

@@ -977,7 +977,7 @@ Layout/LineContinuationLeadingSpace:
   AutoCorrect: false
   SafeAutoCorrect: false
   VersionAdded: '1.31'
-  VersionChanged: '<<next>>'
+  VersionChanged: '1.32'
   EnforcedStyle: trailing
   SupportedStyles:
     - leading
@@ -1163,7 +1163,7 @@ Layout/MultilineMethodParameterLineBreaks:
                  Checks that each parameter in a multi-line method definition
                  starts on a separate line.
   Enabled: false
-  VersionAdded: '<<next>>'
+  VersionAdded: '1.32'
 
 Layout/MultilineOperationIndentation:
   Description: >-
@@ -2143,7 +2143,7 @@ Lint/RequireParentheses:
 Lint/RequireRangeParentheses:
   Description: 'Checks that a range literal is enclosed in parentheses when the end of the range is at a line break.'
   Enabled: pending
-  VersionAdded: '<<next>>'
+  VersionAdded: '1.32'
 
 Lint/RequireRelativeSelfPath:
   Description: 'Checks for uses a file requiring itself with `require_relative`.'
@@ -3517,7 +3517,7 @@ Style/EmptyElse:
 Style/EmptyHeredoc:
   Description: 'Checks for using empty heredoc to reduce redundancy.'
   Enabled: pending
-  VersionAdded: '<<next>>'
+  VersionAdded: '1.32'
 
 Style/EmptyLambdaParameter:
   Description: 'Omit parens for empty lambda parameters.'

docs/antora.yml

@@ -2,6 +2,6 @@ name: rubocop
 title: RuboCop
 # We always provide version without patch here (e.g. 1.1),
 # as patch versions should not appear in the docs.
-version: ~
+version: '1.32'
 nav:
   - modules/ROOT/nav.adoc

docs/modules/ROOT/pages/cops.adoc

@@ -157,6 +157,7 @@ In the following section you find all available cops:
 * xref:cops_layout.adoc#layoutmultilinemethodcallbracelayout[Layout/MultilineMethodCallBraceLayout]
 * xref:cops_layout.adoc#layoutmultilinemethodcallindentation[Layout/MultilineMethodCallIndentation]
 * xref:cops_layout.adoc#layoutmultilinemethoddefinitionbracelayout[Layout/MultilineMethodDefinitionBraceLayout]
+* xref:cops_layout.adoc#layoutmultilinemethodparameterlinebreaks[Layout/MultilineMethodParameterLineBreaks]
 * xref:cops_layout.adoc#layoutmultilineoperationindentation[Layout/MultilineOperationIndentation]
 * xref:cops_layout.adoc#layoutparameteralignment[Layout/ParameterAlignment]
 * xref:cops_layout.adoc#layoutredundantlinebreak[Layout/RedundantLineBreak]
@@ -282,6 +283,7 @@ In the following section you find all available cops:
 * xref:cops_lint.adoc#lintrefinementimportmethods[Lint/RefinementImportMethods]
 * xref:cops_lint.adoc#lintregexpascondition[Lint/RegexpAsCondition]
 * xref:cops_lint.adoc#lintrequireparentheses[Lint/RequireParentheses]
+* xref:cops_lint.adoc#lintrequirerangeparentheses[Lint/RequireRangeParentheses]
 * xref:cops_lint.adoc#lintrequirerelativeselfpath[Lint/RequireRelativeSelfPath]
 * xref:cops_lint.adoc#lintrescueexception[Lint/RescueException]
 * xref:cops_lint.adoc#lintrescuetype[Lint/RescueType]
@@ -421,6 +423,7 @@ In the following section you find all available cops:
 * xref:cops_style.adoc#styleemptyblockparameter[Style/EmptyBlockParameter]
 * xref:cops_style.adoc#styleemptycasecondition[Style/EmptyCaseCondition]
 * xref:cops_style.adoc#styleemptyelse[Style/EmptyElse]
+* xref:cops_style.adoc#styleemptyheredoc[Style/EmptyHeredoc]
 * xref:cops_style.adoc#styleemptylambdaparameter[Style/EmptyLambdaParameter]
 * xref:cops_style.adoc#styleemptyliteral[Style/EmptyLiteral]
 * xref:cops_style.adoc#styleemptymethod[Style/EmptyMethod]

docs/modules/ROOT/pages/cops_layout.adoc

@@ -4017,14 +4017,17 @@ end
 | Yes
 | No
 | 1.31
-| -
+| 1.32
 |===
 
 Checks that strings broken over multiple lines (by a backslash) contain
-trailing spaces instead of leading spaces.
+trailing spaces instead of leading spaces (default) or leading spaces
+instead of trailing spaces.
 
 === Examples
 
+==== EnforcedStyle: trailing (default)
+
 [source,ruby]
 ----
 # bad
@@ -4044,6 +4047,27 @@ trailing spaces instead of leading spaces.
 'long'
 ----
 
+==== EnforcedStyle: leading
+
+[source,ruby]
+----
+# bad
+'this text contains a lot of               ' \
+'spaces'
+
+# good
+'this text contains a lot of' \
+'               spaces'
+
+# bad
+'this text is too ' \
+'long'
+
+# good
+'this text is too' \
+' long'
+----
+
 === Configurable attributes
 
 |===
@@ -4052,6 +4076,10 @@ trailing spaces instead of leading spaces.
 | AutoCorrect
 | `false`
 | Boolean
+
+| EnforcedStyle
+| `trailing`
+| `leading`, `trailing`
 |===
 
 == Layout/LineContinuationSpacing
@@ -4265,6 +4293,7 @@ are recommended to further format the broken lines.
 * MultilineHashBraceLayout
 * MultilineHashKeyLineBreaks
 * MultilineMethodArgumentLineBreaks
+* MultilineMethodParameterLineBreaks
 * ParameterAlignment
 
 Together, these cops will pretty print hashes, arrays,
@@ -4812,7 +4841,7 @@ starts on a separate line.
 Ensures that each argument in a multi-line method call
 starts on a separate line.
 
-NOTE: this cop does not move the first argument, if you want that to
+NOTE: This cop does not move the first argument, if you want that to
 be on a separate line, see `Layout/FirstMethodArgumentLineBreak`.
 
 === Examples
@@ -4830,6 +4859,9 @@ foo(
   b,
   c
 )
+
+# good
+foo(a, b, c)
 ----
 
 == Layout/MultilineMethodCallBraceLayout
@@ -5172,6 +5204,47 @@ end
 | `symmetrical`, `new_line`, `same_line`
 |===
 
+== Layout/MultilineMethodParameterLineBreaks
+
+|===
+| Enabled by default | Safe | Supports autocorrection | Version Added | Version Changed
+
+| Disabled
+| Yes
+| Yes
+| 1.32
+| -
+|===
+
+Ensures that each parameter in a multi-line method definition
+starts on a separate line.
+
+NOTE: This cop does not move the first argument, if you want that to
+be on a separate line, see `Layout/FirstMethodParameterLineBreak`.
+
+=== Examples
+
+[source,ruby]
+----
+# bad
+def foo(a, b,
+  c
+)
+end
+
+# good
+def foo(
+  a,
+  b,
+  c
+)
+end
+
+# good
+def foo(a, b, c)
+end
+----
+
 == Layout/MultilineOperationIndentation
 
 |===