-h,-?,--help | Print usage instructions |
--rpa | Turn on the generic automation mode. Mainly affects terminology so that "test" is replaced with "task" in logs and reports |
-F,--extension <command> | Parse only files with this extension when executing a directory |
-N,--name <command> | Set a name of the top level suite |
-D,--doc | Set a documentation of the top level suite |
-M,--metadata <command> | Set metadata of the top level suite |
-G,--settag <command> | Sets given tag to all executed tests |
-t,--test <command> | Select tests by name or by long name containing also parent suite name like `Parent.Test` |
--task <command> | Alias to --test. Especially applicable with --rpa |
-s,--suite <command> | Select suites by name |
-i,--include <command> | Select test cases by tag |
-e,--exclude <command> | Select test cases not to run by tag |
-R,--rerunfailed <command> | Select failed tests from an earlier output file to be re-executed |
-S,--rerunfailedsuites <command> | Select failed suites from an earlier output file to be re-executed |
--runemptysuite | Executes suite even if it contains no tests |
--skip <command> | Tests having given tag will be skipped |
--skiponfailure <command> | Tests having given tag will be skipped if they fail |
-v,--variable <command> | Set variables in the test data |
-V,--variablefile <command> | Python or YAML file file to read variables from |
-d,--outputdir <command> | Where to create output files. The default is the directory where tests are run from |
-o,--output <command> | XML output file relative to --outputdir unless given as an absolute path. Default: output.xml |
-l,--log <command> | HTML log file. Can be disabled by giving a special value `NONE`. Default: log.html |
-r,--report <command> | HTML report file. Can be disabled with `NONE` similarly as --log. Default: report.html |
-x,--xunit <command> | XUnit compatible result file. Not created unless this option is specified |
-b,--debugfile <command> | Debug file written during execution. Not created unless this option is specified |
-T,--timestampoutputs | Adds timestamp in a format `YYYYMMDD-hhmmss` to all generated output files between their basename and extension |
--splitlog | Split the log file into smaller pieces that open in browsers transparently |
--logtitle <command> | Title for the generated log file. The default title is `<SuiteName> Log.` |
--reporttitle <command> | Title for the generated report file. The default title is `<SuiteName> Report` |
--reportbackground <command> | Background colors to use in the report file. Given in format `passed:failed:skipped` where the `:skipped` part can be omitted |
--maxerrorlines <command> | Maximum number of error message lines to show in report when tests fail. Default is 40, minimum is 10 and `NONE` can be used to show the full message |
--maxassignlength <command> | Maximum number of characters to show in log when variables are assigned. Zero or negative values can be used to avoid showing assigned values at all. Default is 200 |
-L,--loglevel <command> | Threshold level for logging |
--suitestatlevel <command> | How many levels to show in `Statistics by Suite` in log and report |
--tagstatinclude <command> | Include only matching tags in `Statistics by Tag` in log and report |
--tagstatexclude <command> | Exclude matching tags from `Statistics by Tag` |
--tagstatcombine <command> | Create combined statistics based on tags. These statistics are added into `Statistics by Tag` |
--tagdoc <command> | Add documentation to tags matching the given pattern |
--tagstatlink <command> | Add external links into `Statistics by Tag`. Pattern can use `*`, `?` and `[]` as wildcards |
--expandkeywords <command> | Matching keywords will be automatically expanded in the log file |
--removekeywords <command> | Remove keyword data from the generated log file |
--flattenkeywords <command> | Flattens matching keywords in the generated log file |
--listener <command> | A class for monitoring test execution. Gets notifications e.g. when tests start and end |
--nostatusrc | Sets the return code to zero regardless of failures in test cases. Error codes are returned normally |
--dryrun | Sets the return code to zero regardless of failures in test cases. Error codes are returned normally |
-X,--exitonfailure | Stops test execution if any test fails |
--exitonerror | Stops test execution if any error occurs when parsing test data, importing libraries, and so on |
--skipteardownonexit | Causes teardowns to be skipped if test execution is stopped prematurely |
--randomize <command> | Randomizes the test execution order |
--prerunmodifier <command> | Class to programmatically modify the suite structure before execution |
--prerebotmodifier <command> | Class to programmatically modify the result model before creating reports and logs |
--console <command> | How to report execution on the console |
-.,--dotted | Shortcut for `--console dotted` |
--quiet | Shortcut for `--console quiet` |
-W,--consolewidth <command> | Width of the console output. Default is 78 |
-C,--consolecolors <command> | Use colors on console output or not |
-K,--consolemarkers <command> | Show markers on the console when top level keywords in a test case end |
-P,--pythonpath <command> | Additional locations (directories, ZIPs) where to search libraries and other extensions when they are imported |
-A,--argumentfile <command> | Text file to read more arguments from. Use special path `STDIN` to read contents from the standard input stream |
--version | Print version information |