linter: Allow each LintRule multiple categories

Spelled out at https://github.com/dart-lang/linter/issues/1020

Fixes https://github.com/dart-lang/linter/issues/1020

This CL does not change the categories/groups that any rule has. We
can add/change categories in later CLs.

Cq-Include-Trybots: luci.dart.try:flutter-analyze-try,analyzer-win-release-try,pkg-win-release-try
Change-Id: Ief2856a6c472492bbad19fc95df172ef8d19fe7b
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/369861
Reviewed-by: Brian Wilkerson <[email protected]>
Reviewed-by: Phil Quitslund <[email protected]>
Commit-Queue: Sam Rawlins <[email protected]>

Author: srawlins

pkg/analysis_server/test/lsp/code_actions_fixes_test.dart

@@ -27,7 +27,7 @@ class DeprecatedCamelCaseTypes extends LintRule {
   DeprecatedCamelCaseTypes()
       : super(
           name: 'camel_case_types',
-          group: Group.style,
+          categories: {Category.style},
           state: State.deprecated(),
           description: '',
           details: '',

pkg/analysis_server/test/src/services/completion/yaml/analysis_options_generator_test.dart

@@ -259,7 +259,7 @@ class InternalLint extends LintRule {
   InternalLint()
       : super(
           name: 'internal_lint',
-          group: Group.style,
+          categories: {Category.style},
           state: State.internal(),
           description: '',
           details: '',

pkg/analysis_server/test/src/services/correction/fix/analysis_options/remove_lint_test.dart

@@ -21,7 +21,7 @@ class DeprecatedRule extends LintRule {
           name: 'deprecated_rule',
           description: '',
           details: '...',
-          group: Group.errors,
+          categories: {Category.errors},
           state: State.deprecated(since: dart2_12),
         );
 }
@@ -32,7 +32,7 @@ class RemovedRule extends LintRule {
             name: 'removed_rule',
             description: '',
             details: '...',
-            group: Group.errors,
+            categories: {Category.errors},
             state: State.removed());
 }
 

pkg/analyzer/lib/src/lint/linter.dart

@@ -35,31 +35,18 @@ export 'package:analyzer/src/lint/linter_visitor.dart' show NodeLintRegistry;
 export 'package:analyzer/src/lint/state.dart'
     show dart2_12, dart3, dart3_3, State;
 
-abstract class Group {
-  /// A group representing possible coding errors.
+final class Category {
+  /// A category representing possible coding errors.
   static const String errors = 'errors';
 
-  /// A group representing Pub-related rules.
+  /// A category representing Pub-related rules.
   static const String pub = 'pub';
 
-  /// A group representing matters of style, largely derived from Effective
+  /// A category representing matters of style, largely derived from Effective
   /// Dart.
   static const String style = 'style';
 }
 
-@visibleForTesting
-class Hyperlink {
-  final String _label;
-  final String _href;
-  final bool _bold;
-
-  const Hyperlink(this._label, this._href, {bool bold = false}) : _bold = bold;
-
-  String get html => '<a href="$_href">${_emph(_label)}</a>';
-
-  String _emph(String msg) => _bold ? '<strong>$msg</strong>' : msg;
-}
-
 /// The result of attempting to evaluate an expression.
 class LinterConstantEvaluationResult {
   /// The value of the expression, or `null` if has [errors].
@@ -213,8 +200,8 @@ abstract class LintRule {
   /// Short description suitable for display in console output.
   final String description;
 
-  /// Lint group (for example, 'style').
-  final String group;
+  /// Lint groups (for example, 'style', 'errors', 'pub').
+  final Set<String> categories;
 
   /// Lint name.
   final String name;
@@ -233,7 +220,7 @@ abstract class LintRule {
 
   LintRule({
     required this.name,
-    required this.group,
+    required this.categories,
     required this.description,
     required this.details,
     State? state,

pkg/analyzer/test/src/diagnostics/removed_lint_use_test.dart

@@ -19,7 +19,7 @@ class RemovedLint extends LintRule {
   RemovedLint()
       : super(
           name: 'removed_lint',
-          group: Group.style,
+          categories: {Category.style},
           state: State.removed(since: dart3),
           description: '',
           details: '',

pkg/analyzer/test/src/diagnostics/replaced_lint_use_test.dart

@@ -19,7 +19,7 @@ class RemovedLint extends LintRule {
   RemovedLint()
       : super(
           name: 'removed_lint',
-          group: Group.style,
+          categories: {Category.style},
           state: State.removed(since: dart3, replacedBy: 'replacing_lint'),
           description: '',
           details: '',
@@ -65,7 +65,7 @@ class ReplacingLint extends LintRule {
   ReplacingLint()
       : super(
           name: 'replacing_lint',
-          group: Group.style,
+          categories: {Category.style},
           state: State.removed(since: dart3),
           description: '',
           details: '',

pkg/analyzer/test/src/diagnostics/unignorable_ignore_test.dart

@@ -77,7 +77,7 @@ class _AvoidIntRule extends LintRule {
           name: 'avoid_int',
           description: '',
           details: '',
-          group: Group.errors,
+          categories: {Category.errors},
         );
 
   @override

pkg/analyzer/test/src/lint/lint_rule_test.dart

@@ -139,7 +139,7 @@ class TestRule extends LintRule {
           name: 'test_rule',
           description: '',
           details: '... tl;dr ...',
-          group: Group.errors,
+          categories: {Category.errors},
         );
 }
 

pkg/analyzer/test/src/options/apply_options_test.dart

@@ -375,14 +375,14 @@ class TestRule extends LintRule {
           name: 'fantastic_test_rule',
           description: '',
           details: '',
-          group: Group.style,
+          categories: {Category.style},
         );
 
   TestRule.withName(String name)
       : super(
           name: name,
           description: '',
           details: '',
-          group: Group.style,
+          categories: {Category.style},
         );
 }

pkg/analyzer/test/src/options/options_rule_validator_test.dart

@@ -27,7 +27,7 @@ class DeprecatedLint extends LintRule {
   DeprecatedLint()
       : super(
           name: 'deprecated_lint',
-          group: Group.style,
+          categories: {Category.style},
           state: State.deprecated(),
           description: '',
           details: '',
@@ -38,7 +38,7 @@ class DeprecatedLintWithReplacement extends LintRule {
   DeprecatedLintWithReplacement()
       : super(
           name: 'deprecated_lint_with_replacement',
-          group: Group.style,
+          categories: {Category.style},
           state: State.deprecated(replacedBy: 'replacing_lint'),
           description: '',
           details: '',
@@ -49,7 +49,7 @@ class DeprecatedSince3Lint extends LintRule {
   DeprecatedSince3Lint()
       : super(
           name: 'deprecated_since_3_lint',
-          group: Group.style,
+          categories: {Category.style},
           state: State.deprecated(since: dart3),
           description: '',
           details: '',
@@ -293,7 +293,7 @@ class RemovedIn2_12Lint extends LintRule {
   RemovedIn2_12Lint()
       : super(
           name: 'removed_in_2_12_lint',
-          group: Group.style,
+          categories: {Category.style},
           state: State.removed(since: dart2_12),
           description: '',
           details: '',
@@ -304,7 +304,7 @@ class ReplacedLint extends LintRule {
   ReplacedLint()
       : super(
           name: 'replaced_lint',
-          group: Group.style,
+          categories: {Category.style},
           state: State.removed(since: dart3, replacedBy: 'replacing_lint'),
           description: '',
           details: '',
@@ -315,7 +315,7 @@ class ReplacingLint extends LintRule {
   ReplacingLint()
       : super(
           name: 'replacing_lint',
-          group: Group.style,
+          categories: {Category.style},
           description: '',
           details: '',
         );
@@ -325,7 +325,7 @@ class RuleNeg extends LintRule {
   RuleNeg()
       : super(
           name: 'rule_neg',
-          group: Group.style,
+          categories: {Category.style},
           description: '',
           details: '',
         );
@@ -338,7 +338,7 @@ class RulePos extends LintRule {
   RulePos()
       : super(
           name: 'rule_pos',
-          group: Group.style,
+          categories: {Category.style},
           description: '',
           details: '',
         );
@@ -351,7 +351,7 @@ class StableLint extends LintRule {
   StableLint()
       : super(
           name: 'stable_lint',
-          group: Group.style,
+          categories: {Category.style},
           state: State.stable(),
           description: '',
           details: '',