Camunda Process Test example: only report.json generated, no HTML coverage report

Camunda 8 Topics
, ,
1

Hi everyone,

I’m trying out Camunda Process Test using the official example project from the docs:

Environment:

  • Java: 17/21

  • Maven: (default from project, running mvn clean test)

  • Camunda Process Test version: as in the example (8.9.0-SNAPSHOT from the POM)

  • Using the default Testcontainers runtime (I did not configure runtime-mode: remote or Camunda 8 Run)

What I did:

  1. Cloned the example repo.

  2. Ran:

    mvn clean test

  3. Tests completed successfully. The relevant part of the Maven output:

    [INFO] Results: [INFO] [INFO] Tests run: 2, Failures: 0, Errors: 0, Skipped: 0 [INFO] [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------

  4. I then checked target/coverage-report.

What I see:

  • target/coverage-report exists.

  • Inside, there is a folder io.camunda.ProcessNestedUnitTest containing a report.json.

  • There is no report.html anywhere under target/coverage-report.

  • The Maven log does not contain a line like:

    Coverage report: file:///.../target/coverage-report/report.html

According to the docs, after a test run CPT should:

  • Print coverage to the log and

  • Generate HTML and JSON coverage reports in the configured directory (default shown as target/coverage-report). [Process test coverage; Coverage config]

I have not changed any coverage-related configuration (no custom reportDirectory, no exclusions), and I’m just running the example as-is.

My questions:

  1. Is it expected that the example currently only generates report.json and not report.html?

  2. Is there any additional configuration needed to enable the HTML report for Camunda Process Test in this example?

  3. Could this be a known issue with the current snapshot of the example, or am I missing a step?

Any hints or confirmation from the Camunda team or community would be appreciated.

Thanks & Regards,

Jignesh Pithava

2

Hi @pithvajignesh,

Thanks for the detailed report! This appears to be a problem with the HTML coverage report generation in the Camunda Process Test example.

Based on your description, you should indeed be getting both HTML and JSON coverage reports by default. The fact that you’re only seeing report.json but no report.html suggests there might be an issue with the current snapshot version.

Key Points:

  1. Expected Behavior: Camunda Process Test should generate both HTML and JSON coverage reports by default in the target/coverage-report directory, and you should see a log message like:

    Coverage report: file:///path/to/project/target/coverage-report/report.html

  2. Snapshot Version Concern: You’re using 8.9.0-SNAPSHOT, which is a very early development version that can be prone to bugs, incomplete implementations, or undocumented breaking changes.

Recommendations:

  1. Try a Stable Version: I’d recommend testing with a stable release like 8.7.x or 8.8 to see if the HTML report generation works correctly there.

  2. Verify Configuration: Although you mentioned using default settings, you could try explicitly configuring the report directory in your test configuration to ensure it’s being written correctly.

  3. Report the Issue: Since this appears to be a bug in the snapshot version, please consider reporting it on the Camunda GitHub repository with the details you’ve provided.

To Answer Your Questions:

  1. No, it’s not expected that only report.json is generated - you should get both HTML and JSON reports.
  2. No additional configuration should be needed for the HTML report in the default setup.
  3. This could be a known issue with the current snapshot version.

Could you try testing with a stable version to confirm if this is specific to the snapshot? That would help determine if this is a regression in the development version.

References: