@@ -4,7 +4,7 @@ Post-processing outputs
4
4
=======================
5
5
6
6
`XML output files `_ that are generated during the test execution can be
7
- post-processed afterwards by the `` rebot `` tool, which is an integral
7
+ post-processed afterwards by the Rebot tool, which is an integral
8
8
part of Robot Framework. It is used automatically when test
9
9
reports and logs are generated during the test execution, and using it
10
10
separately allows creating custom reports and logs as well as combining
@@ -14,8 +14,8 @@ and merging results.
14
14
:depth: 2
15
15
:local:
16
16
17
- Using `` rebot `` tool
18
- --------------------
17
+ Using Rebot
18
+ -----------
19
19
20
20
Synopsis
21
21
~~~~~~~~
@@ -37,22 +37,22 @@ any interpreter, or use the `standalone JAR distribution`_.
37
37
Specifying options and arguments
38
38
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
39
39
40
- The basic syntax for using `` rebot `` is exactly the same as when
40
+ The basic syntax for using Rebot is exactly the same as when
41
41
`starting test execution `_ and also most of the command line options are
42
- identical. The main difference is that arguments to `` rebot `` are
42
+ identical. The main difference is that arguments to Rebot are
43
43
`XML output files `_ instead of test data files or directories.
44
44
45
- Return codes with `` rebot ``
46
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~
45
+ Return codes with Rebot
46
+ ~~~~~~~~~~~~~~~~~~~~~~~
47
47
48
- Return codes from `` rebot `` are exactly same as when `running tests `__.
48
+ Return codes from Rebot are exactly same as when `running tests `__.
49
49
50
50
__ `Return codes `_
51
51
52
52
Creating different reports and logs
53
53
-----------------------------------
54
54
55
- You can use `` rebot `` for creating the same reports and logs that
55
+ You can use Rebot for creating the same reports and logs that
56
56
are created automatically during the test execution. Of course, it is
57
57
not sensible to create the exactly same files, but, for example,
58
58
having one report with all test cases and another with only some
@@ -69,12 +69,12 @@ for example, be executed on different environments, output files collected
69
69
to a central place, and reports and logs created there. This approach can
70
70
also work very well if generating reports and logs takes a lot of time when
71
71
running tests on Jython. Disabling log and report generation and generating
72
- them later with `` rebot `` can save a lot of time and use less memory.
72
+ them later with Rebot can save a lot of time and use less memory.
73
73
74
74
Combining outputs
75
75
-----------------
76
76
77
- An important feature in `` rebot `` is its ability to combine
77
+ An important feature in Rebot is its ability to combine
78
78
outputs from different test execution rounds. This capability allows,
79
79
for example, running the same test cases on different environments and
80
80
generating an overall report from all outputs. Combining outputs is
@@ -105,7 +105,7 @@ If same tests are re-executed or a single test suite executed in pieces,
105
105
combining results like discussed above creates an unnecessary top-level
106
106
test suite. In these cases it is typically better to merge results instead.
107
107
Merging is done by using :option: `--merge ` option which changes the way how
108
- `` rebot `` combines two or more output files. This option itself takes no
108
+ Rebot combines two or more output files. This option itself takes no
109
109
arguments and all other command line options can be used with it normally::
110
110
111
111
rebot --merge --name Example --critical regression original.xml merged.xml
@@ -126,7 +126,7 @@ Combining re-execution results with the original results using the default
126
126
`combining outputs `_ approach does not work too well. The main problem is
127
127
that you get separate test suites and possibly already fixed failures are
128
128
also shown. In this situation it is better to use :option: `--merge (-R) `
129
- option to tell `` rebot `` to merge the results instead. In practice this
129
+ option to tell Rebot to merge the results instead. In practice this
130
130
means that tests from the latter test runs replace tests in the original.
131
131
The usage is best illustrated by a practical example using
132
132
:option: `--rerunfailed ` and :option: `--merge ` together::
0 commit comments