OptionsOn robot itself
-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
Parse only files with this extension when executing a directory <extension>
-N--name
Set a name of the top level suite <name>
-D--doc
Set a documentation of the top level suite
-M--metadata
Set metadata of the top level suite <name:value>
-G--settag
Sets given tag to all executed tests <tag>
-t--test
Select tests by name or by long name containing also parent suite name like `Parent.Test` <name>
--task
Alias to --test. Especially applicable with --rpa <name>
-s--suite
Select suites by name <name>
-i--include
Select test cases by tag <tag>
-e--exclude
Select test cases not to run by tag <tag>
-R--rerunfailed
Select failed tests from an earlier output file to be re-executed <output file>
-S--rerunfailedsuites
Select failed suites from an earlier output file to be re-executed <output file>
--runemptysuite
Executes suite even if it contains no tests
--skip
Tests having given tag will be skipped <tag>
--skiponfailure
Tests having given tag will be skipped if they fail <tag>
-v--variable
Set variables in the test data <variable>
-V--variablefile
Python or YAML file file to read variables from <file>
-d--outputdir
Where to create output files. The default is the directory where tests are run from <directory>
-o--output
XML output file relative to --outputdir unless given as an absolute path. Default: output.xml <file>
-l--log
HTML log file. Can be disabled by giving a special value `NONE`. Default: log.html <file>
-r--report
HTML report file. Can be disabled with `NONE` similarly as --log. Default: report.html <file>
-x--xunit
XUnit compatible result file. Not created unless this option is specified <file>
-b--debugfile
Debug file written during execution. Not created unless this option is specified <file>
-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
Title for the generated log file. The default title is `<SuiteName> Log.` <title>
--reporttitle
Title for the generated report file. The default title is `<SuiteName> Report` <title>
--reportbackground
Background colors to use in the report file. Given in format `passed:failed:skipped` where the `:skipped` part can be omitted <colors>
--maxerrorlines
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 <lines>
--maxassignlength
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 <characters>
-L--loglevel
Threshold level for logging <level>
--suitestatlevel
How many levels to show in `Statistics by Suite` in log and report <level>
--tagstatinclude
Include only matching tags in `Statistics by Tag` in log and report <tag>
--tagstatexclude
Exclude matching tags from `Statistics by Tag` <tag>
--tagstatcombine
Create combined statistics based on tags. These statistics are added into `Statistics by Tag` <tags:name>
--tagdoc
Add documentation to tags matching the given pattern <pattern:doc>
--tagstatlink
Add external links into `Statistics by Tag`. Pattern can use `*`, `?` and `[]` as wildcards <pattern:link:title>
--expandkeywords
Matching keywords will be automatically expanded in the log file <pattern>
--removekeywords
Remove keyword data from the generated log file <pattern>
--flattenkeywords
Flattens matching keywords in the generated log file <pattern>
--listener
A class for monitoring test execution. Gets notifications e.g. when tests start and end <class>
--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
Randomizes the test execution order <type>
--prerunmodifier
Class to programmatically modify the suite structure before execution <class>
--prerebotmodifier
Class to programmatically modify the result model before creating reports and logs <class>
--console
How to report execution on the console <type>
-.--dotted
Shortcut for `--console dotted`
--quiet
Shortcut for `--console quiet`
-W--consolewidth
Width of the console output. Default is 78 <chars>
-C--consolecolors
Use colors on console output or not <option>
-K--consolemarkers
Show markers on the console when top level keywords in a test case end <option>
-P--pythonpath
Additional locations (directories, ZIPs) where to search libraries and other extensions when they are imported <path>
-A--argumentfile
Text file to read more arguments from. Use special path `STDIN` to read contents from the standard input stream <path>
--version
Print version information
