summaryrefslogtreecommitdiff
path: root/docs/markdown/Unit-tests.md
diff options
context:
space:
mode:
authorCharles Brunet <charles.brunet@optelgroup.com>2023-04-03 09:46:26 -0400
committerEli Schwartz <eschwartz93@gmail.com>2023-05-25 13:44:13 -0400
commite7b9dfac98d30eb4ea5489c10b8dfef3bb8331f4 (patch)
treec1cba20c81e41f60d564a50ffa13bde7012ace54 /docs/markdown/Unit-tests.md
parent11521c6db7facf0703a6037948fdcc1f69cd6246 (diff)
downloadmeson-e7b9dfac98d30eb4ea5489c10b8dfef3bb8331f4.tar.gz
mtest: wildcard selection
Allow the use of wildcards (e.g. *) to match test names in `meson test`. Raise an error is given test name does not match any test. Optimize the search by looping through the list of tests only once.
Diffstat (limited to 'docs/markdown/Unit-tests.md')
-rw-r--r--docs/markdown/Unit-tests.md21
1 files changed, 21 insertions, 0 deletions
diff --git a/docs/markdown/Unit-tests.md b/docs/markdown/Unit-tests.md
index 36fbdcfc1..18ab11165 100644
--- a/docs/markdown/Unit-tests.md
+++ b/docs/markdown/Unit-tests.md
@@ -153,6 +153,27 @@ Specify test(s) by name like:
$ meson test A D
```
+You can run tests from specific (sub)project:
+
+```console
+$ meson test (sub)project_name:
+```
+
+or a specific test in a specific project:
+
+```console
+$ meson test (sub)project_name:test_name
+```
+
+Since version *1.2.0*, you can use wildcards in project
+and test names. For instance, to run all tests beginning with
+"foo" and all tests from projects beginning with "bar":
+
+```console
+$ meson test "foo*" "bar*:"
+```
+
+
Tests belonging to a suite `suite` can be run as follows
```console