Table of Contents
| API Documentation: | TestLoggingContainer |
|---|
Container for all test logging related options. Different options can be set for each log level. Options that are set directly (without specifying a log level) apply to log level LIFECYCLE. Example:
apply plugin: 'java' test { testLogging { // set options for log level LIFECYCLE events "failed" exceptionFormat "short" // set options for log level DEBUG debug { events "started", "skipped", "failed" exceptionFormat "full" } // remove standard output/error logging from --info builds // by assigning only 'failed' and 'skipped' events info.events = ["failed", "skipped"] } }
The defaults that are in place show progressively more information on log levels WARN, LIFECYCLE, INFO, and DEBUG, respectively.
| Property | Description |
debug | Returns logging options for debug level. |
displayGranularity | The display granularity of the events to be logged. For example, if set to 0, a method-level event will be displayed as "Test Run > Test Worker x > org.SomeClass > org.someMethod". If set to 2, the same event will be displayed as "org.someClass > org.someMethod". |
error | Returns logging options for error level. |
events | The events to be logged. |
exceptionFormat | The format to be used for logging test exceptions. Only relevant if |
info | Gets logging options for info level. |
lifecycle | Returns logging options for lifecycle level. |
maxGranularity | The maximum granularity of the events to be logged. Typically, 0 corresponds to the Gradle-generated test suite for the whole test run, 1 corresponds to the Gradle-generated test suite for a particular test JVM, 2 corresponds to a test class, and 3 corresponds to a test method. These values will vary if user-defined suites are executed. |
minGranularity | The minimum granularity of the events to be logged. Typically, 0 corresponds to the Gradle-generated test suite for the whole test run, 1 corresponds to the Gradle-generated test suite for a particular test JVM, 2 corresponds to a test class, and 3 corresponds to a test method. These values will vary if user-defined suites are executed. |
quiet | Returns logging options for quiet level. |
showCauses | Tells whether causes of exceptions that occur during test execution will be logged. Only relevant if |
showExceptions | Tells whether exceptions that occur during test execution will be logged. Typically these exceptions coincide with a "failed" event. |
showStackTraces | Tells whether stack traces of exceptions that occur during test execution will be logged. |
showStandardStreams | Tells whether output on standard out and standard error will be logged. Equivalent to checking if both log events |
stackTraceFilters | The set of filters to be used for sanitizing test stack traces. |
warn | Gets logging options for warn level. |
Returns logging options for debug level.
The display granularity of the events to be logged. For example, if set to 0, a method-level event will be displayed as "Test Run > Test Worker x > org.SomeClass > org.someMethod". If set to 2, the same event will be displayed as "org.someClass > org.someMethod".
-1 denotes the highest granularity and corresponds to an atomic test.
Returns logging options for error level.
The events to be logged.
The format to be used for logging test exceptions. Only relevant if showStackTraces is true.
Gets logging options for info level.
Returns logging options for lifecycle level.
The maximum granularity of the events to be logged. Typically, 0 corresponds to the Gradle-generated test suite for the whole test run, 1 corresponds to the Gradle-generated test suite for a particular test JVM, 2 corresponds to a test class, and 3 corresponds to a test method. These values will vary if user-defined suites are executed.
-1 denotes the highest granularity and corresponds to an atomic test.
The minimum granularity of the events to be logged. Typically, 0 corresponds to the Gradle-generated test suite for the whole test run, 1 corresponds to the Gradle-generated test suite for a particular test JVM, 2 corresponds to a test class, and 3 corresponds to a test method. These values will vary if user-defined suites are executed.
-1 denotes the highest granularity and corresponds to an atomic test.
Returns logging options for quiet level.
Tells whether causes of exceptions that occur during test execution will be logged. Only relevant if showExceptions is true.
Tells whether exceptions that occur during test execution will be logged. Typically these exceptions coincide with a "failed" event.
Tells whether stack traces of exceptions that occur during test execution will be logged.
Tells whether output on standard out and standard error will be logged. Equivalent to checking if both log events TestLogEvent.STANDARD_OUT and TestLogEvent.STANDARD_ERROR are
set.
The set of filters to be used for sanitizing test stack traces.
Gets logging options for warn level.