summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorKlaus Aehlig <klaus.aehlig@huawei.com>2023-04-11 14:49:53 +0200
committerKlaus Aehlig <klaus.aehlig@huawei.com>2023-04-11 15:46:55 +0200
commitc1bd17cf5877f3cc236af12c23286a56d8051b8a (patch)
treee82c08768581850ade45e405c3767182985e5c22 /README.md
parent870efd45868aeed7e0c088bb3edd753bf52a299f (diff)
downloadrules-cc-c1bd17cf5877f3cc236af12c23286a56d8051b8a.tar.gz
["shell/test", "script"]: make TEST_RUN_NUMBER available
If RUNS_PER_TEST is given, inform each individual test action about the run number it is executing. This can be used, e.g., to set random seeds appropriately.
Diffstat (limited to 'README.md')
-rw-r--r--README.md4
1 files changed, 2 insertions, 2 deletions
diff --git a/README.md b/README.md
index d2b7e9a..c991c72 100644
--- a/README.md
+++ b/README.md
@@ -146,12 +146,12 @@ Shell test, given by a test script
| `"keep"` | List of names (relative to the test working directory) of files that the test might generate that should be kept as part of the output. This might be useful for further analysis of the test |
| `"name"` | A name for the test, used in reporting, as well as for staging the test result tree in the runfiles |
| `"deps"` | Any targets that should be staged (with artifacts and runfiles) into the tests working directory |
-| `"test"` | The shell script for the test, launched with sh. An empty directory is created to store any temporary files needed by the test, and it is made available in the environment variable TEST_TMPDIR. The test should not assume write permissions outside the working directory and the TEST_TMPDIR. For convenience, the environment variable TMPDIR is also set to TEST_TMPDIR. |
+| `"test"` | The shell script for the test, launched with sh. An empty directory is created to store any temporary files needed by the test, and it is made available in the environment variable TEST_TMPDIR. The test should not assume write permissions outside the working directory and the TEST_TMPDIR. For convenience, the environment variable TMPDIR is also set to TEST_TMPDIR. If the configuration variable RUNS_PER_TEST is set, the environment variable TEST_RUN_NUMBER will also be set to the number of the attempt, counting from 0. |
| Config variable | Description |
| --------------- | ----------- |
| `"RUNS_PER_TEST"` | The number of times the test should be run in order to detect flakyness. If set, no test action will be taken from cache. |
-| `"TEST_ENV"` | The environment for executing the test runner. |
+| `"TEST_ENV"` | Additional environment for executing the test runner. |
### Rule `["CC/foreign/cmake", "library"]`