| // Copyright (c) 2022, the Dart project authors. Please see the AUTHORS file |
| // for details. All rights reserved. Use of this source code is governed by a |
| // BSD-style license that can be found in the LICENSE file. |
| |
| import 'package:analyzer/dart/ast/ast.dart'; |
| import 'package:analyzer/dart/ast/visitor.dart'; |
| |
| import '../analyzer.dart'; |
| |
| const _name = 'unnecessary_library_directive'; |
| |
| const _desc = |
| 'Avoid library directives unless they have documentation comments or ' |
| 'annotations.'; |
| |
| const _details = r''' |
| **DO** use library directives if you want to document a library and/or annotate |
| a library. |
| |
| **BAD:** |
| ```dart |
| library; |
| ``` |
| |
| **GOOD:** |
| ```dart |
| /// This library does important things |
| library; |
| ``` |
| |
| ```dart |
| @TestOn('js') |
| library; |
| ``` |
| |
| NOTE: Due to limitations with this lint, libraries with parts will not be |
| flagged for unnecessary library directives. |
| '''; |
| |
| class UnnecessaryLibraryDirective extends LintRule { |
| static const LintCode code = LintCode( |
| _name, |
| 'Library directives without comments or annotations should be avoided.', |
| correctionMessage: 'Try deleting the library directive.', |
| ); |
| |
| UnnecessaryLibraryDirective() |
| : super( |
| name: _name, |
| description: _desc, |
| details: _details, |
| group: Group.style, |
| ); |
| |
| @override |
| LintCode get lintCode => code; |
| |
| @override |
| void registerNodeProcessors( |
| NodeLintRegistry registry, |
| LinterContext context, |
| ) { |
| var visitor = _Visitor(this); |
| registry.addLibraryDirective(this, visitor); |
| } |
| } |
| |
| class _Visitor extends SimpleAstVisitor<void> { |
| final LintRule rule; |
| |
| _Visitor(this.rule); |
| |
| @override |
| void visitLibraryDirective(LibraryDirective node) { |
| var parent = node.parent! as CompilationUnit; |
| if (parent.directives.any((element) => element is PartDirective)) { |
| // Parts may still use library names. No be safe, we don't lint those |
| // libraries – even though using library names itself is discouraged. |
| return; |
| } |
| |
| if (node.sortedCommentAndAnnotations.isEmpty) { |
| rule.reportLint(node); |
| } |
| } |
| } |