aboutsummaryrefslogtreecommitdiff
path: root/docs/yaml/functions/test.yaml
diff options
context:
space:
mode:
authorPaolo Bonzini <pbonzini@redhat.com>2022-01-15 23:36:42 +0100
committerPaolo Bonzini <pbonzini@redhat.com>2022-02-01 09:05:26 +0100
commitfc661c35a20a7cc85f76e5e0c502700f42e27cf2 (patch)
tree55fdc3213419420b3fa7c9c2480f6819d377cc6e /docs/yaml/functions/test.yaml
parent3f3439522c66de4620f36f804bdf16c5d0dc9ce1 (diff)
downloadmeson-fc661c35a20a7cc85f76e5e0c502700f42e27cf2.zip
meson-fc661c35a20a7cc85f76e5e0c502700f42e27cf2.tar.gz
meson-fc661c35a20a7cc85f76e5e0c502700f42e27cf2.tar.bz2
interpreter: support for forcibly verbose logging of some tests
Add a new keyword argument to test() and benchmark(), completing the implementation of the feature. Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
Diffstat (limited to 'docs/yaml/functions/test.yaml')
-rw-r--r--docs/yaml/functions/test.yaml7
1 files changed, 7 insertions, 0 deletions
diff --git a/docs/yaml/functions/test.yaml b/docs/yaml/functions/test.yaml
index 96a2b28..bc9ad03 100644
--- a/docs/yaml/functions/test.yaml
+++ b/docs/yaml/functions/test.yaml
@@ -33,6 +33,13 @@ description: |
test(..., env: nomalloc, ...)
```
+ In addition to running individual executables as test cases, `test()`
+ can also be used to invoke an external test harness. In this case,
+ it is best to use `verbose: true` *(since 0.62.0)* and, if supported
+ by the external harness, `protocol: 'tap'` *(since 0.50.0)*. This will
+ ensure that Meson logs each subtest as it runs, instead of including
+ the whole log at the end of the run.
+
Defined tests can be run in a backend-agnostic way by calling
`meson test` inside the build dir, or by using backend-specific
commands, such as `ninja test` or `msbuild RUN_TESTS.vcxproj`.