Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(711)

Side by Side Diff: doc/package_config.md

Issue 1801363007: Add pause_after_load to the config file. (Closed) Base URL: git@github.com:dart-lang/test@master
Patch Set: Code review changes Created 4 years, 9 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
« no previous file with comments | « CHANGELOG.md ('k') | lib/src/runner/configuration/load.dart » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
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
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
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
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
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 ```
OLDNEW
« no previous file with comments | « CHANGELOG.md ('k') | lib/src/runner/configuration/load.dart » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698