Paul Berry
b0b06bff31
Reason for revert: it was a breaking change to the analyzer public API.
There were two breakages:
- A @required `languageVersion` parameter was added to
AstFactory.compilationUnit, which is part of the officially
supported analyzer public API.
- A @required `languageVersion` parameter was added to the Parser
constructor, which is not part of the officially supported analyzer
public API, but is part of its de facto public API due to the fact
that it is used by dart_style.
This reverts commit ce26dfda7d.
Change-Id: I507103ea6f6ffabf915d6f56e9f24454725c3930
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/136851
Reviewed-by: Paul Berry <paulberry@google.com>
Reviewed-by: Konstantin Shcheglov <scheglov@google.com>
Commit-Queue: Paul Berry <paulberry@google.com>
dartanalyzer
Use dartanalyzer to statically analyze your code at the command line, checking for errors and warnings that are specified in the Dart Language Specification. DartPad, code editors, and IDEs such as Android Studio and VS Code use the same analysis engine that dartanalyzer uses.
Basic usage
Run the analyzer from the top directory of the package. Here's an example of testing a Dart file.
dartanalyzer bin/test.dart
Options
The following are the most commonly used options for dartanalyzer:
-
--packages=
Specify the path to the package resolution configuration file. For more information see Package Resolution Configuration File. This option cannot be used with--package-root. -
--package-warnings
Show warnings not only for code in the specified .dart file and others in its library, but also for libraries imported withpackage:. -
--options=
Specify the path to an analysis options file. -
--lints
Show the results from the linter. -
--no-hints
Don't show hints for improving the code. -
--ignore-unrecognized-flags
Rather than printing the help message, ignore any unrecognized command-line flags. -
--version
Show the analyzer version. -
-hor--help
Show all the command-line options.
The following are advanced options to use with dartanalyzer:
-
-bor--batch
Run in batch mode. -
--dart-sdk=
Specify the directory that contains the Dart SDK. -
--fatal-warnings
Except for type warnings, treat warnings as fatal. -
--format=machine
Produce output in a format suitable for parsing. -
--url-mapping=libraryUri,/path/to/library.dart
Tells the analyzer to use the specified library as the source for that particular import.
The following options are deprecated:
--package-root=
Deprecated. Specify the directory to search for any libraries that are imported usingpackage:. This option is replaced as of Dart 1.12 with--packages.