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

Unified Diff: doc/package_config.md

Issue 1797113002: Add include_tags and exclude_tags config fields. (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 side-by-side diff with in-line comments
Download patch
« no previous file with comments | « CHANGELOG.md ('k') | lib/src/runner/configuration/load.dart » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
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
« 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