Updated channel and documentation to Rubocop v1.8.1 (#269)

Bumps the 'rubocop' dependency to v1.8.1, updates the scraped documentation, and fixes the config-upgrader spec by adding the new cops to the config-upgrader fixture.

Author: DanielWright

Gemfile

@@ -6,7 +6,7 @@ gem "activesupport", require: false
 gem "mry", require: false
 gem "parser"
 gem "pry", require: false
-gem "rubocop", "1.7.0", require: false
+gem "rubocop", "1.8.1", require: false
 gem "rubocop-i18n", require: false
 gem "rubocop-minitest", require: false
 gem "rubocop-performance", require: false

Gemfile.lock

@@ -41,15 +41,15 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.9.0)
     rspec-support (3.9.3)
-    rubocop (1.7.0)
+    rubocop (1.8.1)
       parallel (~> 1.10)
-      parser (>= 2.7.1.5)
+      parser (>= 3.0.0.0)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml
       rubocop-ast (>= 1.2.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 2.0)
+      unicode-display_width (>= 1.4.0, < 3.0)
     rubocop-ast (1.4.0)
       parser (>= 2.7.1.5)
     rubocop-i18n (3.0.0)
@@ -78,7 +78,7 @@ GEM
     thread_safe (0.3.6)
     tzinfo (1.2.7)
       thread_safe (~> 0.1)
-    unicode-display_width (1.7.0)
+    unicode-display_width (2.0.0)
     zeitwerk (2.3.1)
 
 PLATFORMS
@@ -91,7 +91,7 @@ DEPENDENCIES
   pry
   rake
   rspec
-  rubocop (= 1.7.0)
+  rubocop (= 1.8.1)
   rubocop-i18n
   rubocop-minitest
   rubocop-performance

config/contents/layout/multiline_operation_indentation.md

@@ -11,14 +11,14 @@ style.
     if a +
         b
       something &&
-      something_else
+        something_else
     end
 
     # good
     if a +
        b
       something &&
-        something_else
+      something_else
     end
 
 ### Example: EnforcedStyle: indented

config/contents/layout/space_before_brackets.md

@@ -1,10 +1,6 @@
 Checks for space between the name of a receiver and a left
 brackets.
 
-This cop is marked as unsafe because it can occur false positives
-for `do_something [this_is_an_array_literal_argument]` that take
-an array without parentheses as an argument.
-
 ### Example:
 
     # bad

config/contents/lint/deprecated_constants.md

@@ -0,0 +1,26 @@
+This cop checks for deprecated constants.
+
+It has `DeprecatedConstants` config. If there is an alternative method, you can set
+alternative value as `Alternative`. And you can set the deprecated version as
+`DeprecatedVersion`. These options can be omitted if they are not needed.
+
+    DeprecatedConstants:
+      'DEPRECATED_CONSTANT':
+        Alternative: 'alternative_value'
+        DeprecatedVersion: 'deprecated_version'
+
+By default, `NIL`, `TRUE`, `FALSE` and `Random::DEFAULT` are configured.
+
+### Example:
+
+    # bad
+    NIL
+    TRUE
+    FALSE
+    Random::DEFAULT # Return value of Ruby 2 is `Random` instance, Ruby 3.0 is `Random` class.
+
+    # good
+    nil
+    true
+    false
+    Random.new # `::DEFAULT` has been deprecated in Ruby 3, `.new` is compatible with Ruby 2.

config/contents/lint/lambda_without_literal_block.md

@@ -0,0 +1,21 @@
+This cop checks uses of lambda without a literal block.
+It emulates the following warning in Ruby 3.0:
+
+    % ruby -vwe 'lambda(&proc {})'
+    ruby 3.0.0p0 (2020-12-25 revision 95aff21468) [x86_64-darwin19]
+    -e:1: warning: lambda without a literal block is deprecated; use the proc without
+    lambda instead
+
+This way, proc object is never converted to lambda.
+Auto-correction replaces with compatible proc argument.
+
+### Example:
+
+    # bad
+    lambda(&proc { do_something })
+    lambda(&Proc.new { do_something })
+
+    # good
+    proc { do_something }
+    Proc.new { do_something }
+    lambda { do_something } # If you use lambda.

config/contents/lint/non_deterministic_require_order.md

@@ -6,6 +6,11 @@ such as requiring files, can lead to intermittent failures
 that are hard to debug. To ensure this doesn't happen,
 always sort the list.
 
+`Dir.glob` and `Dir[]` sort globbed results by default in Ruby 3.0.
+So all bad cases are acceptable when Ruby 3.0 or higher are used.
+
+This cop will be deprecated and removed when supporting only Ruby 3.0 and higher.
+
 ### Example:
 
     # bad
@@ -18,8 +23,6 @@ always sort the list.
       require file
     end
 
-### Example:
-
     # bad
     Dir.glob(Rails.root.join(__dir__, 'test', '*.rb')) do |file|
       require file
@@ -30,18 +33,17 @@ always sort the list.
       require file
     end
 
-### Example:
-
     # bad
     Dir['./lib/**/*.rb'].each(&method(:require))
 
     # good
     Dir['./lib/**/*.rb'].sort.each(&method(:require))
 
-### Example:
-
     # bad
     Dir.glob(Rails.root.join('test', '*.rb'), &method(:require))
 
     # good
     Dir.glob(Rails.root.join('test', '*.rb')).sort.each(&method(:require))
+
+    # good - Respect intent if `sort` keyword option is specified in Ruby 3.0 or higher.
+    Dir.glob(Rails.root.join(__dir__, 'test', '*.rb'), sort: false).each(&method(:require))

config/contents/lint/redundant_dir_glob_sort.md

@@ -0,0 +1,18 @@
+Sort globbed results by default in Ruby 3.0.
+This cop checks for redundant `sort` method to `Dir.glob` and `Dir[]`.
+
+### Example:
+
+    # bad
+    Dir.glob('./lib/**/*.rb').sort.each do |file|
+    end
+
+    Dir['./lib/**/*.rb'].sort.each do |file|
+    end
+
+    # good
+    Dir.glob('./lib/**/*.rb').each do |file|
+    end
+
+    Dir['./lib/**/*.rb'].each do |file|
+    end

config/contents/style/endless_method.md

@@ -0,0 +1,41 @@
+This cop checks for endless methods.
+
+It can enforce either the use of endless methods definitions
+for single-lined method bodies, or disallow endless methods.
+
+Other method definition types are not considered by this cop.
+
+The supported styles are:
+* allow_single_line (default) - only single line endless method definitions are allowed.
+* allow_always - all endless method definitions are allowed.
+* disallow - all endless method definitions are disallowed.
+
+NOTE: Incorrect endless method definitions will always be
+corrected to a multi-line definition.
+
+### Example: EnforcedStyle: allow_single_line (default)
+    # good
+    def my_method() = x
+
+    # bad, multi-line endless method
+    def my_method() = x.foo
+                       .bar
+                       .baz
+
+### Example: EnforcedStyle: allow_always
+    # good
+    def my_method() = x
+
+    # good
+    def my_method() = x.foo
+                       .bar
+                       .baz
+
+### Example: EnforcedStyle: disallow
+    # bad
+    def my_method; x end
+
+    # bad
+    def my_method() = x.foo
+                       .bar
+                       .baz

config/contents/style/explicit_block_argument.md

@@ -1,6 +1,9 @@
 This cop enforces the use of explicit block argument to avoid writing
 block literal that just passes its arguments to another block.
 
+NOTE: This cop only registers an offense if the block args match the
+yield args exactly.
+
 ### Example:
     # bad
     def with_tmp_dir