Full name:
org.robotframework:robotframework-maven-plugin:2.1.0:run
Description:
Attributes:
test
.integration-test
.Name | Type | Since | Description |
---|---|---|---|
<argumentFile> |
File |
- |
A text file to read more arguments from. User property is: argumentFile . |
<combinedTagStats> |
List |
- |
Creates combined statistics based on tags. Use the format
"tags:title" |
<console> |
String |
- |
The overall console output type. It supports the following
case-insensitive values. Default is 'verbose'.
Default value is: verbose . |
<consoleColors> |
String |
- |
Using ANSI colors in console. Normally colors work in unixes but
not in Windows. Default is 'on'.
|
<consoleWidth> |
String |
- |
Width of the console output. Default is 78. |
<criticalTags> |
List |
- |
Tests that have the given tags are considered critical. |
<debugFile> |
File |
- |
A debug file that is written during execution. |
<document> |
String |
- |
Sets the documentation of the top-level tests suites. |
<dryrun> |
boolean |
- |
Sets dryrun mode on use. In the dry run mode tests are run without
executing keywords originating from test libraries. Useful for
validating test data syntax. Default value is: false . |
<excludes> |
List |
- |
Selects the tests cases by tags. |
<excludes_cli> |
String |
- |
Selects the tests cases by tags. Given as a comma separated list.
This setting overrides the value for excludes configuration in
pom.xml.
Example: mvn -Dexcludes=foo,bar verify User property is: excludes . |
<exitOnFailure> |
boolean |
- |
Sets robot to stop execution immediately if a critical test fails. Default value is: false . |
<externalRunner> |
ExternalRunnerConfiguration |
- |
Test are executed in a new process if this configuration is used. The classpath for the new process will include by default all the test scope dependencies from the pom.
|
<extraPathDirectories> |
File[] |
- |
Additional locations (directories, ZIPs, JARs) where to search test
libraries from when they are imported. Maps to Jybot's --pythonpath
option. Otherwise if no locations are declared, the default
location is
${project.basedir}/src/test/resources/robotframework/libraries. |
<flattenKeywords> |
List |
- |
Flatten keywords and their messages altogether. Instructions at
http://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html#flattening-keywords.
|
<includes> |
List |
- |
Selects the tests cases by tags. |
<includes_cli> |
String |
- |
Selects the tests cases by tags. Given as a comma separated list.
This setting overrides the value for includes configuration in
pom.xml.
Example: mvn -Dincludes=foo,bar verify User property is: includes . |
<listener> |
String |
- |
Sets a single listener for monitoring tests execution, can also be
set via commandline using -Dlistener=MyListener. User property is: listener . |
<listeners> |
List |
- |
Sets multiple listeners for monitoring tests execution. Use the
format "ListenerWithArgs:arg1:arg2" or simply "ListenerWithoutArgs" |
<log> |
File |
- |
Sets the path to the generated log file. |
<logLevel> |
String |
- |
Sets the threshold level for logging. |
<logTitle> |
String |
- |
Sets a title for the generated tests log. |
<metadata> |
List |
- |
Sets free metadata for the top level tests suites. |
<name> |
String |
- |
Sets the name of the top-level tests suites. |
<noStatusReturnCode> |
boolean |
- |
If true, sets the return code to zero regardless of failures in
test cases. Error codes are returned normally. Default value is: false . |
<nonCriticalTags> |
List |
- |
Tests that have the given tags are not critical. |
<output> |
File |
- |
Sets the path to the generated output file. |
<outputDirectory> |
File |
- |
Configures where generated reports are to be placed. Default value is: ${project.build.directory}/robotframework-reports . |
<randomize> |
String |
- |
Sets the test execution order to be randomized. Valid values are
all, suite, and test |
<removeKeywords> |
List |
- |
Remove keywords and their messages altogether. Instructions at
http://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html#removing-keywords.
|
<report> |
File |
- |
Sets the path to the generated report file. |
<reportBackground> |
String |
- |
Sets background colors for the generated report and summary. |
<reportTitle> |
String |
- |
Sets a title for the generated tests report. |
<rerunFailed> |
boolean |
- |
Run only failed test cases. Note that output.xml has to be
available. By default clean goal would remove output.xml making it
impossible to run failed cases. User property is: rerunfailed . |
<rpa> |
boolean |
- |
Turn on generic automation mode. Default value is: false . |
<runEmptySuite> |
boolean |
- |
Executes tests also if the top level test suite is empty. Useful
e.g. with --include/--exclude when it is not an error that no test
matches the condition. Default value is: false . |
<runMode> |
String |
- |
Sets the execution mode for this tests run. Note that this setting
has been deprecated in Robot Framework 2.8. Use separate dryryn,
skipTeardownOnExit, exitOnFailure, and randomize settings instead. |
<skip> |
boolean |
- |
Skip tests, bound to -Dmaven.test.skip, which suppresses test
compilation as well. Default value is: false .User property is: maven.test.skip . |
<skipATs> |
boolean |
- |
Skip acceptance tests executed by this plugin. Bound to -DskipATs.
This allows to run tests and integration tests, but no acceptance
tests. User property is: skipATs . |
<skipITs> |
boolean |
- |
Skip acceptance tests executed by this plugin together with other
integration tests, e.g. tests run by the maven-failsafe-plugin.
Bound to -DskipITs User property is: skipITs . |
<skipTeardownOnExit> |
boolean |
- |
Sets whether the teardowns are skipped if the test execution is
prematurely stopped. Default value is: false . |
<skipTests> |
boolean |
- |
Skip tests. Bound to -DskipTests. This allows to skip acceptance
tests together with all other tests. User property is: skipTests . |
<skiponfailures> |
List |
- |
Tests having given tag will be skipped if they fail. Tag can be a
pattern. New in RF 4.0. |
<skiponfailures_cli> |
String |
- |
Report test cases as skipped instead of failed by tags. Given as a
comma separated list. This setting overrides the value for
skiponfailures configuration in pom.xml.
Example: mvn -Dskiponfailure=foo,bar verify User property is: skiponfailures . |
<skips> |
List |
- |
Tests having given tag will be skipped. Tag can be a pattern. New
in RF 4.0. |
<skips_cli> |
String |
- |
Skip the tests cases by tags. Given as a comma separated list. This
setting overrides the value for skips configuration in pom.xml.
Example: mvn -Dskips=foo,bar verify User property is: skips . |
<splitOutputs> |
String |
- |
Splits output and log files. |
<suiteStatLevel> |
String |
- |
Defines how many levels to show in the Statistics by Suite table in
outputs. |
<suites> |
List |
- |
Selects the tests suites by name. |
<suites_cli> |
String |
- |
Selects the tests suites by name. Given as a comma separated list.
This setting overrides the value for suites configuration in
pom.xml.
Example: mvn -Dsuites=foo,bar verify User property is: suites . |
<summaryTitle> |
String |
- |
Sets a title for the generated summary report. |
<tagDocs> |
List |
- |
Adds documentation to the specified tags. |
<tagStatExcludes> |
List |
- |
Excludes these tags from the Statistics by Tag and Test Details by
Tag tables in outputs. |
<tagStatIncludes> |
List |
- |
Includes only these tags in the Statistics by Tag and Test Details
by Tag tables in outputs. |
<tagStatLinks> |
List |
- |
Adds external links to the Statistics by Tag table in outputs. Use
the format "pattern:link:title" |
<tags> |
List |
- |
Sets the tags(s) to all executed tests cases. |
<tasks> |
List |
- |
Selects the tasks cases by name. |
<tasks_cli> |
String |
- |
Selects the tasks by name. Given as a comma separated list. This
setting overrides the value for tasks configuration in pom.xml.
Example: mvn -Dtasks=foo,bar verify User property is: tasks . |
<testCasesDirectory> |
File |
- |
The directory where the test cases are located. Default value is: ${project.basedir}/src/test/robotframework/acceptance .User property is: testCasesDirectory . |
<tests> |
List |
- |
Selects the tests cases by name. |
<tests_cli> |
String |
- |
Selects the tests cases by name. Given as a comma separated list.
This setting overrides the value for tests configuration in
pom.xml.
Example: mvn -Dtests=foo,bar verify User property is: tests . |
<timestampOutputs> |
boolean |
- |
Adds a timestamp to all output files. |
<variableFiles> |
List |
- |
Sets variables using variables files. Use the format "path:args" |
<variables> |
List |
- |
Sets individual variables. Use the format "name:value" |
<variables_cli> |
String |
- |
Sets individual variables. Use the format "name:value" and separate
entries with comma. These are added into variables defined in the
pom (variables with same name are overridden). (This setting is
needed to support overriding the configuration value from command
prompt on maven 2.) User property is: variables . |
<warnOnSkippedFiles> |
boolean |
- |
Show a warning when an invalid file is skipped. |
<xunitFile> |
File |
- |
Sets the path to the generated XUnit compatible result file,
relative to outputDirectory. The file is in xml format. By default,
the file name is derived from the testCasesDirectory parameter,
replacing blanks in the directory name by underscores. |
java.io.File
No
argumentFile
java.util.List
No
java.lang.String
No
verbose
java.lang.String
No
java.lang.String
No
java.util.List
No
java.io.File
No
java.lang.String
No
boolean
No
false
java.util.List
No
Example:
mvn -Dexcludes=foo,bar verify
java.lang.String
No
excludes
boolean
No
false
Test are executed in a new process if this configuration is used.
The classpath for the new process will include by default all the test scope dependencies from the pom.
<externalRunner>
<environmentVariables>
<foo>bar</foo>
<CLASSPATH>this-should-be-seen-by-external-process.jar</CLASSPATH>
</environmentVariables>
<jvmArgs>
<jvmArg>-XX:PermSize=128m</jvmArg>
<jvmArg>-XX:MaxPermSize=256m</jvmArg>
<jvmArg>-Xmx512m</jvmArg>
</jvmArgs>
<excludeDependencies>true</excludeDependencies>
<runnerClass>org.robotframework.RobotFramework</runnerClass>
<runWithPython>false</runWithPython>
</externalRunner>
org.robotframework.mavenplugin.ExternalRunnerConfiguration
No
java.io.File[]
No
java.util.List
No
java.util.List
No
Example:
mvn -Dincludes=foo,bar verify
java.lang.String
No
includes
java.lang.String
No
listener
java.util.List
No
java.io.File
No
java.lang.String
No
java.lang.String
No
java.util.List
No
java.lang.String
No
boolean
No
false
java.util.List
No
java.io.File
No
java.io.File
No
${project.build.directory}/robotframework-reports
java.lang.String
No
java.util.List
No
java.io.File
No
java.lang.String
No
java.lang.String
No
boolean
No
rerunfailed
boolean
No
false
boolean
No
false
java.lang.String
No
boolean
No
maven.test.skip
false
boolean
No
skipATs
boolean
No
skipITs
boolean
No
false
boolean
No
skipTests
java.util.List
No
Example:
mvn -Dskiponfailure=foo,bar verify
java.lang.String
No
skiponfailures
java.util.List
No
Example:
mvn -Dskips=foo,bar verify
java.lang.String
No
skips
java.lang.String
No
java.lang.String
No
java.util.List
No
Example:
mvn -Dsuites=foo,bar verify
java.lang.String
No
suites
java.lang.String
No
java.util.List
No
java.util.List
No
java.util.List
No
java.util.List
No
java.util.List
No
java.util.List
No
Example:
mvn -Dtasks=foo,bar verify
java.lang.String
No
tasks
java.io.File
No
testCasesDirectory
${project.basedir}/src/test/robotframework/acceptance
java.util.List
No
Example:
mvn -Dtests=foo,bar verify
java.lang.String
No
tests
boolean
No
java.util.List
No
java.util.List
No
java.lang.String
No
variables
boolean
No
java.io.File
No