colcon-coveragepy-result

A colcon extension for collecting coverage.py results.

Usage

1. Build packages with coverage, e.g. using a colcon mixin for coverage

   $ colcon build --mixin coverage-pytest
   

2. Test packages with coverage, again using a mixin

   $ colcon test --mixin coverage-pytest
   

3. Collect coverage results

   $ colcon coveragepy-result
   

4. Open HTML report, which by default is under coveragepy/htmlcov/

Options

• Print coverage reports for each package and a combined coverage report of all packages

  $ colcon coveragepy-result --verbose
  

• Provide additional arguments for reports generation, e.g. to show lines without coverage

  $ colcon coveragepy-result --coverage-report-args -m
  

• Provide additional arguments for HTML report generation, e.g. to skip files with no code

  $ colcon coveragepy-result --coverage-html-args --skip-empty
  

• For more options

  $ colcon coveragepy-result --help
  

Contributing

See:

• Contributions for guidelines
• Bootstrap from source to test the package from source