dart-sdk/pkg
Sam Rawlins ae3de54bbb Tidy up LintCode docs before making public API
Work towards https://github.com/dart-lang/sdk/issues/50986

Cq-Include-Trybots: luci.dart.try:flutter-analyze-try,analyzer-win-release-try,pkg-win-release-try
Change-Id: I60d378da27570f6b76a554685802d3b888edee0d
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/372182
Reviewed-by: Brian Wilkerson <brianwilkerson@google.com>
Commit-Queue: Sam Rawlins <srawlins@google.com>
2024-06-20 16:44:45 +00:00
..
_fe_analyzer_shared [analyzer/cfe] Replace StackListener.importUri with isDartLibrary 2024-06-19 12:47:21 +00:00
_js_interop_checks [cfe] Move fasta/codes/ to src/ and rename to cfe_codes* 2024-06-20 09:36:39 +00:00
_macros skip failing macro test 2024-06-12 20:59:34 +00:00
analysis_server analyzer: Deprecate dead properties on Comment 2024-06-18 18:27:25 +00:00
analysis_server_client [pkg/analysis_server] remove use of package:usage 2024-05-07 22:11:29 +00:00
analysis_server_plugin analyzer: Fix resolution of private extension members 2024-06-17 18:28:21 +00:00
analyzer Tidy up LintCode docs before making public API 2024-06-20 16:44:45 +00:00
analyzer_cli CQ. Make FileSource API, move to lib/source. 2024-06-03 00:36:59 +00:00
analyzer_plugin Expose CommentToken as analyzer public API 2024-06-18 17:34:27 +00:00
analyzer_utilities Use shared mock packages in linter 2024-06-19 14:07:19 +00:00
async_helper
bisect_dart
build_integration
compiler [dart2js] Use patterns for HIndex simplifications 2024-06-18 23:19:28 +00:00
dart2js_info
dart2js_runtime_metrics
dart2js_tools
dart2native [dartdev] Add --depfile option to dart compile 2024-05-23 12:58:29 +00:00
dart2wasm [dart2wasm] Move JSStringImpl to dart:_string 2024-06-20 13:08:03 +00:00
dart_internal Bump dart_internal again to work with the latest dev builds. 2024-05-02 23:06:47 +00:00
dart_service_protocol_shared
dartdev [analyzer] Prioritize errors in analysis_options/pubspec errors when running "dart analyze" 2024-06-18 17:29:16 +00:00
dds [ DDS ] Remove extra stderr.close() 2024-06-17 14:44:22 +00:00
dds_service_extensions
dev_compiler [ddc] Rename variable used to store late value 2024-06-05 20:50:49 +00:00
dtd Bump version in dtd 2024-04-23 16:38:48 +00:00
dtd_impl [dtd] Allow passing an explicit port to DTD 2024-06-17 14:58:19 +00:00
expect Reland "Tweak expect.dart library." 2024-04-26 15:28:26 +00:00
front_end [cfe] Remove StackListenerImpl.libraryBuilder. 2024-06-20 14:58:28 +00:00
frontend_server [pkg/vm] Consolidate kernel compilation options to an object 2024-06-10 22:56:50 +00:00
heap_snapshot
js Add topics to pubspec.yaml 2024-06-13 13:02:54 +00:00
js_ast Reland "Tweak expect.dart library." 2024-04-26 15:28:26 +00:00
js_runtime
js_shared
json package:json - drop vendored packages, prep to release 2024-05-24 15:41:05 +00:00
kernel [cfe] Move fasta/codes/ to src/ and rename to cfe_codes* 2024-06-20 09:36:39 +00:00
language_versioning_2_12_test
linter Use shared mock packages in linter 2024-06-19 14:07:19 +00:00
macros Macro. Re-export package:_macros/src/executor/response_impls.dart from 'package:macros'. 2024-06-13 19:12:41 +00:00
meta [pkg:meta] Add topics to pubspec.yaml 2024-06-10 10:27:36 +00:00
mmap
modular_test drop chmod operations, should not be necessary 2024-04-18 16:34:16 +00:00
native_stack_traces [vm] Add non-symbolic stack trace support for deferred loading units. 2024-04-19 08:10:18 +00:00
reload_test [reload_test] Adding support for negative tests in reload suite. 2024-04-24 12:45:44 +00:00
scrape
server_plugin DAS plugins: Move CorrectionUtils to analysis_server_plugin 2024-04-24 14:12:24 +00:00
smith [test] isVmAotConfiguration in custom configurations 2024-06-19 08:49:29 +00:00
sourcemap_testing Bump collection to c90b19f07b48391f3b1b4c39dd06ef0177f8e07c 2024-06-11 17:27:21 +00:00
status_file [status_files] Cleanup status files 2024-06-12 10:21:23 +00:00
telemetry [pkg/analysis_server] remove use of package:usage 2024-05-07 22:11:29 +00:00
test_runner [dart2wasm] Add dart2wasm-asserts-* configurations 2024-06-10 14:24:12 +00:00
testing [pkg/testing] restore analysis options settings 2024-04-19 14:45:41 +00:00
vm [cfe] Move fasta/codes/ to src/ and rename to cfe_codes* 2024-06-20 09:36:39 +00:00
vm_service [VM] Add RecordCoverage to InstanceCall and StaticCall 2024-06-17 10:47:58 +00:00
vm_service_interface
vm_service_protos
vm_snapshot_analysis
wasm_builder [wasm_builder] Update incorrect docs, some minor refactoring 2024-05-15 09:49:02 +00:00
.gitignore
analysis_options.yaml
BUILD.gn
OWNERS
pkg.dart
pkg.status [VM] Add RecordCoverage to InstanceCall and StaticCall 2024-06-17 10:47:58 +00:00
README.md

Package validation

The packages in pkg/ are automatically validated on the LUCI CI bots. The validation is largely done by the tools/package_deps package; it can be tested locally via:

dart tools/package_deps/bin/package_deps.dart

Packages which are published

There are several packages developed in pkg/ which are published to pub. Validation of these packages is particularly important because the pub tools are not used for these packages during development; we get our dependency versions from the DEPS file. It's very easy for the dependencies specified in a package's pubspec file to get out of date wrt the packages and versions actually used.

In order to better ensure we're publishing correct packages, we validate some properties of the pubspec files on our CI system. These validations include:

  • that the dependencies listed in the pubspec are used in the package
  • that all the packages used by the source are listed in the pubspec
  • that we don't use relative path deps to pkg/ or third_party/ packages

Packages which are not published

For packages in pkg/ which we do not intend to be published, we put the following comment in the pubspec.yaml file:

# This package is not intended for consumption on pub.dev. DO NOT publish.
publish_to: none

These pubspecs are still validated by the package validation tool. The contents are more informational as the pubspecs for these packages are not consumed by the pub tool or ecosystem.

We validate:

  • that the dependencies listed in the pubspec are used in the package
  • that all the packages used by the source are listed in the pubspec
  • that a reference to a pkg/ package is done via a relative path dependency