| Index: doc/package_config.md
|
| diff --git a/doc/package_config.md b/doc/package_config.md
|
| index 77b075f9e140dd3a00e41e5bded203346e7e5cd0..5f169c503d33828484384d29b3c9e9cd9feec75b 100644
|
| --- a/doc/package_config.md
|
| +++ b/doc/package_config.md
|
| @@ -35,6 +35,8 @@ tags:
|
| * [`filename`](#filename)
|
| * [`names`](#names)
|
| * [`plain_names`](#plain_names)
|
| + * [`include_tags`](#include_tags)
|
| + * [`exclude_tags`](#exclude_tags)
|
| * [`platforms`](#platforms)
|
| * [`concurrency`](#concurrency)
|
| * [`pub_serve`](#pub_serve)
|
| @@ -185,8 +187,8 @@ filename: "test_*.dart"
|
|
|
| ### `names`
|
|
|
| -This field restricts the tests run by the runner to those whose names match the
|
| -given regular expressions. A test's name must match *all* regular expressions in
|
| +This field causes the runner to only run tests whose names match the given
|
| +regular expressions. A test's name must match *all* regular expressions in
|
| `names`, as well as containing all strings in [`plain_names`](#plain_names), in
|
| order to be run.
|
|
|
| @@ -204,10 +206,9 @@ presets:
|
|
|
| ### `plain_names`
|
|
|
| -This field restricts the tests run by the runner to those whose names contain
|
| -the given strings. A test's name must contain *all* strings in `plain_names`, as
|
| -well as matching all regular expressions in [`names`](#names), in order to be
|
| -run.
|
| +This field causes the runner to only run tests whose names contain the given
|
| +strings. A test's name must contain *all* strings in `plain_names`, as well as
|
| +matching all regular expressions in [`names`](#names), in order to be run.
|
|
|
| This is usually used in a [preset](#configuration-presets) to make it possible
|
| to quickly select a given set of tests.
|
| @@ -221,6 +222,40 @@ presets:
|
| - "Internet Explorer"
|
| ```
|
|
|
| +### `include_tags`
|
| +
|
| +This field causes the runner to only run tests whose tags match the given
|
| +[boolean selector][]. If both `include_tags` and [`exclude_tags`](#exclude_tags)
|
| +are used, the exclusions take precedence.
|
| +
|
| +[boolean selector]: https://github.com/dart-lang/boolean_selector/blob/master/README.md
|
| +
|
| +This is usually used in a [preset](#configuration-preset) to make it possible to
|
| +quickly select a set of tests.
|
| +
|
| +```yaml
|
| +presets:
|
| + # Pass "-P windowless" to run tests that don't open browser windows.
|
| + windowless:
|
| + include_tags: !browser || content-shell
|
| +```
|
| +
|
| +### `exclude_tags`
|
| +
|
| +This field causes the runner not to run tests whose tags match the given
|
| +[boolean selector][]. If both [`include_tags`](#include_tags) and `exclude_tags`
|
| +are used, the exclusions take precedence.
|
| +
|
| +This is usually used in a [preset](#configuration-preset) to make it possible to
|
| +quickly select a set of tests.
|
| +
|
| +```yaml
|
| +presets:
|
| + # Pass "-P windowless" to run tests that don't open browser windows.
|
| + windowless:
|
| + exclude_tags: browser && !content-shell
|
| +```
|
| +
|
| ### `platforms`
|
|
|
| This field indicates which platforms tests should run on by default. It allows
|
|
|