A Gradle plugin for printing beautiful logs on the console while running tests.
Scroll down for more themes and customisation options or visit the screenshots page for more demos.
plugins {
id 'com.adarshr.test-logger' version '1.5.0'
}
buildscript {
repositories {
maven {
url 'https://plugins.gradle.org/m2/'
}
}
dependencies {
classpath 'com.adarshr:gradle-test-logger-plugin:1.5.0'
}
}
apply plugin: 'com.adarshr.test-logger'
All the below configuration settings can either be specified in build.gradle
file or be set at runtime using system
properties or both. For instance, we could have theme
set to mocha
in build.gradle
file but it can be overridden
to be standard
at runtime by using -Dtestlogger.theme=standard
on the command line. Since they're system properties
we have a number of ways of specifying them including JAVA_OPTS
and gradle.properties
.
The convention used for determining the name of the system property is testlogger.<configuration setting>
.
- Switch themes
- Hide exceptions
- Define slow threshold
- Hide summary
- Show standard streams
- Filter standard streams
- Filter test results
testlogger {
theme 'mocha'
}
The following themes are currently supported:
plain
- displays no colours or Unicode symbolsstandard
- displays colours but no Unicode symbolsmocha
- similar to what Mocha's spec reporter prints, with colours and Unicode symbolsplain-parallel
- similar to theplain
theme but supports parallel test executionstandard-parallel
- similar to thestandard
theme but supports parallel test executionmocha-parallel
- similar to themocha
theme but supports parallel test execution
By default, the showExceptions
flag is turned on. This shows why the tests failed including the location of the
failure. Of course, you can switch off this slightly more verbose logging by setting showExceptions
to false
.
testlogger {
showExceptions false
}
Tests that are too slow will have their duration logged. However, "slow" is a relative terminology varying widely depending on the type of tests being executed, environment, kind of project and various other factors. Therefore you can define what you consider as slow to suit your needs.
testlogger {
slowThreshold 5000
}
The default value of slowThreshold
is 2
seconds. So all tests that take longer than a second to run will have their
actual execution time logged.
If you want to turn off the logging of time taken completely, simply set the threshold to a very large value.
Please note that in themes that support colours, the duration is displayed using a warning style if it is greater than
half the slow threshold. For instance, if slowThreshold
is 5 seconds any tests that take longer than 2.5 seconds to
run would have their durations logged using a warning style and those that take longer than 5 seconds to run using an
error style.
By default, a useful summary containing a breakdown of passing, failing and skipped tests along with the total time taken to execute all the tests is shown. Of course, you can disable this if you prefer a more succinct output.
testlogger {
showSummary false
}
The display of standard output and error streams alongside the test logs can be controlled using the below configuration.
testlogger {
showStandardStreams true
}
If the display standard output and error streams is enabled, it can often produce too much output to overwhelm anyone. Fortunately, we can filter this output based on the type of the test result.
testlogger {
showStandardStreams true
showPassedStandardStreams false
showSkippedStandardStreams false
showFailedStandardStreams true
}
All the three filter flags are enabled by default. In other words, the standard stream output is not filtered if
showStandardStreams
is enabled but none of the filter flags are configured.
If showStandardStreams
is set to false
, the filter flags don't have any effect.
Sometimes it is useful to hide test results of a certain type. For instance, if an application has hundreds of tests, the sheer volume of the output produced by passing tests could be enough to bury any valuable test failures. Similarly there might be a need to hide skipped tests or in rare instances even the failed ones.
We can perform test result filtering by using the below settings.
testlogger {
showPassed false
showSkipped false
showFailed true
}
By default all the above three flags are turned on. If you have chosen to display standard streams by setting
showStandardStreams
flag to true
, any output produced by filtered out tests will not be displayed.
Mostly. The standard
and plain
themes work out of the box but you might have to make a few modifications to your
system settings to see Unicode symbols when using the mocha
theme.
- Set or update
JAVA_OPTS
with the system property-Dfile.encoding=UTF-8
- Change the terminal code page to 65001 by executing
chcp 65001
You can switch off ANSI control characters and Unicode symbols by adding --console=plain
to your Gradle command line.
Yes. You will need to switch to a suitable parallel theme though. This can be one of plain-parallel
, standard-parallel
or
mocha-parallel
. The parallel themes are specially designed to work with a setting of
maxParallelForks
greater than 1. They achieve this by sacrificing the ability to group tests and thus some readability is lost.