coverage

/qt-suite:coverage — Coverage Analysis

Run coverage instrumentation, generate an HTML report, and identify untested code paths. Optionally triggers the test-generator agent when gaps are found.

Step 1: Parse Arguments and Config

Parse the command argument for flags:

• --python — force Python mode
• --cpp — force C++ mode
• --threshold N — override coverage threshold (default 80)

Read .qt-test.json if present:

• project_type — python | cpp
• coverage_threshold — numeric, default 80
• build_dir — default "build-coverage"
• coverage_exclude — list of patterns to exclude

Auto-detect project type if not specified (CMakeLists.txt = C++, pyproject.toml = Python).

Step 2: Run Coverage — Python

First verify the prerequisite tools are available:

python3 -c "import coverage, pytest_cov" 2>&1 || echo "Install: pip install coverage pytest-cov"

Run tests with coverage instrumentation:

QT_QPA_PLATFORM=offscreen \
  pytest \
    --cov=<package_name> \
    --cov-branch \
    --cov-report=term-missing \
    --cov-report=html:htmlcov \
    --cov-report=json:.coverage.json \
    tests/

Determine <package_name> from pyproject.toml [tool.coverage.run] source field, or from the project's main package directory.

Step 3: Run Coverage — C++

First verify prerequisites:

bash "${CLAUDE_PLUGIN_ROOT}/scripts/check-prerequisites.sh"

Build with coverage instrumentation:

echo "Configuring with coverage instrumentation..."
cmake -B build-coverage -DCMAKE_BUILD_TYPE=Debug -DENABLE_COVERAGE=ON
echo "Building..."
cmake --build build-coverage --parallel 4

Collect coverage:

cd build-coverage
echo "Running tests (pass 1 — zeroing counters)..."
ctest --output-on-failure

lcov --zerocounters --directory .
# (re-run tests to collect fresh counters)
echo "Running tests (pass 2 — collecting coverage data)..."
ctest --output-on-failure

echo "Generating coverage report..."
lcov --capture \
     --directory . \
     --output-file ../coverage_raw.info \
     --no-external

lcov --remove ../coverage_raw.info \
     '*/tests/*' '*/moc_*' '*/ui_*' \
     --output-file ../coverage.info

genhtml ../coverage.info \
        --output-directory ../htmlcov \
        --title "Coverage Report" \
        --legend
cd ..