Skip to content

Commit 5682058

Browse files
authored
#118: Updated documentation prior 1.5.2 version release (#122)
1 parent a90d682 commit 5682058

File tree

1 file changed

+19
-8
lines changed

1 file changed

+19
-8
lines changed

README.md

+19-8
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@ Serenity integration with Report Portal
88
Module allows to report Serenity powered tests to [reportportal.io](http://reportportal.io) server. Adds additional reporting to Serenity based test automation frameworks.
99

1010
> **Warning**
11+
>
1112
> Make sure used integration version corresponds to documentation.
1213
1314
By default `development` branch documentation is selected and it may contains unreleased features description.
@@ -27,7 +28,8 @@ Table of Contents
2728
1. [Presets](#presets)
2829
2. [Log units](#log-units)
2930
3. [Merge launches](#merge-launches)
30-
4. [Other settings](#other-settings)
31+
4. [Test retries](#test-retries)
32+
5. [Other settings](#other-settings)
3133
3. [Data mapping](#data-mapping)
3234
4. [Versioning](#versioning)
3335
5. [Important release notes](#important-release-notes)
@@ -38,6 +40,7 @@ Table of Contents
3840
To add support of integration between Serenity and Report Portal simply add dependencies to your project based on used build tool.
3941

4042
> **Warning**
43+
>
4144
> Don't add any extra Report Portal listeners or agents. Integration is provided by single module for all available Serenity approaches
4245
4346
#### Maven
@@ -47,7 +50,7 @@ Edit project's `pom.xml` file
4750
<dependency>
4851
<groupId>com.github.invictum</groupId>
4952
<artifactId>serenity-reportportal-integration</artifactId>
50-
<version>1.5.1</version>
53+
<version>1.5.2</version>
5154
</dependency>
5255
```
5356
Report Portal core libraries are used, but they placed in a separate repository, so its URL also should be added to your build configuration
@@ -71,7 +74,7 @@ Report Portal core libraries are used, but they placed in a separate repository,
7174

7275
Edit your project `build.gradle` file
7376
```
74-
compile: 'com.github.invictum:serenity-reportportal-integration:1.5.1'
77+
compile: 'com.github.invictum:serenity-reportportal-integration:1.5.2'
7578
```
7679
External Report Portal repository should be defined as the same as for Maven
7780
```
@@ -99,7 +102,8 @@ Sometimes it is necessary to use integration version that isn't released yet, bu
99102
To enable snapshots, extra configuration is required depending of build tool used.
100103

101104
> **Warning**
102-
Snapshots may have issues and are not intended to be used in production.
105+
>
106+
> Snapshots may have issues and are not intended to be used in production.
103107
104108
**Maven**
105109

@@ -155,7 +159,8 @@ configuration.usePreset(LogsPreset.FULL);
155159
```
156160

157161
> **Notice**
158-
All integration configurations should be done before the start of Serenity facility. Otherwise default values will be used.
162+
>
163+
> All integration configurations should be done before the start of Serenity facility. Otherwise default values will be used.
159164
160165
#### Presets
161166

@@ -226,6 +231,7 @@ ReportIntegrationConfig.get().usePreset(preset);
226231
```
227232

228233
> **Warning**
234+
>
229235
> To emit log to Report Portal proper time should be specified. If log timestamp is out of range of active test it won't be emitted at all. `TestStep` object contains all the data required to determinate start, end and duration
230236
231237
Provided collection of `SaveLogRQ` will be used to push logs to to Report Portal and their order will be based on timestamp.
@@ -250,9 +256,11 @@ To merge all launches that relates to submodules two options should be specified
250256
Absolute paths are supported as well as relevant. So `/opt/sync` and `../sync` directories are valid. If supplied directory is absent it will be created automatically. Specified path must be writable.
251257

252258
> **Caution**
259+
>
253260
> Don't specify existing directories with data, because at the end of execution mentioned directory will be removed with all files inside it
254261
255262
> **Warning**
263+
>
256264
> If relevant path is specified target directory should be the same for all submodules, otherwise merge feature will fail
257265
- `serenity.rp.modules.count` total quantity of modules with tests
258266
Value should be positive integer more that 1. So minimal modules quantity to activate feature is 2
@@ -266,9 +274,12 @@ With merge feature activation each submodule still produce separate launch on ex
266274

267275
#### Test retries
268276

269-
Report portal have the feature to show [test retries](https://github.com/reportportal/documentation/blob/master/src/md/src/DevGuides/retries.md).
270-
Serenity RP client will report all retries automatically if you are use maven with *failsafe/surefire* plugin, *junit4* and add `failsafe.rerunFailingTestsCount` or `surefire.rerunFailingTestsCount` property to your test execution.
271-
The feature work 100% only with this configuration.
277+
Report Portal has a feature to show [test retries](https://github.com/reportportal/documentation/blob/master/src/md/src/DevGuides/retries.md).
278+
Serenity RP client will report all retries automatically if you are use maven with *failsafe/surefire* plugin, *junit4* and add `failsafe.rerunFailingTestsCount` or `surefire.rerunFailingTestsCount` property to your test execution.
279+
280+
> **Notice**
281+
>
282+
> Consider using RP rerun options if you don't use maven as a build tool. Check [documentation](https://github.com/reportportal/documentation/blob/master/src/md/src/DevGuides/rerun.md) for more details.
272283
273284
#### Other settings
274285

0 commit comments

Comments
 (0)