Skip to content

Commit 09812e8

Browse files
authored
Update runner.py switches: filename and iterations (#116)
1 parent d5fbed5 commit 09812e8

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

content/en/docs/measuring/runner-switches.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,10 @@ Apart from the `config.yml` some additional configuration is possible when manua
1414
+ If given a local directory starting with `/`, this will be used instead.
1515
- `--branch` When providing a git repository, optionally specify a branch
1616
- `--filename` An optional alternative filename if you do not want to use "usage_scenario.yml"
17+
+ Multiple filenames can be provided, e.g. `--filename A.yml --filename B.yml` (both scenarios are executed sequencially)
18+
* Duplicated filenames are allowed (if you want to repeat the same file(s) multiple times, consider using `--iterations`)
19+
+ Relative paths are supported, e.g. "../usage_scenario.yml"
20+
+ Wildcard characters '\*' and '?' are supported, e.g. "*.yml" (all yml files in the current directory are executed sequencially)
1721
- `--variables` A list of string key-value pairs with variables to be replaced in the [usage_scenario.yml →]({{< relref "usage-scenario" >}})
1822
+ e.g.: `--variables '__GMT_VAR_MY_VALUE_=cats are cool'`
1923
- `--commit-hash-folder` Use a different folder than the repository root to determine the commit hash for the run
@@ -49,6 +53,9 @@ Apart from the `config.yml` some additional configuration is possible when manua
4953
- `--dev-no-optimizations` Disables the creation of potential optimization recommendations based on the measurement run.
5054
- `--print-phase-stats PHASE_NAME` Prints the stats of the given phase to the CLI. Typical argument would be "\[RUNTIME\]" to see all runtime phases combined
5155
- `--print-logs` Prints the container and process logs to stdout
56+
- `--iterations` Specify how many times each scenario should be executed (Default: 1)
57+
+ With multiple files (see `--filename`), all files are processed sequentially, then the entire sequence is repeated N times
58+
* Example: with files A.yml, B.yml and `--iterations 2`, the execution order is A, B, A, B.
5259

5360
These options are not available when doing cron runs.
5461

0 commit comments

Comments
 (0)