Configuration Reference

ReqCover is configured entirely through JUnit Platform configuration parameters - typically a junit-platform.properties file on your test classpath, but anything the JUnit Platform Launcher accepts (system properties, a LauncherDiscoveryRequestBuilder.configurationParameter(...) call, your build tool’s own JUnit config) works the same way.

reqCover.requirementsUris

Comma-separated list of classpath resource paths, each resolved through the RequirementsSource SPI (see Requirements Sources). Every source’s requirements are merged into one expected set.

reqCover.requirementsUris=openapi/api.yaml,openapi/admin-api.yaml

If this property is absent, ReqCover logs a warning and skips coverage tracking for the run - it does not fail the build by itself.

reqCover.minimumRequiredCoveragePercent

A number (default 0.0) - the minimum percentage of expected requirements that must be covered.

reqCover.minimumRequiredCoveragePercent=80

When actual coverage falls below this threshold, ReqCover logs an error. Whether that error fails the build depends on the next property.

reqCover.failIfBelowMinimum

true or false (default true). When coverage is below the minimum and this is true, ReqCover exits the JVM with status code 1 - which fails the surrounding Gradle or Maven build. Set it to false to report insufficient coverage without breaking CI (useful while you’re first introducing ReqCover to an existing project).

reqCover.failIfBelowMinimum=false

Removed: reqCover.requirementsUri

Older configurations may still reference the singular reqCover.requirementsUri (no s). It has been removed in favor of reqCover.requirementsUris. If ReqCover detects the old key on your classpath, it logs an error and fails the build immediately, rather than silently ignoring your configuration - update the property name to migrate.

Example: junit-platform.properties

reqCover.requirementsUris=openapi/api.yaml
reqCover.minimumRequiredCoveragePercent=100
reqCover.failIfBelowMinimum=true