pycobertura 0.4.0

Install

$ pip install pycobertura

CLI usage

pycobertura provides a command line interface to report on coverage files.

$ pycobertura --help
$ pycobertura show --help
$ pycobertura diff --help

$ pycobertura show coverage.xml
Name                     Stmts    Miss  Cover    Missing
---------------------  -------  ------  -------  ---------
pycobertura/__init__         1       0  100.00%
pycobertura/cli             18       0  100.00%
pycobertura/cobertura       93       0  100.00%
pycobertura/reports        129       0  100.00%
pycobertura/utils           12       0  100.00%
TOTAL                      253       0  100.00%

$ pycobertura diff coverage.old.xml coverage.new.xml
Name          Stmts    Miss    Cover     Missing
------------  -------  ------  --------  ---------
dummy/dummy   -        -2      +50.00%   -2, -5
dummy/dummy2  +2       -       +100.00%
TOTAL         +2       -2      +50.00%

Library usage

Using it as a library in your Python application is easy:

from pycobertura import Cobertura
cobertura = Cobertura('coverage.xml')

cobertura.version == '3.7.1'
cobertura.line_rate() == 1.0  # 100%
cobertura.classes() == [
    'pycobertura/__init__',
    'pycobertura/cli',
    'pycobertura/cobertura',
    'pycobertura/reports',
    'pycobertura/utils',
]
cobertura.line_rate('pycobertura/cli') == 1.0

from pycobertura import TextReporter
tr = TextReporter(cobertura)
tr.generate() == """\
Name                     Stmts    Miss  Cover    Missing
---------------------  -------  ------  -------  ---------
pycobertura/__init__         1       0  100.00%
pycobertura/cli             18       0  100.00%
pycobertura/cobertura       93       0  100.00%
pycobertura/reports        129       0  100.00%
pycobertura/utils           12       0  100.00%
TOTAL                      253       0  100.00%"""

from pycobertura import TextReporterDelta

coverage1 = Cobertura('coverage1.xml')
coverage2 = Cobertura('coverage2.xml')
delta = TextReporterDelta(coverage1, coverage2)
delta.generate() == """\
Name          Stmts    Miss    Cover     Missing
------------  -------  ------  --------  ---------
dummy/dummy   -        -2      +50.00%   -2, -5
dummy/dummy2  +2       -       +100.00%
TOTAL         +2       -2      +50.00%"""

Contribute

Found a bug? Got a patch? Have an idea? Please use Github issues or fork pycobertura and submit a pull request (PR). All contributions are welcome!

If you submit a PR:

• ensure the description of your PR illustrates your changes clearly by showing what the problem was and how you fixed it (before/after)

• make sure your changes are covered with one or more tests

• add a descriptive note in the CHANGES file under the Unreleased section

• update the README accordingly if your changes outdate the documentation

• make sure all tests are passing using tox

pip install tox
tox

Unreleased

0.4.0 (2015-01-04)

• rename Cobertura.total_lines() -> Cobertura.total_statements()

• rename Cobertura.line_hits() -> Cobertura.hit_statements()

• introduce Cobertura.missed_statements()

• introduce Cobertura.line_statuses() which returns line numbers for a given class name with hit/miss statuses

• introduce Cobertura.class_source() which returns the source code for a given class along with hit/miss status

• pycobertura show now includes HTML source

• pycobertura show now accepts --source which indicates where the source code directory is located

• Cobertura() now takes an optional base_path argument which will be used to resolve the path to the source code by joining the base_path value to the path found in the Cobertura report.

• an error is now raised if Cobertura is passed a non-existent XML file path

• pycobertura diff now includes HTML source

• pycobertura diff now accepts --source1 and --source2 which indicates where the source code directory of each of the Cobertura reports are located

• introduce CoberturaDiff used to diff Cobertura objects

• argument class_name for Cobertura.total_statements is now optional

• argument class_name for Cobertura.total_misses is now optional

• argument class_name for Cobertura.total_hits is now optional

0.3.0 (2014-12-23)

• update description of pycobertura

• pep8-ify

• add pep8 tasks for tox and travis

• diff command returns non-zero exit code if coverage worsened

• Cobertura.branch_rate is now a method that can take an optional class_name argument

• refactor internals for improved readability

• show classes that contain no lines, e.g. __init__.py

• add Cobertura.filename(class_name) to retrieve the filename of a class

• fix erroneous reporting of missing lines which was equal to the number of missed statements (wrong because of multiline statements)

0.2.1 (2014-12-10)

• fix py26 compatibility by switching the XML parser to lxml which has a more predictible behavior when used across all Python versions.

• add Travis CI

0.2.0 (2014-12-10)

• apply Skeleton 2.0 theme to html output

• add -o / --output option to write reports to a file.

• known issue: diffing 2 files with options --format text, --color and --output does not render color under PY2.

0.1.0 (2014-12-03)

• add --color and --no-color options to pycobertura diff.

• add option -f and --format with output of text (default) and html.

• change class naming from report to reporter

0.0.2 (2014-11-27)

• MIT license

• use pypandoc to convert the long_description in setup.py from Markdown to reStructuredText so pypi can digest and format the pycobertura page properly.

0.0.1 (2014-11-24)

• Initial version