Update rubocop to 1.62.1 (#365)

- General bundle update.
- Update the docs too.

Author: BrianHawley

Gemfile

@@ -5,7 +5,7 @@ source 'https://rubygems.org'
 gem "activesupport", require: false
 gem "parser"
 gem "pry", require: false
-gem "rubocop", "1.60.2", require: false
+gem "rubocop", "1.62.1", require: false
 gem "rubocop-graphql", require: false
 gem "rubocop-i18n", require: false
 gem "rubocop-minitest", require: false

Gemfile.lock

@@ -1,7 +1,7 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (7.1.3)
+    activesupport (7.1.3.2)
       base64
       bigdecimal
       concurrent-ruby (~> 1.0, >= 1.0.2)
@@ -13,19 +13,18 @@ GEM
       tzinfo (~> 2.0)
     ast (2.4.2)
     base64 (0.2.0)
-    bigdecimal (3.1.6)
+    bigdecimal (3.1.7)
     coderay (1.1.3)
     concurrent-ruby (1.2.3)
     connection_pool (2.4.1)
-    diff-lcs (1.5.0)
-    drb (2.2.0)
-      ruby2_keywords
-    i18n (1.14.1)
+    diff-lcs (1.5.1)
+    drb (2.2.1)
+    i18n (1.14.4)
       concurrent-ruby (~> 1.0)
     json (2.7.1)
     language_server-protocol (3.17.0.3)
     method_source (1.0.0)
-    minitest (5.21.2)
+    minitest (5.22.3)
     mutex_m (0.2.0)
     parallel (1.24.0)
     parser (3.3.0.5)
@@ -35,37 +34,37 @@ GEM
       coderay (~> 1.1)
       method_source (~> 1.0)
     racc (1.7.3)
-    rack (3.0.8)
+    rack (3.0.9.1)
     rainbow (3.1.1)
     rake (13.1.0)
     regexp_parser (2.9.0)
     rexml (3.2.6)
-    rspec (3.12.0)
-      rspec-core (~> 3.12.0)
-      rspec-expectations (~> 3.12.0)
-      rspec-mocks (~> 3.12.0)
-    rspec-core (3.12.2)
-      rspec-support (~> 3.12.0)
-    rspec-expectations (3.12.3)
+    rspec (3.13.0)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.0)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.12.0)
-    rspec-mocks (3.12.6)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.12.0)
-    rspec-support (3.12.1)
-    rubocop (1.60.2)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.1)
+    rubocop (1.62.1)
       json (~> 2.3)
       language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.30.0, < 2.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.30.0)
-      parser (>= 3.2.1.0)
+    rubocop-ast (1.31.2)
+      parser (>= 3.3.0.4)
     rubocop-capybara (2.20.0)
       rubocop (~> 1.41)
     rubocop-factory_bot (2.25.1)
@@ -74,34 +73,33 @@ GEM
       rubocop (>= 0.90, < 2)
     rubocop-i18n (3.0.0)
       rubocop (~> 1.0)
-    rubocop-minitest (0.34.5)
-      rubocop (>= 1.39, < 2.0)
-      rubocop-ast (>= 1.30.0, < 2.0)
+    rubocop-minitest (0.35.0)
+      rubocop (>= 1.61, < 2.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
     rubocop-performance (1.20.2)
       rubocop (>= 1.48.1, < 2.0)
       rubocop-ast (>= 1.30.0, < 2.0)
-    rubocop-rails (2.23.1)
+    rubocop-rails (2.24.0)
       activesupport (>= 4.2.0)
       rack (>= 1.1)
       rubocop (>= 1.33.0, < 2.0)
-      rubocop-ast (>= 1.30.0, < 2.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
     rubocop-rake (0.6.0)
       rubocop (~> 1.0)
-    rubocop-rspec (2.26.1)
+    rubocop-rspec (2.27.1)
       rubocop (~> 1.40)
       rubocop-capybara (~> 2.17)
       rubocop-factory_bot (~> 2.22)
     rubocop-sequel (0.3.4)
       rubocop (~> 1.0)
-    rubocop-shopify (2.14.0)
+    rubocop-shopify (2.15.1)
       rubocop (~> 1.51)
-    rubocop-sorbet (0.7.6)
+    rubocop-sorbet (0.7.8)
       rubocop (>= 0.90.0)
     rubocop-thread_safety (0.5.1)
       rubocop (>= 0.90.0)
     ruby-progressbar (1.13.0)
-    ruby2_keywords (0.0.5)
-    test-prof (1.3.1)
+    test-prof (1.3.2)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     unicode-display_width (2.5.0)
@@ -115,7 +113,7 @@ DEPENDENCIES
   pry
   rake
   rspec
-  rubocop (= 1.60.2)
+  rubocop (= 1.62.1)
   rubocop-graphql
   rubocop-i18n
   rubocop-minitest

config/contents/layout/end_alignment.md

@@ -15,7 +15,9 @@ start of the line where the matching keyword appears.
 This `Layout/EndAlignment` cop aligns with keywords (e.g. `if`, `while`, `case`)
 by default. On the other hand, `Layout/BeginEndAlignment` cop aligns with
 `EnforcedStyleAlignWith: start_of_line` by default due to `||= begin` tends
-to align with the start of the line. These style can be configured by each cop.
+to align with the start of the line. `Layout/DefEndAlignment` cop also aligns with
+`EnforcedStyleAlignWith: start_of_line` by default.
+These style can be configured by each cop.
 
 ### Example: EnforcedStyleAlignWith: keyword (default)
     # bad

config/contents/lint/redundant_safe_navigation.md

@@ -1,6 +1,7 @@
 Checks for redundant safe navigation calls.
 Use cases where a constant, named in camel case for classes and modules is `nil` are rare,
-and an offense is not detected when the receiver is a snake case constant.
+and an offense is not detected when the receiver is a constant. The detection also applies
+to literal receivers, except for `nil`.
 
 For all receivers, the `instance_of?`, `kind_of?`, `is_a?`, `eql?`, `respond_to?`,
 and `equal?` methods are checked by default.

config/contents/style/arguments_forwarding.md

@@ -3,6 +3,12 @@ In Ruby 2.7, arguments forwarding has been added.
 This cop identifies places where `do_something(*args, &block)`
 can be replaced by `do_something(...)`.
 
+In Ruby 3.1, anonymous block forwarding has been added.
+
+This cop identifies places where `do_something(&block)` can be replaced
+by `do_something(&)`; if desired, this functionality can be disabled
+by setting `UseAnonymousForwarding: false`.
+
 In Ruby 3.2, anonymous args/kwargs forwarding has been added.
 
 This cop also identifies places where `use_args(*args)`/`use_kwargs(**kwargs)` can be
@@ -36,22 +42,25 @@ Names not on this list are likely to be meaningful and are allowed by default.
 
 ### Example: UseAnonymousForwarding: true (default, only relevant for Ruby >= 3.2)
     # bad
-    def foo(*args, **kwargs)
+    def foo(*args, **kwargs, &block)
       args_only(*args)
       kwargs_only(**kwargs)
+      block_only(&block)
     end
 
     # good
-    def foo(*, **)
+    def foo(*, **, &)
       args_only(*)
       kwargs_only(**)
+      block_only(&)
     end
 
 ### Example: UseAnonymousForwarding: false (only relevant for Ruby >= 3.2)
     # good
-    def foo(*args, **kwargs)
+    def foo(*args, **kwargs, &block)
       args_only(*args)
       kwargs_only(**kwargs)
+      block_only(&block)
     end
 
 ### Example: AllowOnlyRestArgument: true (default, only relevant for Ruby < 3.2)

config/contents/style/invertible_unless_condition.md

@@ -27,12 +27,14 @@ actually inverse of each other.
     foo unless x != y
     foo unless x >= 10
     foo unless x.even?
+    foo unless odd?
 
     # good
     foo if bar
     foo if x == y
     foo if x < 10
     foo if x.odd?
+    foo if even?
 
     # bad (complex condition)
     foo unless x != y || x.even?

config/contents/style/raise_args.md

@@ -11,6 +11,10 @@ passed multiple arguments.
 The exploded style has an `AllowedCompactTypes` configuration
 option that takes an Array of exception name Strings.
 
+### Safety:
+
+This cop is unsafe because `raise Foo` calls `Foo.exception`, not `Foo.new`.
+
 ### Example: EnforcedStyle: exploded (default)
     # bad
     raise StandardError.new('message')