[Fix #260] Fix target of Rails/ContentTag

Tweak for review comments

Add a changelog entry

Modify VersionChanged instead of VersionAdded

Co-authored-by: Koichi ITO <[email protected]>

Fix CHANGELOG.md

Co-authored-by: Koichi ITO <[email protected]>

Generate doc

Author: tabuchik

CHANGELOG.md

@@ -8,6 +8,10 @@
 * [#520](https://github.com/rubocop/rubocop-rails/pull/520): Support auto-correction for `Rails/ScopeArgs`. ([@koic][])
 * [#524](https://github.com/rubocop/rubocop-rails/pull/524): Add new `Rails/RedundantTravelBack` cop. ([@koic][])
 
+## Changes
+
+* [#260](https://github.com/rubocop/rubocop-rails/issues/260): Change target of `Rails/ContentTag` from `content_tag` method to `tag` method. ([@tabuchi0919][])
+
 ## 2.11.3 (2021-07-11)
 
 ### Bug fixes

config/default.yml

@@ -181,12 +181,14 @@ Rails/BulkChangeTable:
     - db/migrate/*.rb
 
 Rails/ContentTag:
-  Description: 'Use `tag` instead of `content_tag`.'
+  Description: 'Use `tag.something` instead of `tag(:something)`.'
   Reference:
+    - 'https://github.com/rubocop/rubocop-rails/issues/260'
     - 'https://github.com/rails/rails/issues/25195'
     - 'https://api.rubyonrails.org/classes/ActionView/Helpers/TagHelper.html#method-i-content_tag'
   Enabled: true
   VersionAdded: '2.6'
+  VersionChanged: '2.12'
 
 Rails/CreateTableWithTimestamps:
   Description: >-

docs/modules/ROOT/pages/cops_rails.adoc

@@ -822,31 +822,32 @@ end
 | Yes
 | Yes
 | 2.6
-| -
+| 2.12
 |===
 
-This cop checks that `tag` is used instead of `content_tag`
-because `content_tag` is legacy syntax.
+This cop checks legacy syntax usage of `tag`
 
-NOTE: Allow `content_tag` when the first argument is a variable because
-     `content_tag(name)` is simpler rather than `tag.public_send(name)`.
+NOTE: Allow `tag` when the first argument is a variable because
+      `tag(name)` is simpler rather than `tag.public_send(name)`.
+      And this cop will be renamed to something like `LegacyTag` in the future. (e.g. RuboCop Rails 2.0)
 
 === Examples
 
 [source,ruby]
 ----
 # bad
-content_tag(:p, 'Hello world!')
-content_tag(:br)
+tag(:p)
+tag(:br, class: 'classname')
 
 # good
-tag.p('Hello world!')
-tag.br
-content_tag(name, 'Hello world!')
+tag.p
+tag.br(class: 'classname')
+tag(name, class: 'classname')
 ----
 
 === References
 
+* https://github.com/rubocop/rubocop-rails/issues/260
 * https://github.com/rails/rails/issues/25195
 * https://api.rubyonrails.org/classes/ActionView/Helpers/TagHelper.html#method-i-content_tag
 

lib/rubocop/cop/rails/content_tag.rb

@@ -3,30 +3,30 @@
 module RuboCop
   module Cop
     module Rails
-      # This cop checks that `tag` is used instead of `content_tag`
-      # because `content_tag` is legacy syntax.
+      # This cop checks legacy syntax usage of `tag`
       #
-      # NOTE: Allow `content_tag` when the first argument is a variable because
-      #      `content_tag(name)` is simpler rather than `tag.public_send(name)`.
+      # NOTE: Allow `tag` when the first argument is a variable because
+      #       `tag(name)` is simpler rather than `tag.public_send(name)`.
+      #       And this cop will be renamed to something like `LegacyTag` in the future. (e.g. RuboCop Rails 2.0)
       #
       # @example
       #  # bad
-      #  content_tag(:p, 'Hello world!')
-      #  content_tag(:br)
+      #  tag(:p)
+      #  tag(:br, class: 'classname')
       #
       #  # good
-      #  tag.p('Hello world!')
-      #  tag.br
-      #  content_tag(name, 'Hello world!')
+      #  tag.p
+      #  tag.br(class: 'classname')
+      #  tag(name, class: 'classname')
       class ContentTag < Base
         include RangeHelp
         extend AutoCorrector
         extend TargetRailsVersion
 
         minimum_target_rails_version 5.1
 
-        MSG = 'Use `tag` instead of `content_tag`.'
-        RESTRICT_ON_SEND = %i[content_tag].freeze
+        MSG = 'Use `tag.something` instead of `tag(:something)`.'
+        RESTRICT_ON_SEND = %i[tag].freeze
 
         def on_new_investigation
           @corrected_nodes = nil
@@ -53,26 +53,26 @@ def corrected_ancestor?(node)
         end
 
         def allowed_argument?(argument)
-          argument.variable? || argument.send_type? || argument.const_type? || argument.splat_type?
+          argument.variable? ||
+            argument.send_type? ||
+            argument.const_type? ||
+            argument.splat_type? ||
+            allowed_name?(argument)
         end
 
         def autocorrect(corrector, node)
-          if method_name?(node.first_argument)
-            range = correction_range(node)
+          range = correction_range(node)
 
-            rest_args = node.arguments.drop(1)
-            replacement = "tag.#{node.first_argument.value.to_s.underscore}(#{rest_args.map(&:source).join(', ')})"
+          rest_args = node.arguments.drop(1)
+          replacement = "tag.#{node.first_argument.value.to_s.underscore}(#{rest_args.map(&:source).join(', ')})"
 
-            corrector.replace(range, replacement)
-          else
-            corrector.replace(node.loc.selector, 'tag')
-          end
+          corrector.replace(range, replacement)
         end
 
-        def method_name?(node)
-          return false unless node.str_type? || node.sym_type?
+        def allowed_name?(argument)
+          return false unless argument.str_type? || argument.sym_type?
 
-          /^[a-zA-Z_][a-zA-Z_\-0-9]*$/.match?(node.value)
+          !/^[a-zA-Z\-][a-zA-Z\-0-9]*$/.match?(argument.value)
         end
 
         def correction_range(node)