Merge branch 'main' into feat/workspace-license-support

Author: meylis1998

.github/workflows/bump_templates.yaml

@@ -23,7 +23,7 @@ jobs:
         run: tool/generate_bundles.sh
 
       - name: Create Pull Request
-        uses: peter-evans/create-pull-request@v8.0.0
+        uses: peter-evans/create-pull-request@v8.1.0
         with:
           base: main
           labels: bot

.github/workflows/spdx_license_bot.yaml

@@ -47,7 +47,7 @@ jobs:
 
       - name: 📝 Create Pull Request
         if: ${{ env.did_change == 'true' }}
-        uses: peter-evans/create-pull-request@v8.0.0
+        uses: peter-evans/create-pull-request@v8.1.0
         with:
           base: main
           labels: bot

lib/src/commands/dart/commands/dart_test_command.dart

@@ -19,6 +19,7 @@ class DartTestOptions {
     required this.excludeFromCoverage,
     required this.randomSeed,
     required this.optimizePerformance,
+    required this.failFast,
     required this.forceAnsi,
     required this.platform,
     required this.rest,
@@ -41,6 +42,7 @@ class DartTestOptions {
         ? Random().nextInt(4294967295).toString()
         : randomOrderingSeed;
     final optimizePerformance = argResults['optimization'] as bool;
+    final failFast = argResults['fail-fast'] as bool;
     final forceAnsi = argResults['force-ansi'] as bool?;
     final platform = argResults['platform'] as String?;
     final reportOn = argResults['report-on'] as String?;
@@ -55,6 +57,7 @@ class DartTestOptions {
       excludeFromCoverage: excludeFromCoverage,
       randomSeed: randomSeed,
       optimizePerformance: optimizePerformance,
+      failFast: failFast,
       forceAnsi: forceAnsi,
       platform: platform,
       reportOn: reportOn,
@@ -86,6 +89,9 @@ class DartTestOptions {
   /// Whether to apply optimizations for test performance.
   final bool optimizePerformance;
 
+  /// Whether to stop running tests after the first failure.
+  final bool failFast;
+
   /// Whether to force ansi output. If not specified, it will maintain the
   /// default behavior based on stdout and stderr.
   final bool? forceAnsi;
@@ -171,7 +177,7 @@ class DartTestCommand extends Command<int> {
         'exclude-coverage',
         help:
             'A glob which will be used to exclude files that match from the '
-            'coverage.',
+            "coverage (e.g. '**/*.g.dart').",
       )
       ..addOption(
         'exclude-tags',
@@ -188,6 +194,11 @@ class DartTestCommand extends Command<int> {
             'The seed to randomize the execution order of test cases '
             'within test files.',
       )
+      ..addFlag(
+        'fail-fast',
+        help: 'Stop running tests after the first failure.',
+        negatable: false,
+      )
       ..addFlag(
         'force-ansi',
         defaultsTo: null,
@@ -265,6 +276,7 @@ This command should be run from the root of your Dart project.''');
           arguments: [
             if (options.excludeTags != null) ...['-x', options.excludeTags!],
             if (options.tags != null) ...['-t', options.tags!],
+            if (options.failFast) '--fail-fast',
             if (options.platform != null) ...['--platform', options.platform!],
             if (options.platform == null) ...['-j', options.concurrency],
             ...options.rest,

lib/src/commands/test/test.dart

@@ -20,6 +20,7 @@ class FlutterTestOptions {
     required this.randomSeed,
     required this.optimizePerformance,
     required this.updateGoldens,
+    required this.failFast,
     required this.forceAnsi,
     required this.dartDefine,
     required this.dartDefineFromFile,
@@ -44,6 +45,7 @@ class FlutterTestOptions {
         : randomOrderingSeed;
     final optimizePerformance = argResults['optimization'] as bool;
     final updateGoldens = argResults['update-goldens'] as bool;
+    final failFast = argResults['fail-fast'] as bool;
     final forceAnsi = argResults['force-ansi'] as bool?;
     final dartDefine = argResults['dart-define'] as List<String>?;
     final dartDefineFromFile =
@@ -61,6 +63,7 @@ class FlutterTestOptions {
       randomSeed: randomSeed,
       optimizePerformance: optimizePerformance,
       updateGoldens: updateGoldens,
+      failFast: failFast,
       forceAnsi: forceAnsi,
       dartDefine: dartDefine,
       dartDefineFromFile: dartDefineFromFile,
@@ -97,6 +100,9 @@ class FlutterTestOptions {
   /// the golden files.
   final bool updateGoldens;
 
+  /// Whether to stop running tests after the first failure.
+  final bool failFast;
+
   /// Whether to force ansi output. If not specified, it will maintain the
   /// default behavior based on stdout and stderr.
   final bool? forceAnsi;
@@ -185,7 +191,7 @@ class TestCommand extends Command<int> {
         'exclude-coverage',
         help:
             'A glob which will be used to exclude files that match from the '
-            'coverage.',
+            "coverage (e.g. '**/*.g.dart').",
       )
       ..addOption(
         'exclude-tags',
@@ -209,6 +215,11 @@ class TestCommand extends Command<int> {
             'should update the golden files.',
         negatable: false,
       )
+      ..addFlag(
+        'fail-fast',
+        help: 'Stop running tests after the first failure.',
+        negatable: false,
+      )
       ..addFlag(
         'force-ansi',
         defaultsTo: null,
@@ -306,6 +317,7 @@ This command should be run from the root of your Flutter project.''');
             if (options.excludeTags != null) ...['-x', options.excludeTags!],
             if (options.tags != null) ...['-t', options.tags!],
             if (options.updateGoldens) '--update-goldens',
+            if (options.failFast) '--fail-fast',
             if (options.platform != null) ...['--platform', options.platform!],
             if (options.dartDefine != null)
               for (final value in options.dartDefine!) '--dart-define=$value',

site/docs/commands/test.md

@@ -22,7 +22,7 @@ very_good test [arguments]
 -j, --concurrency                     The number of concurrent test suites run.
                                       (defaults to "4")
 -t, --tags                            Run only tests associated with the specified tags.
-    --exclude-coverage                A glob which will be used to exclude files that match from the coverage.
+    --exclude-coverage                A glob which will be used to exclude files that match from the coverage (e.g. '**/*.g.dart').
 -x, --exclude-tags                    Run only tests that do not have the specified tags.
     --min-coverage                    Whether to enforce a minimum coverage percentage.
     --test-randomize-ordering-seed    The seed to randomize the execution order of test cases within test files.

site/package-lock.json

@@ -27,7 +27,7 @@
     "react-dom": "^19.2.3"
   },
   "devDependencies": {
-    "@babel/eslint-parser": "^7.28.5",
+    "@babel/eslint-parser": "^7.28.6",
     "@docusaurus/eslint-plugin": "^3.9.2",
     "@docusaurus/module-type-aliases": "^3.9.2",
     "@docusaurus/tsconfig": "3.9.2",
@@ -37,7 +37,7 @@
     "eslint-plugin-jest": "^29.12.1",
     "globals": "^17.0.0",
     "jest": "^30.2.0",
-    "prettier": "^3.7.4",
+    "prettier": "^3.8.0",
     "typescript": "^5.9.3"
   },
   "browserslist": {

site/package.json

@@ -34,10 +34,11 @@ const expectedTestUsage = [
       '-j, --concurrency                     The number of concurrent test suites run. Automatically set to 1 when --platform is specified.\n'
       '                                      (defaults to "4")\n'
       '-t, --tags                            Run only tests associated with the specified tags.\n'
-      '    --exclude-coverage                A glob which will be used to exclude files that match from the coverage.\n'
+      "    --exclude-coverage                A glob which will be used to exclude files that match from the coverage (e.g. '**/*.g.dart').\n"
       '-x, --exclude-tags                    Run only tests that do not have the specified tags.\n'
       '    --min-coverage                    Whether to enforce a minimum coverage percentage.\n'
       '    --test-randomize-ordering-seed    The seed to randomize the execution order of test cases within test files.\n'
+      '    --fail-fast                       Stop running tests after the first failure.\n'
       '    --force-ansi                      Whether to force ansi output. If not specified, it will maintain the default behavior based on stdout and stderr.\n'
       '    --report-on=<lib/>                An optional file path to report coverage information to. This should be a path relative to the current working directory.\n'
       '    --platform=<chrome|vm>            The platform to run tests on. \n'
@@ -108,6 +109,7 @@ void main() {
       when<dynamic>(() => argResults['concurrency']).thenReturn(concurrency);
       when<dynamic>(() => argResults['recursive']).thenReturn(false);
       when<dynamic>(() => argResults['coverage']).thenReturn(false);
+      when<dynamic>(() => argResults['fail-fast']).thenReturn(false);
       when<dynamic>(() => argResults['optimization']).thenReturn(true);
       when<dynamic>(() => argResults['platform']).thenReturn(null);
       when(() => argResults.rest).thenReturn([]);
@@ -256,6 +258,21 @@ void main() {
       ).called(1);
     });
 
+    test('completes normally --fail-fast', () async {
+      when<dynamic>(() => argResults['fail-fast']).thenReturn(true);
+      final result = await testCommand.run();
+      expect(result, equals(ExitCode.success.code));
+      verify(
+        () => dartTest(
+          optimizePerformance: true,
+          arguments: ['--fail-fast', ...defaultArguments],
+          logger: logger,
+          stdout: logger.write,
+          stderr: logger.err,
+        ),
+      ).called(1);
+    });
+
     test('completes normally --platform chrome', () async {
       when<dynamic>(() => argResults['platform']).thenReturn('chrome');
       final result = await testCommand.run();

test/src/commands/dart/commands/dart_test_test.dart

@@ -34,11 +34,12 @@ const expectedTestUsage = [
       '-j, --concurrency                                            The number of concurrent test suites run. Automatically set to 1 when --platform is specified.\n'
       '                                                             (defaults to "4")\n'
       '-t, --tags                                                   Run only tests associated with the specified tags.\n'
-      '    --exclude-coverage                                       A glob which will be used to exclude files that match from the coverage.\n'
+      "    --exclude-coverage                                       A glob which will be used to exclude files that match from the coverage (e.g. '**/*.g.dart').\n"
       '-x, --exclude-tags                                           Run only tests that do not have the specified tags.\n'
       '    --min-coverage                                           Whether to enforce a minimum coverage percentage.\n'
       '    --test-randomize-ordering-seed                           The seed to randomize the execution order of test cases within test files.\n'
       '    --update-goldens                                         Whether "matchesGoldenFile()" calls within your test methods should update the golden files.\n'
+      '    --fail-fast                                              Stop running tests after the first failure.\n'
       '    --force-ansi                                             Whether to force ansi output. If not specified, it will maintain the default behavior based on stdout and stderr.\n'
       '    --dart-define=<foo=bar>                                  Additional key-value pairs that will be available as constants from the String.fromEnvironment, bool.fromEnvironment, int.fromEnvironment, and double.fromEnvironment constructors. Multiple defines can be passed by repeating "--dart-define" multiple times.\n'
       '    --dart-define-from-file=<use-define-config.json|.env>    The path of a .json or .env file containing key-value pairs that will be available as environment variables. These can be accessed using the String.fromEnvironment, bool.fromEnvironment, and int.fromEnvironment constructors. Multiple defines can be passed by repeating "--dart-define-from-file" multiple times. Entries from "--dart-define" with identical keys take precedence over entries from these files.\n'
@@ -110,6 +111,7 @@ void main() {
       when<dynamic>(() => argResults['recursive']).thenReturn(false);
       when<dynamic>(() => argResults['coverage']).thenReturn(false);
       when<dynamic>(() => argResults['update-goldens']).thenReturn(false);
+      when<dynamic>(() => argResults['fail-fast']).thenReturn(false);
       when<dynamic>(() => argResults['optimization']).thenReturn(true);
       when<dynamic>(() => argResults['platform']).thenReturn(null);
       when(() => argResults.rest).thenReturn([]);
@@ -272,6 +274,21 @@ void main() {
       ).called(1);
     });
 
+    test('completes normally --fail-fast', () async {
+      when<dynamic>(() => argResults['fail-fast']).thenReturn(true);
+      final result = await testCommand.run();
+      expect(result, equals(ExitCode.success.code));
+      verify(
+        () => flutterTest(
+          optimizePerformance: true,
+          arguments: ['--fail-fast', ...defaultArguments],
+          logger: logger,
+          stdout: logger.write,
+          stderr: logger.err,
+        ),
+      ).called(1);
+    });
+
     test('completes normally --platform chrome', () async {
       when<dynamic>(() => argResults['platform']).thenReturn('chrome');
       final result = await testCommand.run();