Skip to content

Commit

Permalink
Adding missed JVM arguments
Browse files Browse the repository at this point in the history
  • Loading branch information
krmahadevan committed Feb 16, 2024
1 parent 5811459 commit 523c6d4
Show file tree
Hide file tree
Showing 3 changed files with 23 additions and 14 deletions.
2 changes: 1 addition & 1 deletion src/main/asciidoc/docs/parameters.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -258,7 +258,7 @@ If you want to run a few specific data providers in a different thread pool, you

TestNG allows you to retry a data provider incase it has encountered any issues when calling it the first time.

This is similar to how regular test methods can be retried as explained in xref:_rerunning_failed_tests[this section].
This is similar to how regular test methods can be retried as explained in xref:rerunning_failed_tests.adoc#_rerunning_failed_tests[this section].

To be able to retry a data provider, the following needs to be done.

Expand Down
5 changes: 3 additions & 2 deletions src/main/asciidoc/docs/rerunning_failed_tests.adoc
Original file line number Diff line number Diff line change
@@ -1,8 +1,9 @@
[#_rerunning_failed_tests]
=== Rerunning failed tests
Every time tests fail in a suite, TestNG creates a file called `testng-failed.xml` in the output directory. This XML file contains the necessary information to rerun only these methods that failed, allowing you to quickly reproduce the failures without having to run the entirety of your tests. Therefore, a typical session would look like this:
Every time tests fail in a suite, TestNG creates a file called `testng-failed.xml` in the output directory.This XML file contains the necessary information to rerun only these methods that failed, allowing you to quickly reproduce the failures without having to run the entirety of your tests.Therefore, a typical session would look like this:
[source, bash]
[source,bash]
----
java -classpath testng.jar;%CLASSPATH% org.testng.TestNG -d test-outputs testng.xml
Expand Down
30 changes: 19 additions & 11 deletions src/main/asciidoc/documentation.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -59,61 +59,69 @@ You can enable dry run mode for TestNG by passing the JVM argument `-Dtestng.mod
|===
|JVM Argument |Comment |Default value

|`testng.ignore.callback.skip`
| A boolean indicating if TestNG should treat forgetting to call `org.testng.IHookable.run` (or) `org.testng.IConfigurable.run` despite it being defined in the code as a test/configuration failure.
|`false`

|`testng.preferential.listeners.package`
| A comma separated list of packages that represent special listeners which users will expect to be executed after executing the regular listeners. Here special listeners can be anything that a user feels should be executed *ALWAYS* at the end.
| `com.intellij.rt.*`

|`testng.favor.custom.thread-pool.executor`
|A Boolean indicating whether TestNG should resort to going back to using the custom implementation for managing Thread pools. If this flag is enabled, then thread pool sharing between data driven tests and thread pool sharing between regular and data driven tests WILL NOT work properly.
|false
| `false`

|`testng.thread.affinity`
|A Boolean indicating whether TestNG should resort to running dependent methods on the same thread as the upstream methods.
|false
| `false`

|`testng.mode.dryrun`
|A Boolean indicating whether TestNG should simulate a real execution. In this mode the test methods are not actually executed.
|false
| `false`

|`testng.test.classpath`
|A String that represents a list of zip files or jars that need to be added to the TestNG classpath for it to retrieve test classes for execution.
|`""`

|`skip.caller.clsLoader`
|A Boolean indicating whether TestNG should skip using the current ClassLoader for loading classes.
|false
| `false`

|`testng.dtd.http`
|A Boolean indicating whether TestNG should load DTDs from http endpoints.
|false
| `false`

|`testng.show.stack.frames`
|A Boolean indicating whether TestNG should show detailed stack traces in reports.
|false
| `false`

|`testng.memory.friendly`
|A Boolean indicating whether TestNG should be memory cognizant and use lightweight test method representations.
|false
| `false`

|`testng.strict.parallel`
|A Boolean indicating that TestNG should attempt to start all test methods simultaneously when there are more than one test tags and parallelism has been set to methods.
|false
| `false`

|`emailable.report2.name`
|A String indicating the file name into which the emailable reports are to be written into.
|`emailable-report.html`

|`oldTestngEmailableReporter`
|A Boolean indicating whether TestNG should use the old emailable report listener for building simple html emailable report.
|false
| `false`

|`noEmailableReporter`
|A Boolean indicating whether TestNG should use the NEW emailable report listener for building simple html emailable report.
|true
| `true`

|`testng.report.xml.name`
|A String indicating the file name into which the xml reports are to be written into.
|`testng-results.xml`

|`fileStringBuffer`
|A Boolean indicating whether TestNG should output verbose logs when working with very large text data.
|false
| `false`

|`stacktrace.success.output.level`
a|
Expand Down

0 comments on commit 523c6d4

Please sign in to comment.