This is an experimental Emacs package to report code coverage output produced by Python's coverage package directly inside Emacs buffers.
coverage's xml output follows the cobertura format, it should work with similar reports from other tools, like C/C++ with gcovr.
Best used together with python-pytest.el.
Minor mode for automagically updated overlays:
python-coverage-overlay-mode
Alternatively, commands for manually updated overlays:
python-coverage-overlay-refreshpython-coverage-overlay-remove-all
Navigation commands:
python-coverage-overlay-jump-nextpython-coverage-overlay-jump-previouspython-coverage-overlay-jump-first
Run flycheck-select-checker, pick python-coverage.
This package reads the XML output produced by Python's coverage package. Usually this file is named coverage.xml.
With plain `coverage`:
$ coverage xmlWith pytest-cov, pass --cov-report=xml, e.g. via pyproject.toml:
[tool.pytest.ini_options]
addopts = [
"--cov=your-package",
"--cov=test",
"--cov-report=xml",
]Command for manual coverage file selection:
python-coverage-select-coverage-file
Customizable settings (see their description for details) in the python-coverage group, e.g. via M-x customize-group:
python-coverage-default-file-namepython-coverage-overlay-width
Styling via custom faces, e.g. via M-x customize-face:
python-coverage-overlay-missingpython-coverage-overlay-partialpython-coverage-overlay-missing-outdatedpython-coverage-overlay-partial-outdated
Note: by default this package inherits from magit-diff-* faces, which should work in most themes. This requires magit to be installed, but it's not otherwise used.
This package was created by wouter bolsterlee (@wbolster).
BSD; see LICENSE.rst.