docs: add example glob pattern to --exclude-coverage help text (#1452)

* docs: add example glob pattern to --exclude-coverage help text

Clarifies that recursive glob patterns (e.g. '**/*.g.dart') are needed
to match files in subdirectories.

Closes #654

* test: update test expectations

* test: update test expectations

* fix: avoid escaping inner quotes

* chore: format test files

---------

Co-authored-by: Marcos Sevilla <[email protected]>

Author: meylis1998

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

@@ -177,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',

lib/src/commands/test/test.dart

@@ -191,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',

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.

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

@@ -34,7 +34,7 @@ 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'

test/src/commands/test/test_test.dart

@@ -34,7 +34,7 @@ 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'