for-each-match¶
Run a command for each of the given matches.
The matches can be specified as a comma-separated list and/or dash-separated ranges. The commands will be run in the numeric order of matches (rather than the given order) and only once per match.
Where a compstate has multiple arenas the command will be run for each arena, in the order the arenas are defined within the compstate. Alternatively a specific arena can be specified to limit the commands to matches in that arena.
A number of placeholders are available for use in your command, so you can control how information about each match is passed to the command. The TLAS placeholder will always include enough entries for every zone in the arena, using ‘-’ to represent an empty zone.
usage: srcomp for-each-match [-h] [--arena ARENA]
compstate matches command [command ...]
Positional Arguments¶
- compstate
competition state repository
- matches
List of matches or match ranges, for example ‘1,3-5’.
- command
Command to run. Supports the following placeholders: ARENA, NUMBER, TLAS, TYPE. Placeholders spelled like {THIS} will be replaced as strings anywhere within the command arguments. Placeholders which are an argument on their own and spelled exactly as @THIS will expand to one or more replacement arguments when the command is run.
Named Arguments¶
- --arena
Limit to just one arena. By default the command is run for each arena in turn.