OS Manuals

/opt/chainguard/sqlfluff/bin/diff-cover

SQLFluff is a dialect-flexible, configurable SQL linter and auto-formatter ("The SQL Linter for Humans"). It parses SQL across many dialects, reports style/layout/convention rule violations, and can automatically fix or reformat files, with support for templated SQL (Jinja, placeholders, dbt via plugin) and multiple report formats.

From sqlfluff 4.5.0-r0 (enterprise-packages), captured 2026-11-08 by running diff-cover --help (exit 0). permalink

usage: diff-cover [-h] [--format FORMAT] [--show-uncovered] [--show-covered]
                  [--expand-coverage-report] [--branch-coverage] [--external-css-file FILENAME]
                  [--compare-branch BRANCH] [--fail-under SCORE] [--minimum-change LINES]
                  [--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]
                  [--total-percent-float]
                  coverage_files [coverage_files ...]

Automatically find diff lines that need test coverage.

positional arguments:
  coverage_files        coverage report (XML or lcov.info)

options:
  -h, --help            show this help message and exit
  --format FORMAT       Format to use
  --show-uncovered      Show uncovered lines on the console
  --show-covered        Also highlight covered diff lines (in green) in the HTML coverage report,
                        in addition to the existing missing-line (red) highlighting.
  --expand-coverage-report
                        Append missing lines in coverage reports based on the hits of the previous
                        line.
  --branch-coverage     Treat partially covered branches as uncovered. Requires a coverage report
                        with branch coverage data (Cobertura branch="true" condition-coverage).
  --external-css-file FILENAME
                        Write CSS into an external file
  --compare-branch BRANCH
                        Branch to compare
  --fail-under SCORE    Returns an error code if coverage or quality score is below this value
  --minimum-change LINES
                        Always pass if total lines of change is below this value
  --ignore-staged       Ignores staged changes
  --ignore-unstaged     Ignores unstaged changes
  --include-untracked   Include untracked files
  --exclude EXCLUDE [EXCLUDE ...]
                        Exclude files, more patterns supported
  --include INCLUDE [INCLUDE ...]
                        Files to include (glob pattern)
  --src-roots DIRECTORY [DIRECTORY ...]
                        List of source directories (only for jacoco coverage reports)
  --diff-range-notation RANGE_NOTATION
                        Git diff range notation to use when comparing branches, defaults to '...'
  --version             show program's version number and exit
  --ignore-whitespace   When getting a diff ignore any and all whitespace
  -q, --quiet           Only print errors and failures
  -c, --config-file CONFIG_FILE
                        The configuration file to use
  --diff-file DIFF_FILE
                        The diff file to use
  --total-percent-float
                        Show total coverage/quality as a float rounded to 2 decimal places
Options (20)
OptionDescriptionSource
-h, --helpshow this help message and exithelp
--format FORMATFormat to usehelp
--show-uncoveredShow uncovered lines on the consolehelp
--show-coveredAlso highlight covered diff lines (in green) in the HTML coverage report, in addition to the existing missing-line (red) highlighting.help
--expand-coverage-reportAppend missing lines in coverage reports based on the hits of the previous line.help
--branch-coverageTreat partially covered branches as uncovered.help
--external-css-file FILENAMEWrite CSS into an external filehelp
--compare-branch BRANCHBranch to comparehelp
--fail-under SCOREReturns an error code if coverage or quality score is below this valuehelp
--minimum-change LINESAlways pass if total lines of change is below this valuehelp
--ignore-stagedIgnores staged changeshelp
--ignore-unstagedIgnores unstaged changeshelp
--include-untrackedInclude untracked fileshelp
--diff-range-notation RANGE_NOTATIONGit diff range notation to use when comparing branches, defaults to '...'help
--versionshow program's version number and exithelp
--ignore-whitespaceWhen getting a diff ignore any and all whitespacehelp
-q, --quietOnly print errors and failureshelp
-c, --config-file CONFIG_FILEThe configuration file to usehelp
--diff-file DIFF_FILEThe diff file to usehelp
--total-percent-floatShow total coverage/quality as a float rounded to 2 decimal placeshelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.