Scroll to navigation

DIFF-COVER(1) User Commands DIFF-COVER(1)

NAME

diff-cover - find diff lines that need test coverage

DESCRIPTION

usage: diff-cover [-h] [--html-report FILENAME] [--json-report FILENAME]

[--markdown-report FILENAME] [--show-uncovered] [--expand-coverage-report] [--external-css-file FILENAME] [--compare-branch BRANCH] [--fail-under SCORE] [--ignore-staged] [--ignore-unstaged] [--include-untracked] [--exclude EXCLUDE [EXCLUDE ...]] [--include INCLUDE [INCLUDE ...]] [--src-roots DIRECTORY [DIRECTORY ...]] [--diff-range-notation RANGE_NOTATION] [--version] [--ignore-whitespace] [-q] [-c CONFIG_FILE] [--diff-file DIFF_FILE] coverage_file [coverage_file ...]

Automatically find diff lines that need test coverage.

positional arguments:

coverage report (XML or lcov.info)

options:

show this help message and exit
Diff coverage HTML output
Diff coverage JSON output
Diff coverage Markdown output
Show uncovered lines on the console
Append missing lines in coverage reports based on the hits of the previous line.
Write CSS into an external file
Branch to compare
Returns an error code if coverage or quality score is below this value
Ignores staged changes
Ignores unstaged changes
Include untracked files
Exclude files, more patterns supported
Files to include (glob pattern)
List of source directories (only for jacoco coverage reports)
Git diff range notation to use when comparing branches, defaults to '...'
show program's version number and exit
When getting a diff ignore any and all whitespace
Only print errors and failures
The configuration file to use
The diff file to use
January 2025 diff-cover 9.2.2