pkg/linter/lib/src/rules/package_api_docs.dart

// Copyright (c) 2015, 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';
import '../linter_lint_codes.dart';

const _desc = r'Provide doc comments for all public APIs.';

class PackageApiDocs extends LintRule {
  PackageApiDocs()
      : super(
          name: LintNames.package_api_docs,
          description: _desc,
        );

  @override
  LintCode get lintCode => LinterLintCode.package_api_docs;

  @override
  void registerNodeProcessors(
      NodeLintRegistry registry, LinterContext context) {
    var visitor = _Visitor(this);
    registry.addConstructorDeclaration(this, visitor);
    registry.addFieldDeclaration(this, visitor);
    registry.addMethodDeclaration(this, visitor);
    registry.addClassDeclaration(this, visitor);
    registry.addEnumDeclaration(this, visitor);
    registry.addFunctionDeclaration(this, visitor);
    registry.addTopLevelVariableDeclaration(this, visitor);
    registry.addClassTypeAlias(this, visitor);
    registry.addFunctionTypeAlias(this, visitor);
  }
}

class _Visitor extends GeneralizingAstVisitor<void> {
  final PackageApiDocs rule;

  _Visitor(this.rule);

  // ignore: prefer_expression_function_bodies
  void check(Declaration node) {
    // See: https://github.com/dart-lang/linter/issues/3395
    // (`DartProject` removal).
    return;

    // // If no project info is set, bail early.
    // // https://github.com/dart-lang/linter/issues/154
    // var currentProject = rule.project;
    // if (currentProject == null) {
    //   return;
    // }
    //
    // var declaredElement = node.declaredElement;
    // if (declaredElement != null && currentProject.isApi(declaredElement)) {
    //   if (node.documentationComment == null) {
    //     rule.reportLint(getNodeToAnnotate(node));
    //   }
    // }
  }

  ///  classMember ::=
  ///    [ConstructorDeclaration]
  ///  | [FieldDeclaration]
  ///  | [MethodDeclaration]
  @override
  void visitClassMember(ClassMember node) {
    check(node);
  }

  ///  compilationUnitMember ::=
  ///    [ClassDeclaration]
  ///  | [EnumDeclaration]
  ///  | [FunctionDeclaration]
  ///  | [TopLevelVariableDeclaration]
  ///  | [ClassTypeAlias]
  ///  | [FunctionTypeAlias]
  @override
  void visitCompilationUnitMember(CompilationUnitMember node) {
    check(node);
  }

  @override
  void visitNode(AstNode node) {
    // Don't visit children
  }
}