Using OpenClover with Bamboo

[#1]

OpenClover? Huh what's that?

Atlassian Clover was recently open sourced and Atlassian announced there won't be any new versions. 

Is it bad? Not necessairly. This event empowered the community to start forks of Clover and give this product a second life. One of the forks - OpenClover - was started by former Atlassian Clover developers (but it's not backed by Atlassian in any means).

How to use OpenClover with Bamboo

Although Bamboo at them moment doesn't provide any formal integration with OpenClover, it's still possible to leverage OpenClover in Bamboo builds. Afterall, OpenClover and Atlassian Clover share majority of codebase, don't they ?

Integrate OpenClover with your build

First of all, you need to integrate OpenClover with your build. OpenClover provides plenty of integrations with various tools, but we're going to focus here on Maven mostly, as it's the most popular build tool for Java projects.  

To get OpenClover working with a minimal valid configuration just execute the following Maven command:

mvn clean org.openclover:clover-maven-plugin:setup verify org.openclover:clover-maven-plugin:aggregate org.openclover:clover-maven-plugin:clover

In case you need more sophisticated configuration, you can refer to Atlassian Clover documentation with one caveat, you'll need to remember to migrate any Atlassian Clover references to OpenClover in order to enjoy free, community edition of this software. 

Configure Bamboo to read OpenClover reports

As I wrote in previous points, Atlassian Clover and OpenClover are quite similar and they both produce coverage reports in the same format. This means it is possible to leverage Bamboo Clover integration to show OpenClover reports. 

In order to do that you need to configure Bamboo to invoke Maven with flags enabling OpenClover

Once Bamboo sucessfully buids your project, it's enough to enable Bamboo Clover integration. Remember to select Clover is already integrated into this build and clover.xml file will be produced

And voilà!

Bamboo shows reports produced by OpenClover in a Clover tab.