Update rubocop to 1.25.0 (#310)

- General bundle update.
- Update the docs too.

Author: BrianHawley

Gemfile

@@ -6,7 +6,7 @@ gem "activesupport", require: false
 gem "mry", require: false
 gem "parser"
 gem "pry", require: false
-gem "rubocop", "1.24.1", require: false
+gem "rubocop", "1.25.0", require: false
 gem "rubocop-i18n", require: false
 gem "rubocop-graphql", require: false
 gem "rubocop-minitest", require: false

Gemfile.lock

@@ -1,7 +1,7 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (7.0.0)
+    activesupport (7.0.1)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 1.6, < 2)
       minitest (>= 5.1)
@@ -23,7 +23,7 @@ GEM
       coderay (~> 1.1)
       method_source (~> 1.0)
     rack (2.2.3)
-    rainbow (3.0.0)
+    rainbow (3.1.1)
     rake (13.0.6)
     regexp_parser (2.2.0)
     rexml (3.2.5)
@@ -33,16 +33,16 @@ GEM
       rspec-mocks (~> 3.10.0)
     rspec-core (3.10.1)
       rspec-support (~> 3.10.0)
-    rspec-expectations (3.10.1)
+    rspec-expectations (3.10.2)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.10.0)
     rspec-mocks (3.10.2)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.10.0)
     rspec-support (3.10.3)
-    rubocop (1.24.1)
+    rubocop (1.25.0)
       parallel (~> 1.10)
-      parser (>= 3.0.0.0)
+      parser (>= 3.1.0.0)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml
@@ -51,16 +51,16 @@ GEM
       unicode-display_width (>= 1.4.0, < 3.0)
     rubocop-ast (1.15.1)
       parser (>= 3.0.1.1)
-    rubocop-graphql (0.12.0)
+    rubocop-graphql (0.12.3)
       rubocop (>= 0.87, < 2)
     rubocop-i18n (3.0.0)
       rubocop (~> 1.0)
     rubocop-minitest (0.17.0)
       rubocop (>= 0.90, < 2.0)
-    rubocop-performance (1.13.1)
+    rubocop-performance (1.13.2)
       rubocop (>= 1.7.0, < 2.0)
       rubocop-ast (>= 0.4.0)
-    rubocop-rails (2.13.0)
+    rubocop-rails (2.13.2)
       activesupport (>= 4.2.0)
       rack (>= 1.1)
       rubocop (>= 1.7.0, < 2.0)
@@ -70,8 +70,8 @@ GEM
       rubocop (~> 1.19)
     rubocop-sequel (0.3.3)
       rubocop (~> 1.0)
-    rubocop-shopify (2.3.0)
-      rubocop (~> 1.22)
+    rubocop-shopify (2.4.0)
+      rubocop (~> 1.24)
     rubocop-sorbet (0.6.5)
       rubocop (>= 0.90.0)
     rubocop-thread_safety (0.4.4)
@@ -93,7 +93,7 @@ DEPENDENCIES
   pry
   rake
   rspec
-  rubocop (= 1.24.1)
+  rubocop (= 1.25.0)
   rubocop-graphql
   rubocop-i18n
   rubocop-minitest

config/contents/naming/block_forwarding.md

@@ -4,6 +4,9 @@ This cop identifies places where `do_something(&block)` can be replaced
 by `do_something(&)`.
 
 It also supports the opposite style by alternative `explicit` option.
+You can specify the block variable name for auto-correction with `BlockForwardingName`.
+The default variable name is `block`. If the name is already in use, it will not be
+auto-corrected.
 
 ### Example: EnforcedStyle: anonymous (default)
 

config/contents/style/hash_syntax.md

@@ -18,6 +18,12 @@ This cop has `EnforcedShorthandSyntax` option.
 It can enforce either the use of the explicit hash value syntax or
 the use of Ruby 3.1's hash value shorthand syntax.
 
+The supported styles are:
+
+* always - forces use of the 3.1 syntax (e.g. {foo:})
+* never - forces use of explicit hash literal value
+* either - accepts both shorthand and explicit use of hash literal value
+
 ### Example: EnforcedStyle: ruby19 (default)
     # bad
     {:a => 2}
@@ -69,3 +75,11 @@ the use of Ruby 3.1's hash value shorthand syntax.
 
     # good
     {foo: foo, bar: bar}
+
+### Example: EnforcedShorthandSyntax: either
+
+    # good
+    {foo: foo, bar: bar}
+
+    # good
+    {foo:, bar:}

config/contents/style/if_with_boolean_literal_branches.md

@@ -32,6 +32,6 @@ will return a boolean value. Those methods can be allowed with `AllowedMethods`
     # good (but potentially an unsafe correction)
     foo.do_something?
 
-### Example: AllowedMethods: ['nonzero?']
+### Example: AllowedMethods: ['nonzero?'] (default)
     # good
     num.nonzero? ? true : false

config/contents/style/method_call_with_args_parentheses.md

@@ -42,7 +42,7 @@ endless method definition introduced in Ruby 3.0. Parentheses are also
 allowed when forwarding arguments with the triple-dot syntax introduced
 in Ruby 2.7 as omitting them starts an endless range.
 And Ruby 3.1's hash omission syntax has a case that requires parentheses
-because the issue https://bugs.ruby-lang.org/issues/18396.
+because of the following issue: https://bugs.ruby-lang.org/issues/18396.
 
 ### Example: EnforcedStyle: require_parentheses (default)