Documentation for common Continuous Integration use cases

[jjzazuet]

Hi. Thanks for such an awesome framework!

As I go on learning the framework, there are things that I can't find an obvious solution for (maybe I'm not thinking correctly on how to leverage the notion of a test block). Regardless, is there a straightforward way to:

1. Run multiple @Test annotated classes inside a single test suite? For example, using Spock and JUnit, I can say:

FILE: CombinedTestSuite.groovy

import org.junit.runner.RunWith
import org.junit.runners.Suite

@RunWith(Suite)
@Suite.SuiteClasses([MyTestClassWhichExtendsSpocksSpecificationBaseClass1, MyTestClassWhichExtendsSpocksSpecificationBaseClass2, MyTestClassWhichExtendsSpocksSpecificationBaseClass3])
class CombinedTestSuite {}

2. If I have a single CombinedTestSuite @Test annotated class under scr/test/java/integration, Maven will pick it up and run its defined tests if I use mvn test. However, if I say: mvn test site, the generated site documentation doesn't include the Cuppa test class.

3. Also, I'm trying to run Cuppa tests through Jacoco, also with mvn test site, but it's saying:

-------------------------------------------------------
 T E S T S
-------------------------------------------------------
Running Cuppa
  This is a test
LOL I AM A TEST
    ✓ does some cool stuff...
  1 passing
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.014 sec - in Cuppa

Results :

Tests run: 1, Failures: 0, Errors: 0, Skipped: 0

[INFO] 
[INFO] --- maven-site-plugin:3.6:site (default-site) @ web-backend-test ---
[INFO] configuring report plugin org.apache.maven.plugins:maven-project-info-reports-plugin:2.7
[INFO] configuring report plugin org.apache.maven.plugins:maven-checkstyle-plugin:2.17
[INFO] configuring report plugin org.apache.maven.plugins:maven-jxr-plugin:2.3
[INFO] configuring report plugin org.apache.maven.plugins:maven-pmd-plugin:3.0.1
[INFO] configuring report plugin org.codehaus.mojo:findbugs-maven-plugin:3.0.1
[INFO] configuring report plugin org.apache.maven.plugins:maven-javadoc-plugin:2.10.3
[INFO] configuring report plugin org.jacoco:jacoco-maven-plugin:0.7.7.201606060606
[INFO] configuring report plugin org.apache.maven.plugins:maven-changes-plugin:2.12
[INFO] configuring report plugin org.apache.maven.plugins:maven-surefire-report-plugin:2.19.1
[INFO] Fork Value is true
[INFO] Done FindBugs Analysis....
[INFO] Skipping JaCoCo execution due to missing execution data file.
[ERROR] No Issue Management set. No JIRA Report will be generated.

Thanks!