Commit Graph

16 Commits

Author SHA1 Message Date
Albert Moravec 7226a4ce87 [analysis_server] Allow analyzer plugins from hosted pub server
Added support for the `hosted` field in plugin definition,
so that analyzer plugins can be sourced from pub servers other
than pub.dev.

TEST=pkg/analysis_server/test/src/plugin2/generator_test.dart
TEST=pkg/analyzer/test/src/options/analysis_options_test.dart

Change-Id: Ie99693ab39c77b3d814843963613798f72e27f62
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/475580
Reviewed-by: Samuel Rawlins <srawlins@google.com>
Auto-Submit: Albert Moravec <albert.moravec@gmail.com>
Reviewed-by: Konstantin Shcheglov <scheglov@google.com>
Commit-Queue: Samuel Rawlins <srawlins@google.com>
Commit-Queue: Konstantin Shcheglov <scheglov@google.com>
2026-02-02 14:32:37 -08:00
Sam Rawlins 49dc34715e analyzer plugins: Document how to add a stub package in tests
Fixes https://github.com/dart-lang/sdk/issues/61915

I add documentation to a few APIs, and primarily document `newPackage`
and `PackageBuilder.addFile`, which already have sufficient doc
comments.

Change-Id: Ice088c2d76604ccb991d895a1e4bb408c492b963
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/467240
Reviewed-by: Brian Wilkerson <brianwilkerson@google.com>
Commit-Queue: Samuel Rawlins <srawlins@google.com>
Reviewed-by: Konstantin Shcheglov <scheglov@google.com>
2025-12-09 14:53:52 -08:00
Loïc Sharma 836465deaf Improve the docs of Dart analyzer plugins
Closes https://github.com/dart-lang/sdk/pull/62071

GitOrigin-RevId: ebbb22dde160ff788ad1f2cf6a24f4c86fa636f2
Change-Id: I5b30f18d8f553e8b03dd6dd8ad1e631505224091
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/464000
Commit-Queue: Samuel Rawlins <srawlins@google.com>
Reviewed-by: Samuel Rawlins <srawlins@google.com>
2025-12-01 18:35:01 -08:00
Sam Rawlins e2204d36d7 DAS plugins: Update various docs
Work towards https://github.com/dart-lang/sdk/issues/61876

* Make a few notes about support beginning with Dart 3.10.
* Make a few notes indicating that plugins can only analyze Dart
  sources.
* Use the handy `> [!NOTE]` and `> [!WARNING]` syntax.
* Add a note about how plugins are resolved, and the dependency on
  analysis_server_plugin ^0.3.0.

Change-Id: I6ed5b3611a0ab4ff005917b0c5cff1b6fa9d5c95
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/459240
Commit-Queue: Samuel Rawlins <srawlins@google.com>
Reviewed-by: Brian Wilkerson <brianwilkerson@google.com>
2025-11-03 11:49:49 -08:00
Sam Rawlins c0bd240db8 Simplify testing analysis rule by registering in AnalysisRuleTest
This changes the API of writing an analysis rule test. Instead of
overriding the `String get analysisRule` property, and registering the
rule in `setUp` (which requires importing a private type), the
developer can now just set the `AbstractAnalysisRule rule` field in
`setUp`. This both removes the requirement to manually register the
rule, and reduces the risk of typos, by removing the String API.

Fixes https://github.com/dart-lang/sdk/issues/61793

Change-Id: Ic7753d3157e06906ba5ccbccfea67aaa3179dcc8
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/459340
Commit-Queue: Samuel Rawlins <srawlins@google.com>
Reviewed-by: Brian Wilkerson <brianwilkerson@google.com>
2025-11-03 10:20:00 -08:00
Sam Rawlins 2c1debf5c7 DAS plugins: fix broken link in writing_rules.md
Change-Id: Ic63fbc3b4c8ae9c1bff866ed32d0cd02eec55bfb
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/456721
Reviewed-by: Brian Wilkerson <brianwilkerson@google.com>
2025-10-22 14:10:58 -07:00
Sam Rawlins 39c1850b44 DAS plugins: warn when plugins found in inner options file
Work towards https://github.com/dart-lang/sdk/issues/61481

Change-Id: I16d5333de6b5b195f629ec51ee582d793431f139
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/450220
Reviewed-by: Konstantin Shcheglov <scheglov@google.com>
Commit-Queue: Samuel Rawlins <srawlins@google.com>
Reviewed-by: Brian Wilkerson <brianwilkerson@google.com>
2025-09-18 13:35:29 -07:00
Sam Rawlins 71813c17dd Bump referenced versions in DAS plugins doc
Change-Id: I100c90e9ee0b0dcb1770c5bf4507fd7fc9ca4630
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/445344
Reviewed-by: Brian Wilkerson <brianwilkerson@google.com>
Commit-Queue: Samuel Rawlins <srawlins@google.com>
2025-08-15 11:23:54 -07:00
Sam Rawlins 0c3de0815f DAS plugins: Add docs on testing rules
Change-Id: Ia3e771a2f0b8ce01c0a57d3c442492943089a23b
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/439821
Commit-Queue: Samuel Rawlins <srawlins@google.com>
Reviewed-by: Brian Wilkerson <brianwilkerson@google.com>
2025-07-11 10:51:40 -07:00
Sam Rawlins 1ce5b15166 DAS plugins: Update docs for new public names
This change highlights how all of the necessary imports are now public!

From here, forward, we are guarded by analyzer's public API rules.

Change-Id: I71a7f928fc5913df846aa6253cd880719b4cd726
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/439342
Reviewed-by: Brian Wilkerson <brianwilkerson@google.com>
Commit-Queue: Samuel Rawlins <srawlins@google.com>
2025-07-08 11:15:02 -07:00
Sam Rawlins 1e92be4f2c DAS plugins: update docs for new diagnosticCode field and MultiAnalysisRule
Change-Id: If52b7557251fbe022ec873f003fafecf035a370a
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/429700
Reviewed-by: Brian Wilkerson <brianwilkerson@google.com>
Commit-Queue: Samuel Rawlins <srawlins@google.com>
2025-05-20 13:10:11 -07:00
Sam Rawlins 30a9f13794 DAS plugins: document assists
Change-Id: I2c50f36111cc319a85ad1a09369bcbdda14416d8
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/419762
Reviewed-by: Brian Wilkerson <brianwilkerson@google.com>
Commit-Queue: Samuel Rawlins <srawlins@google.com>
2025-04-02 08:16:49 -07:00
Sam Rawlins 9cb7e9ea0c DAS: document enabling lint rule and suppressing
Change-Id: I26504b84c3a899c4f9f80d8a35f6c2c622c5613c
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/416181
Reviewed-by: Johnni Winther <johnniwinther@google.com>
Commit-Queue: Samuel Rawlins <srawlins@google.com>
Reviewed-by: Brian Wilkerson <brianwilkerson@google.com>
2025-03-18 09:51:59 -07:00
Sam Rawlins bfaf70f194 DAS plugins: Document writing quick fixes
Change-Id: I38dc64d8ff9f59dd9e45d30715a08233f4891b74
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/410563
Reviewed-by: Brian Wilkerson <brianwilkerson@google.com>
Commit-Queue: Samuel Rawlins <srawlins@google.com>
2025-02-18 14:17:10 -08:00
Sam Rawlins b77b1f2277 DAS plugins: Add docs for writing a plugin.
Here we provide docs specifically for writing a plugin, using a plugin, and we
improve the text about writing rules.

Change-Id: I3fcfbc50609054158e5bdf964499005a79b4fba8
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/410160
Reviewed-by: Brian Wilkerson <brianwilkerson@google.com>
Commit-Queue: Samuel Rawlins <srawlins@google.com>
2025-02-14 17:26:01 -08:00
Sam Rawlins e508372d2b DAS plugins: initial doc for writing rules
Change-Id: I50957b9ae9b19d8cfa5371f5398bc3a001df1661
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/408940
Reviewed-by: Brian Wilkerson <brianwilkerson@google.com>
Commit-Queue: Samuel Rawlins <srawlins@google.com>
2025-02-12 11:24:48 -08:00