Most recent first
21st of August 2023
Very minor fix in template report.
03rd of May 2023
Bug fixes release sorting out an important change from Spock 2: @Unrolled became the default, so spock-reports
stopped detecting correctly when a Specification was unrolled, causing the display name of features to look wrong
sometimes. With this release, feature names are displayed correctly.
More code is now statically-compiled, which continues to improve the performance of report generators.
14th of November 2022
Finally! Groovy 4 support is here!!
spock-reports version 2.4.0-groovy-4.0 has just been released.
No major changes are included in this release, but it's nice to be able to use the latest and greatest Groovy version.
On another note: version 2.3.2-groovy-3.0 was just released as well... it includes a couple of nice improvements
to "vivid" reports (reports that include source code). The Groovy 4 version also includes these improvements.
25th of August 2022
Minor bug fixes release. See release notes.
06th of February 2022
One bug fix and one new, small feature make up this release.
The bug #222 was pretty embarrassing, with a null-pointer Exception being
thrown on any inherited specification. Luckily, it's not very common to use inheritance between specs in Spock
(using that has some weird effects, such as overridden methods running in both the parent and child specs!) so no one
seems to have noticed that since version 2.1-groovy-3.0!
The new feature, to compensate: spock-reports now shows the execution time for every feature and iteration (on example-based features), instead of only for each specification. This information is helpful to find slow test features.
If you don't want to see the execution times for some reason, use a custom CSS stylesheet to make .ex-time
elements invisible.
30th of January 2022
This release, 2.2.0-groovy-3.0 has a couple of bug fixes and was tested against the latest milestone version of Spock,
2.1-M2-groovy-3.0, as well as Java 8, 11 and new in this release: Java 17.
Notice that the minimum Groovy version required to run on Java 17 appears to be Groovy
3.0.9.
Spock and spock-reports even work on the newly released Groovy 4! But notice that this is still unsupported, officially, both by Spock and by spock-reports... if you want to try anyway, check this blog post for more details: https://blog.solidsoft.pl/2021/11/19/running-spock-with-unsupported-groovy-version-gradle-maven/
Issue #219 related to parallel builds again: the spock-reports extension methods on Specification were not yet
adapted to support parallel builds. This was fixed and spock-reports now probably has full support for Spock
parallel builds! Let me know if you find any issues when using this new feature.
Issue #220 is a minor improvement: the ReportCreator's property testSourceRoots, which allows spock-reports to find
Groovy source code so that it can embed it in reports, only accepted String values, with different paths separated by
the Operating System's path separator. That was difficult to discover, so from now on, this property accepts any of the
following types:
-
String- same behaviour as before, accepts more than one path separated by;on Windows or:on other systems. -
File- the file's path will be used. -
Iterable- each item will be converted to one of the other types. -
Closure- callback that may produce a value of the supported types. -
06th of November 2021
Minor bug fix release 2.1.1-groovy-3.0.
2nd of September 2021
Release 2.1-groovy-3.0 fixes problem with reports when running
test features in parallel.
18th of May 2021
Spock 2.0 has been released!!! This spock-reports release has no functional changes, it just upgrades to Spock
2.0-groovy-3.0.
03rd of May 2021
Another minor release to keep up with Spock release candidates: spock-reports 2.0-RC4 is compatible with
Spock 2.0-M5-groovy-3.0.
This release does fix one minor issue, #212, which could cause a spock-reports Exception when a Spec failed in a certain way due to a previous update to keep up with Spock in which a constructor call for a constructor that has changed was missed.
It also improves the computation of errors and failures counts, as well as success rate.
13th of February 2021
Minor release to fix the POM published in the previous version, which was incorrect due to a careless change to use the new, recommended BOM feature from Gradle!
This release also marks the first release where spock-reports is published only to Maven Central, dropping JCenter releases. This is due to the recent announcement by Bintray that JCenter will be shutdown in April 2021, unfortunately.
Make sure you change all your projects to use Maven Central instead of JCenter.
05th of January 2021
A lot of folks seem to be interested in migrating to Spock 2.x even before it stabilizes! So I decided to listen to
them and merge all fixes from the 1.8.0 branch into master, and release a new spock-reports version that now uses
Spock version 2.0-M4-groovy-3.0. Thankfully, Spock has not changed much since the last milestone, so this upgrade
should go smoothly for everyone, including spock-reports itself.
For now, the Spcok reports will include additional information on the feature title when a feature contains examples and is not unrolled... this is a useful feature if you don't use spock-reports, but as spock-reports has always shown the examples even in such cases, this is not really helpful in spock-reports, so I intend to remove that at a future release, before 2.0. For now, though, this release should let you enjoy the newest, shiny Spock version.
TL;DR if you want to use the latest Spock 2/Groovy 3, upgrade to spock-reports version 2.0-RC3 and have fun.
04th of October 2020
Released spock-reports version 1.8.0 adding more statistics to reports (see issue #193) and to fix Java 9+ support when using JPMS modules (thanks to @fenixcitizen for the contribution).
15th of May 2020
spock-reports has caught up with the new Groovy and Spock releases! The new version, 2.0-RC2, works with Groovy 3 and Spock 2.
This is only a release-candidate (hence RC in the version), so please give it a go and as soon as Spock 2 is stabilized, hopefully spock-reports 2 will also have been well tested enough to update version to 2.0 itself.
10th of March 2020
This release (1.7.1) does not contain code changes. It is only a dependency upgrade release that should bring support for builds running Java 9+ (tested up to Java 12).
Java 8 can still be used, but spock-reports version 1.7.x should be used!
This is expected to be the last 1.x release, as version 2.0 is already in the works! I intend to base spock-reports 2.x on Groovy 3 and Spock 2.x.
The 1.x branch will still be maintained, but will only receive important bug fixes (no new features).
04th of January 2020
spock-reports version 1.6.3 released with several bug fixes, including some important changes on how feature counts are calculated.
10th of April 2019
Version 1.6.2 of spock-reports released! This is a bug-fix release, but it fixes some things that may affect a lot of users, so an upgrade is highly recommended.
23rd of September 2018
1.6.1 version allows template report authors to access time information for each feature run iteration. The default markdown template was updated to demonstrate how that information can be accessed.
This release also contains small bug fixes and it allows changing the location of the aggregated JSON report.
30th of May 2018
Small release fixing small issues and adding a new feature: the specification's titles, by default, will now be shown in the HTML summary report along with the class' name. This can be configured to show only class name or only title (when available) if desired. Details in the README page.
27th of March 2018
Quite a lot of improvements in this release, including a couple of bug fixes and some small, but nice new features.
The main new feature is support for Spock's SpockConfig.groovy file, which can now be used to configure spock-reports.
So, if you already configure other Spock extensions via the SpockConfig.groovy file, now there's no need to create a
separate file just for spock-reports.
Here's a simple example configuration file you could use:
// configure the @Issue extension
report {
issueUrlPrefix = 'http://myserver.com/issues/'
}
// configure spock-reports
spockReports {
set 'com.athaydes.spockframework.report.showCodeBlocks': true
set 'com.athaydes.spockframework.report.outputDir': 'target/spock-reports'
}
All properties are supported, of course! See more info in the README page.
26th of September 2017
Version 1.3.2 of spock-reports released.
This release brings two big improvements:
- system properties can now be used to override any property supported in configuration files.
- vivid reports now highlight which line of code caused a test to fail.
These improvements are so great that I decided to write a blog post about them!
24th of September 2017
@tilmanginzel published an extension of spock-reports that works with Geb to add support for screenshots in web test reports!
Check out geb-spock-reports if you use Spock and Geb!
18th of May 2017
Minor release fixing a bug in the new, optional vivid reports feature.
21st of April 2017
Lots of improvements in this major release (version 1.3.0), including a long overdue overhaul of the HTML report's CSS declarations that makes the HTML reports just a little bit more modern.
It also has a great new feature called vivid reports. It lets you show the test's source code in the report, just below the block description! It is not turned on by default (at least for now), see instructions in the README page for how to turn that one if you would like to add code to your reports (and why not!?).
Special thanks to @hexmind in this release, for helping with the vivid reports!
02nd of October 2016
Version 1.2.13 has been released!
This is a minor release with a few minor bug fixes, many of which are related to Specifications that fail to initialize. Now, a report will be created for every Specification that is attempted to run, even if failing catastrophically on initialization, with a useful error message shown on the report.
09th of June 2016
Version 1.2.12 has been released!
Besides a few bug fixes and modest performance improvements, this release brings much better handling of failures during Specification setup. All features of the Specification will be shown as FAILED, and the error will be displayed in the report under the first feature (to show the stacktrace, just enable that option in the config file).
This version also ensures that the report will show features in their execution order. This was not necessarily the case previously. Thanks to @tilmanginzel for the contribution to this feature.
19th of May 2016
This is a small bug fix release.
Importantly, though, it fixes the basic template report summary which had stopped working in version 1.2.10.
08th of March 2016
1.2.10 release - this release brings an improved aggregated report in the JSON format.
Previous versions of spock-reports already generated a file called .aggregated_data in the reports directory. This file was a JSON representation of all specifications run by Spock, and was used to keep track of tests running in separate processes, so that the index.html file could contain all tests, not only the ones running in the last process to terminate.
This file, however, turned out to be useful when you have multi-projects and end up with multiple index.html reports for each project... because this file is in the json format and is so easy to parse, external tools can use these files to aggregate the summaries of all projects into a single, final report, much more easily.
In this release, the JSON report aggregation file was improved and renamed to aggregated_report.json
so that it is more visible and can be freely used by external tools.
14th of February 2016
1.2.9 release - this is the first release to be published on Maven Central!
Many users complained about restrictions regarding Maven repositories in their working place, so hopefully this will help a lot of users to start getting proper reports out of their Spock specifications.
Another worthy new feature in this release is the option to not inline CSS in HTML files, avoiding CSP violations (see issue #54).
6th of January 2016
1.2.8 release - a new feature and a few fixes are included in this release.
Also, the logging framework has been changed from JUL to Slf4J due to several complaints about JUL making it hard to configure the logging behaviour of spock-reports. Now, you can easily choose a logger implementation that is compatible with slf4j, such as Log4j or Logback, and configure it to enable as much logging as you wish from spock-reports!
The new feature: it is now possible to, optionally, include the stack-trace of a Throwable that caused a test failure in HTML reports. This should be useful for developers to track down bugs without having to chase stacktraces using other sources.
15th of August 2015
1.2.7 release - a really quick release this time! That's because the previous release, 1.2.6, unfortunately missed adding support for documentation annotations (@Ignore, @Issue, @See, @Title, @Narrative). Support for all of these annotations have been added in this release (the release notes have been amended to reflect this).
As usual, this release also includes some tiny bug fixes... and template reports are now easier to write.
12th of August 2015
1.2.6 release - this release brings support for parallel builds. Until now, individual specification reports would be created just fine, but the aggregated report would only contain the specifications run by the last Thread of a parallel build. After this release, that is no longer the case!
Other minor improvements were also included in this release, check the release notes for details.
BREAKING CHANGE: for users of template reports, a necessary breaking change had to made: in Specification report
templates, to iterate over features you must now call method eachFeature instead of forEach. This was necessary
because the old name conflicted with a native method when using Java 8. Sorry for the inconvenience.
8th of March 2015
1.2.5 release - added support for Spock 1.0, which has been released, finally!! Also, but not less important, now spock-reports has support for templates! This lets you make your report look like whatever you want!
14th of February 2015
1.2.4 released - some nice new features included, such as Table of Contents.
08th of November 2014
1.2.3 released - downgraded minimum Groovy version required to 2.0.8 (benefits some Grails users).
03rd of November 2014
Small feature release (1.2.2): added support for @Unroll-ing variables not only in Spec names, but also in block texts (given, when, then...)
01st of November 2014
Bug fix release, 1.2.1. Fixed problems with bad-behaving Specification setup methods and removed usage of some Groovy features to allow running spock-reports with any recent JDK 7 or 8 version.
3rd of August 2014
Release of version 1.2! This release includes full support for @Unroll, amongst other small improvements.
3rd of July 2014
After a long delay, I have finally published the 1.1 release on a public repo, thanks to @JayStGelais
contribution. So now spock-reports is available on Bintray's JCenter!
14th of September 2013
Release of version 1.1 with some minor bug fixes and improvements in the information shown in reports.
Please check the release notes in the file releases/Release_Notes.txt.
6th of August 2013
Today, I am proud to release version 1.0 of this project! I have made sure to make it as stable
as possible so that you can start reading proper reports for your Spock specifications without worries.
You can find the jar in the releases directory! Download it, place it in your classpath and you're done!
By default, the reports will be saved in the directory build/spock-reports, but you can change that if you want,
just check below.
I hope you find this project as useful as I have (I actually developed this out of my own need for it!).
I wrote a blog post about the motivation behind this project. Please check it out!