dart-sdk/pkg/linter
pq 07c77f59a2 Final todo updated format fixes
This should tidy up the last ones. 🤞

Sorry for the noise!

Change-Id: I7104fc33282184acb0c843eae6e73f6fcc77d892
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/336723
Commit-Queue: Phil Quitslund <pquitslund@google.com>
Reviewed-by: Konstantin Shcheglov <scheglov@google.com>
2023-11-16 20:18:32 +00:00
..
doc clean up references to dart test 2023-09-27 21:54:09 +00:00
example Create lint PR 3578 as Gerrit CL 2023-10-12 10:09:10 +00:00
lib/src Final todo updated format fixes 2023-11-16 20:18:32 +00:00
test migration to driver.getAnalysisOptionsForFile (continued) 2023-11-14 22:41:28 +00:00
test_data linter: Remove two deprecated linter rules 2023-11-09 17:03:15 +00:00
tool Final todo updated format fixes 2023-11-16 20:18:32 +00:00
analysis_options.yaml [pkg] remove duplicate config from the analysis options files 2023-11-14 00:37:53 +00:00
AUTHORS
CHANGELOG.md [linter] Add changelog entries for removed unrelated type lints 2023-11-10 19:06:42 +00:00
CONTRIBUTING.md README and contributing process updates 2023-08-23 22:09:24 +00:00
LICENSE
OWNERS Add analyzer team as owners of pkg/linter 2023-08-23 20:05:49 +00:00
pubspec.yaml Reland: Improve file structure of linter files. 2023-11-10 21:25:11 +00:00
README.md README and contributing process updates 2023-08-23 22:09:24 +00:00

Linter for Dart

The Dart Linter package defines lint rules that identify and report on "lints" found in Dart code. Linting is performed by the Dart analysis server and the dart analyze command in the Dart command-line tool.

Installing

The linter is bundled with the Dart SDK; if you have an updated Dart SDK already, you're done!

Usage

The linter gives you feedback to help you catch potential errors and keep your code in line with the published Dart Style Guide. Enforceable lint rules (or "lints") are cataloged here and can be configured via an analysis options file. The linter is run from within the dart analyze command-line tool shipped with the Dart SDK. Assuming you have lints configured in an analysis_options.yaml file at the root of your project with these contents:

linter:
  rules:
    - annotate_overrides
    - hash_and_equals
    - prefer_is_not_empty

you could lint your package like this:

$ dart analyze .

and see any violations of the annotate_overrides, hash_and_equals, and prefer_is_not_empty rules in the console. To help you choose the rules you want to enable for your package, we have provided a complete list of rules with lints recommended by the Dart team collected in package:lints. Lints recommended for Flutter apps, packages, and plugins are documented in package:flutter_lints.

If a specific lint warning should be ignored, it can be flagged with a comment. For example,

   // ignore: camel_case_types
   class whyOhWhy { }

tells the Dart analyzer to ignore this instance of the camel_case_types warning.

End-of-line comments are supported as well. The following communicates the same thing:

   class whyOhWhy { // ignore: camel_case_types

To ignore a rule for an entire file, use the ignore_for_file comment flag. For example,

// ignore_for_file: camel_case_types

...

class whyOhWhy { }

tells the Dart analyzer to ignore all occurrences of the camel_case_types warning in this file.

As lints are treated the same as errors and warnings by the analyzer, their severity can similarly be configured in an options file. For example, an analysis options file that specifies

linter:
  rules:
    - camel_case_types
analyzer:
  errors:
    camel_case_types: error

tells the analyzer to treat camel_case_types lints as errors. For more on configuring analysis see the analysis option file docs.

Contributing

Feedback is greatly appreciated and contributions are welcome! Please read the contribution guidelines; mechanics of writing lints are covered here.

Features and bugs

Please file feature requests and bugs in the issue tracker.