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 21 matching lines...) Expand all Loading... | |
32 * [`test_on`](#test_on) | 32 * [`test_on`](#test_on) |
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 * [`pub_serve`](#pub_serve) | 43 * [`pub_serve`](#pub_serve) |
43 * [`reporter`](#reporter) | 44 * [`reporter`](#reporter) |
44 * [Configuring Tags](#configuring-tags) | 45 * [Configuring Tags](#configuring-tags) |
45 * [`tags`](#tags) | 46 * [`tags`](#tags) |
46 * [`add_tags`](#add_tags) | 47 * [`add_tags`](#add_tags) |
47 * [Configuring Platforms](#configuring-platforms) | 48 * [Configuring Platforms](#configuring-platforms) |
48 * [`on_os`](#on_os) | 49 * [`on_os`](#on_os) |
49 * [`on_platform`](#on_platform) | 50 * [`on_platform`](#on_platform) |
50 * [Configuration Presets](#configuration-presets) | 51 * [Configuration Presets](#configuration-presets) |
51 * [`presets`](#presets) | 52 * [`presets`](#presets) |
(...skipping 224 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
276 This field indicates the default number of test suites to run in parallel. More | 277 This field indicates the default number of test suites to run in parallel. More |
277 parallelism can improve the overall speed of running tests up to a point, but | 278 parallelism can improve the overall speed of running tests up to a point, but |
278 eventually it just adds more memory overhead without any performance gain. This | 279 eventually it just adds more memory overhead without any performance gain. This |
279 defaults to approximately half the number of processors on the current machine. | 280 defaults to approximately half the number of processors on the current machine. |
280 If it's set to 1, only one test suite will run at a time. | 281 If it's set to 1, only one test suite will run at a time. |
281 | 282 |
282 ```yaml | 283 ```yaml |
283 concurrency: 3 | 284 concurrency: 3 |
284 ``` | 285 ``` |
285 | 286 |
287 ### `pause_after_load` | |
288 | |
289 This field indicates that the test runner should pause for debugging after each | |
290 test suite is loaded but before its tests are executed. If it's set, | |
291 [`concurrency`](#concurrency) is automatically set to 1 and | |
292 [`timeout`](#timeout) is automatically set to `none`. | |
293 | |
294 This is usually used in a [preset](#configuration-presets). | |
295 | |
296 ```yaml | |
297 presets: | |
298 # Pass -P debug to enable debugging configuration | |
kevmoo
2016/03/21 20:12:24
quotes (or something) around "-P debug" ?
nweiz
2016/03/21 20:27:54
Done.
| |
299 debug: | |
300 pause_after_load: true | |
301 exclude_tags: undebuggable | |
302 reporter: expanded | |
303 ``` | |
304 | |
286 ### `pub_serve` | 305 ### `pub_serve` |
287 | 306 |
288 This field indicates that the test runner should run against a `pub serve` | 307 This field indicates that the test runner should run against a `pub serve` |
289 instance by default, and provides the port number for that instance. Note that | 308 instance by default, and provides the port number for that instance. Note that |
290 if there is no `pub serve` instance running at that port, running the tests will | 309 if there is no `pub serve` instance running at that port, running the tests will |
291 fail by default. | 310 fail by default. |
292 | 311 |
293 ```yaml | 312 ```yaml |
294 pub_serve: 8081 | 313 pub_serve: 8081 |
295 ``` | 314 ``` |
(...skipping 207 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
503 presets: | 522 presets: |
504 # Shortcut for running only browser tests. | 523 # Shortcut for running only browser tests. |
505 browser: | 524 browser: |
506 paths: [test/runner/browser] | 525 paths: [test/runner/browser] |
507 | 526 |
508 # Shortcut for running only Chrome tests. | 527 # Shortcut for running only Chrome tests. |
509 chrome: | 528 chrome: |
510 filename: "chrome_*_test.dart" | 529 filename: "chrome_*_test.dart" |
511 add_presets: [browser] | 530 add_presets: [browser] |
512 ``` | 531 ``` |
OLD | NEW |