OLD | NEW |
1 Each package may include a configuration file that applies to the package as a | 1 Each package may include a configuration file that applies to the package as a |
2 whole. This file can be used to provide custom defaults for various options, to | 2 whole. This file can be used to provide custom defaults for various options, to |
3 define configuration for multiple files, and more. | 3 define configuration for multiple files, and more. |
4 | 4 |
5 The file is named `dart_test.yaml` and lives at the root of the package, next to | 5 The file is named `dart_test.yaml` and lives at the root of the package, next to |
6 the package's pubspec. Like the pubspec, it's a [YAML][] file. Here's an | 6 the package's pubspec. Like the pubspec, it's a [YAML][] file. Here's an |
7 example: | 7 example: |
8 | 8 |
9 [YAML]: http://yaml.org/ | 9 [YAML]: http://yaml.org/ |
10 | 10 |
(...skipping 22 matching lines...) Expand all Loading... |
33 * [Runner Configuration](#runner-configuration) | 33 * [Runner Configuration](#runner-configuration) |
34 * [`paths`](#paths) | 34 * [`paths`](#paths) |
35 * [`filename`](#filename) | 35 * [`filename`](#filename) |
36 * [`names`](#names) | 36 * [`names`](#names) |
37 * [`plain_names`](#plain_names) | 37 * [`plain_names`](#plain_names) |
38 * [`include_tags`](#include_tags) | 38 * [`include_tags`](#include_tags) |
39 * [`exclude_tags`](#exclude_tags) | 39 * [`exclude_tags`](#exclude_tags) |
40 * [`platforms`](#platforms) | 40 * [`platforms`](#platforms) |
41 * [`concurrency`](#concurrency) | 41 * [`concurrency`](#concurrency) |
42 * [`pause_after_load`](#pause_after_load) | 42 * [`pause_after_load`](#pause_after_load) |
| 43 * [`run_skipped`](#run_skipped) |
43 * [`pub_serve`](#pub_serve) | 44 * [`pub_serve`](#pub_serve) |
44 * [`reporter`](#reporter) | 45 * [`reporter`](#reporter) |
45 * [Configuring Tags](#configuring-tags) | 46 * [Configuring Tags](#configuring-tags) |
46 * [`tags`](#tags) | 47 * [`tags`](#tags) |
47 * [`add_tags`](#add_tags) | 48 * [`add_tags`](#add_tags) |
48 * [Configuring Platforms](#configuring-platforms) | 49 * [Configuring Platforms](#configuring-platforms) |
49 * [`on_os`](#on_os) | 50 * [`on_os`](#on_os) |
50 * [`on_platform`](#on_platform) | 51 * [`on_platform`](#on_platform) |
51 * [Configuration Presets](#configuration-presets) | 52 * [Configuration Presets](#configuration-presets) |
52 * [`presets`](#presets) | 53 * [`presets`](#presets) |
(...skipping 267 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
320 | 321 |
321 ```yaml | 322 ```yaml |
322 presets: | 323 presets: |
323 # Pass "-P debug" to enable debugging configuration | 324 # Pass "-P debug" to enable debugging configuration |
324 debug: | 325 debug: |
325 pause_after_load: true | 326 pause_after_load: true |
326 exclude_tags: undebuggable | 327 exclude_tags: undebuggable |
327 reporter: expanded | 328 reporter: expanded |
328 ``` | 329 ``` |
329 | 330 |
| 331 ### `run_skipped` |
| 332 |
| 333 This field indicates that the test runner should run tests even if they're |
| 334 marked as skipped. |
| 335 |
| 336 This is usually used in a [preset](#configuration-presets). |
| 337 |
| 338 ```yaml |
| 339 presets: |
| 340 # Pass "-P all" to run all tests |
| 341 debug: |
| 342 run_skipped: true |
| 343 paths: ["test/", "extra_test/"] |
| 344 ``` |
| 345 |
330 ### `pub_serve` | 346 ### `pub_serve` |
331 | 347 |
332 This field indicates that the test runner should run against a `pub serve` | 348 This field indicates that the test runner should run against a `pub serve` |
333 instance by default, and provides the port number for that instance. Note that | 349 instance by default, and provides the port number for that instance. Note that |
334 if there is no `pub serve` instance running at that port, running the tests will | 350 if there is no `pub serve` instance running at that port, running the tests will |
335 fail by default. | 351 fail by default. |
336 | 352 |
337 ```yaml | 353 ```yaml |
338 pub_serve: 8081 | 354 pub_serve: 8081 |
339 ``` | 355 ``` |
(...skipping 226 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
566 | 582 |
567 The test runner also supports a global configuration file. On Windows, this | 583 The test runner also supports a global configuration file. On Windows, this |
568 file's local defaults to `%LOCALAPPDATA%\DartTest.yaml`. On Unix, it defaults to | 584 file's local defaults to `%LOCALAPPDATA%\DartTest.yaml`. On Unix, it defaults to |
569 `~/.dart_test.yaml`. It can also be explicitly set using the `DART_TEST_CONFIG` | 585 `~/.dart_test.yaml`. It can also be explicitly set using the `DART_TEST_CONFIG` |
570 environment variable. | 586 environment variable. |
571 | 587 |
572 The global configuration file supports a subset of the fields supported by the | 588 The global configuration file supports a subset of the fields supported by the |
573 package-specific configuration file. In general, it doesn't support fields that | 589 package-specific configuration file. In general, it doesn't support fields that |
574 are closely tied to the structure of an individual package. Fields that are not | 590 are closely tied to the structure of an individual package. Fields that are not |
575 supported in the global configuration file say so in their documentation. | 591 supported in the global configuration file say so in their documentation. |
OLD | NEW |