Read-only mirrors. Development, issues and pull requests are on GitHub.

summaryrefslogtreecommitdiffhomepage
path: root/docs
diff options
context:
space:
mode:
authorMartin Stump2020-09-12 11:12:30 +0200
committerMartin Hořeňovský2020-10-08 11:35:42 +0200
commitc522e88afa04d66004e8d36e3a729fef90e36aaa (patch)
tree1534432d12b7569253e11fab29fdf756aceff181 /docs
parentb1df96e7e491ab56473f869a9f4860a11fccab36 (diff)
downloadcatch3-c522e88afa04d66004e8d36e3a729fef90e36aaa.tar.gz
Add REPORTER and OUTPUT_* args
Diffstat (limited to 'docs')
-rw-r--r--docs/cmake-integration.md30
1 files changed, 30 insertions, 0 deletions
diff --git a/docs/cmake-integration.md b/docs/cmake-integration.md
index 1835a043..952efa8f 100644
--- a/docs/cmake-integration.md
+++ b/docs/cmake-integration.md
@@ -97,6 +97,10 @@ catch_discover_tests(target
[TEST_SUFFIX suffix]
[PROPERTIES name1 value1...]
[TEST_LIST var]
+ [REPORTER reporter]
+ [OUTPUT_DIR dir]
+ [OUTPUT_PREFIX prefix]
+ [OUTPUT_SUFFIX suffix]
)
```
@@ -143,6 +147,32 @@ default `<target>_TESTS`. This can be useful when the same test
executable is being used in multiple calls to `catch_discover_tests()`.
Note that this variable is only available in CTest.
+* `REPORTER reporter`
+
+Use the specified reporter when running the test case. The reporter will
+be passed to the test runner as `--reporter reporter`.
+
+* `OUTPUT_DIR dir`
+
+If specified, the parameter is passed along as
+`--out dir/<test_name>` to test executable. The actual file name is the
+same as the test name. This should be used instead of
+`EXTRA_ARGS --out foo` to avoid race conditions writing the result output
+when using parallel test execution.
+
+* `OUTPUT_PREFIX prefix`
+
+May be used in conjunction with `OUTPUT_DIR`.
+If specified, `prefix` is added to each output file name, like so
+`--out dir/prefix<test_name>`.
+
+* `OUTPUT_SUFFIX suffix`
+
+May be used in conjunction with `OUTPUT_DIR`.
+If specified, `suffix` is added to each output file name, like so
+`--out dir/<test_name>suffix`. This can be used to add a file extension to
+the output file name e.g. ".xml".
+
### `ParseAndAddCatchTests.cmake`