Merge branch 'main' into records-interface

.github/workflows/codeql-analysis.yml

@@ -33,7 +33,7 @@ jobs:
 
       # Initializes the CodeQL tools for scanning.
       - name: Initialize CodeQL
-        uses: github/codeql-action/init@dd746615b3b9d728a6a37ca2045b68ca76d4841a
+        uses: github/codeql-action/init@9e8d0789d4a0fa9ceb6b1738f7e269594bdd67f0
         with:
           languages: ${{ matrix.language }}
           # If you wish to specify custom queries, you can do so here or in a config file.
@@ -44,7 +44,7 @@ jobs:
       # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
       # If this step fails, then you should remove it and run the build manually (see below)
       - name: Autobuild
-        uses: github/codeql-action/autobuild@dd746615b3b9d728a6a37ca2045b68ca76d4841a
+        uses: github/codeql-action/autobuild@9e8d0789d4a0fa9ceb6b1738f7e269594bdd67f0
 
       # ℹ️ Command-line programs to run using the OS shell.
       # 📚 https://git.io/JvXDl
@@ -58,4 +58,4 @@ jobs:
       #   make release
 
       - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@dd746615b3b9d728a6a37ca2045b68ca76d4841a
+        uses: github/codeql-action/analyze@9e8d0789d4a0fa9ceb6b1738f7e269594bdd67f0

.github/workflows/scorecards-analysis.yml

@@ -49,6 +49,6 @@ jobs:
 
       # Upload the results to GitHub's code scanning dashboard.
       - name: "Upload to code-scanning"
-        uses: github/codeql-action/upload-sarif@dd746615b3b9d728a6a37ca2045b68ca76d4841a
+        uses: github/codeql-action/upload-sarif@9e8d0789d4a0fa9ceb6b1738f7e269594bdd67f0
         with:
           sarif_file: results.sarif

.github/workflows/test.yml

@@ -40,7 +40,7 @@ jobs:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
         with:
           submodules: recursive
-      - uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+      - uses: dart-lang/setup-dart@e51d8e571e22473a2ddebf0ef8a2123f0ab2c02c
         with:
           sdk: ${{ matrix.sdk }}
       - name: Fetch Dart packages
@@ -59,7 +59,7 @@ jobs:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
         with:
           submodules: recursive
-      - uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+      - uses: dart-lang/setup-dart@e51d8e571e22473a2ddebf0ef8a2123f0ab2c02c
         with:
           sdk: stable
       - name: Fetch Dart packages
@@ -74,12 +74,12 @@ jobs:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
         with:
           submodules: recursive
-      - uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+      - uses: dart-lang/setup-dart@e51d8e571e22473a2ddebf0ef8a2123f0ab2c02c
         with:
           sdk: stable
       - name: Fetch Dart packages
         run: dart pub get
-      - uses: pnpm/action-setup@fe02b34f77f8bc703788d5817da081398fad5dd2
+      - uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
       - uses: actions/setup-node@1d0ff469b7ec7b3cb9d8673fde0c81c44821de2a
         with:
           node-version: ${{ env.NODE_VERSION }}
@@ -100,7 +100,7 @@ jobs:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
         with:
           submodules: recursive
-      - uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+      - uses: dart-lang/setup-dart@e51d8e571e22473a2ddebf0ef8a2123f0ab2c02c
         with:
           sdk: stable
       - name: Fetch Dart packages
@@ -115,7 +115,7 @@ jobs:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
         with:
           submodules: recursive
-      - uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+      - uses: dart-lang/setup-dart@e51d8e571e22473a2ddebf0ef8a2123f0ab2c02c
         with:
           sdk: stable
       - name: Fetch Dart packages

examples/analysis/pubspec.yaml

@@ -3,7 +3,7 @@ description: dart.dev example code.
 
 resolution: workspace
 environment:
-  sdk: ^3.6.1
+  sdk: ^3.7.0
 
 dependencies:
   examples_util: {path: ../util}

examples/analysis_alt/pubspec.yaml

@@ -3,4 +3,4 @@ description: dart.dev example code.
 
 resolution: workspace
 environment:
-  sdk: ^3.6.1
+  sdk: ^3.7.0

examples/async_await/bin/futures_intro.dart

@@ -19,4 +19,5 @@ void main() {
   fetchUserOrder();
   print('Fetching user order...');
 }
+
 // #enddocregion no-error, error

examples/async_await/bin/get_order.dart

@@ -4,11 +4,8 @@ Future<String> createOrderMessage() async {
 }
 
 Future<String> fetchUserOrder() =>
-    // Imagine that this function is more complex and slow.
-    Future.delayed(
-      const Duration(seconds: 2),
-      () => 'Large Latte',
-    );
+// Imagine that this function is more complex and slow.
+Future.delayed(const Duration(seconds: 2), () => 'Large Latte');
 
 // #docregion main-sig
 Future<void> main() async {

examples/async_await/bin/get_order_sync_bad.dart

@@ -7,16 +7,14 @@ String createOrderMessage() {
 }
 
 Future<String> fetchUserOrder() =>
-    // Imagine that this function is more complex and slow.
-    Future.delayed(
-      const Duration(seconds: 2),
-      () => 'Large Latte',
-    );
+// Imagine that this function is more complex and slow.
+Future.delayed(const Duration(seconds: 2), () => 'Large Latte');
 
 // #docregion main-sig
 void main() {
   // #enddocregion main-sig
   print('Fetching user order...');
   print(createOrderMessage());
 }
+
 // #enddocregion no-warning

examples/async_await/bin/try_catch.dart

@@ -13,9 +13,10 @@ Future<void> printOrderMessage() async {
 Future<String> fetchUserOrder() {
   // Imagine that this function is more complex.
   var str = Future.delayed(
-      const Duration(seconds: 4),
-      // ignore: only_throw_errors
-      () => throw 'Cannot locate user order');
+    const Duration(seconds: 4),
+    // ignore: only_throw_errors
+    () => throw 'Cannot locate user order',
+  );
   return str;
 }
 

examples/async_await/lib/practice_errors/solution.dart

@@ -8,4 +8,5 @@ Future<String> changeUsername() async {
     return err.toString();
   }
 }
+
 // #enddocregion

examples/async_await/lib/practice_errors/test.dart

@@ -24,22 +24,28 @@ Future<String> fetchNewUsername() {
 void main() async {
   try {
     messages
-      ..add(makeReadable(
+      ..add(
+        makeReadable(
           testLabel: '',
           testResult: await asyncDidCatchException(changeUsername),
           readableErrors: {
             typoMessage: typoMessage,
             noCatch:
                 'Did you remember to call fetchNewUsername within a try/catch block?',
-          }))
-      ..add(makeReadable(
+          },
+        ),
+      )
+      ..add(
+        makeReadable(
           testLabel: '',
           testResult: await asyncErrorEquals(changeUsername),
           readableErrors: {
             typoMessage: typoMessage,
             noCatch:
                 'Did you remember to call fetchNewUsername within a try/catch block?',
-          }))
+          },
+        ),
+      )
       ..removeWhere((m) => m.contains(passed))
       ..toList();
 
@@ -73,10 +79,11 @@ void passIfNoMessages(List<String> messages, Map<String, String> readable) {
   if (messages.isEmpty) {
     _result(true);
   } else {
-    final userMessages = messages
-        .where((message) => readable.containsKey(message))
-        .map((message) => readable[message]!)
-        .toList();
+    final userMessages =
+        messages
+            .where((message) => readable.containsKey(message))
+            .map((message) => readable[message]!)
+            .toList();
     print(messages);
 
     _result(false, userMessages);
@@ -109,4 +116,5 @@ Future<String> asyncDidCatchException(Function fn) async {
     return passed;
   }
 }
+
 // #enddocregion

examples/async_await/lib/practice_using/solution.dart

@@ -10,4 +10,5 @@ Future<String> reportLogins() async {
   var logins = await fetchLoginAmount();
   return 'Total number of logins: $logins';
 }
+
 // #enddocregion

examples/async_await/lib/practice_using/test.dart

@@ -20,12 +20,14 @@ Future<int> fetchLoginAmount() => Future.delayed(oneSecond, () => logins);
 void main() async {
   try {
     messages
-      ..add(makeReadable(
+      ..add(
+        makeReadable(
           testLabel: 'Part 1',
           testResult: await asyncEquals(
-              expected: 'User role: administrator',
-              actual: await reportUserRole(),
-              typoKeyword: role),
+            expected: 'User role: administrator',
+            actual: await reportUserRole(),
+            typoKeyword: role,
+          ),
           readableErrors: {
             typoMessage: typoMessage,
             'null': '$didNotImplement reportUserRole?',
@@ -39,13 +41,17 @@ void main() async {
                 '$testFailedMessage reportUserRole. Did you return a user role?',
             'User role: tester':
                 '$testFailedMessage reportUserRole. Did you invoke fetchRole to fetch the user\'s role?',
-          }))
-      ..add(makeReadable(
+          },
+        ),
+      )
+      ..add(
+        makeReadable(
           testLabel: 'Part 2',
           testResult: await asyncEquals(
-              expected: 'Total number of logins: 42',
-              actual: await reportLogins(),
-              typoKeyword: logins.toString()),
+            expected: 'Total number of logins: 42',
+            actual: await reportLogins(),
+            typoKeyword: logins.toString(),
+          ),
           readableErrors: {
             typoMessage: typoMessage,
             'null': '$didNotImplement reportLogins?',
@@ -59,7 +65,9 @@ void main() async {
                 '$testFailedMessage reportLogins. Did you return the number of logins?',
             'Total number of logins: 57':
                 '$testFailedMessage reportLogins. Did you invoke fetchLoginAmount to fetch the number of user logins?',
-          }))
+          },
+        ),
+      )
       ..removeWhere((m) => m.contains(passed))
       ..toList();
 
@@ -69,9 +77,7 @@ void main() async {
       _result(false, messages);
     }
   } on UnimplementedError {
-    _result(false, [
-      '$didNotImplement reportUserRole?',
-    ]);
+    _result(false, ['$didNotImplement reportUserRole?']);
   } catch (e) {
     _result(false, ['Tried to run solution, but received an exception: $e']);
   }
@@ -114,4 +120,5 @@ Future<String> asyncEquals({
     return e.toString();
   }
 }
+
 // #enddocregion

examples/async_await/lib/putting_together/solution.dart

@@ -16,4 +16,5 @@ Future<String> sayGoodbye() async {
     return 'Failed to logout user: $e';
   }
 }
+
 // #enddocregion