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

Unified Diff: doc/package_config.md

Issue 1802133002: Add names and plain_names 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.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 07c4eca04ac43d56d69dd49734d2da6b4112eff7..77b075f9e140dd3a00e41e5bded203346e7e5cd0 100644
--- a/doc/package_config.md
+++ b/doc/package_config.md
@@ -33,6 +33,8 @@ tags:
* [Runner Configuration](#runner-configuration)
* [`paths`](#paths)
* [`filename`](#filename)
+ * [`names`](#names)
+ * [`plain_names`](#plain_names)
* [`platforms`](#platforms)
* [`concurrency`](#concurrency)
* [`pub_serve`](#pub_serve)
@@ -181,6 +183,44 @@ filename: "test_*.dart"
[glob syntax]: https://github.com/dart-lang/glob#syntax
+### `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
+`names`, as well as containing all strings in [`plain_names`](#plain_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.
+
+```yaml
+presets:
+ # Pass "-P chrome" to run only Chrome tests.
+ chrome:
+ names:
+ - "^browser:"
+ - "[Cc]hrome"
+```
+
+### `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 is usually used in a [preset](#configuration-presets) to make it possible
+to quickly select a given set of tests.
+
+```yaml
+presets:
+ # Pass "-P ie" to run only Internet Explorer tests.
+ ie:
+ plain_names:
+ - "IE"
+ - "Internet Explorer"
+```
+
### `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.dart » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698