Skip to main content

HTML coverage report generator for trace.py

Project description

trace2html
==========

:author: Olivier Grisel

`trace2html` is a utility to convert execution coverage data obtained
with the `trace` module of the standard python library into a set of human
readable HTML documents showing sortable summary and annotated source files.

Installation
------------

As usual, you can either use `sudo easy_install -U trace2html` or extract the
archive and run::

$ sudo python setup.py install

Sample usage
------------

Use trace2html to directly compute the coverage of a test suite by
specifying the module you are interested in::

$ trace2html.py -w my_module --run-command ./my_testrunner.py
$ firefox coverage_dir/index.html

Or you can collect coverage data generated with trace.py::

$ /usr/lib/python2.4/trace.py -mc -C coverage_dir -f counts my_testrunner.py

Write a report in directory 'other_dir' from data collected in 'counts'::

$ trace2html.py -f counts -o other_dir
$ firefox other_dir/index.html

Use the `--help` option for more details.

Licensing
---------

`trace2html` is released under the GNU/GPL v2 license (see COPYING.txt for more
details) and uses the

I would not mind relicensing `trace2html` under a more liberal license such as
the Python or ZPL licenses but that would only be useful if someone find or
write a replacement for the WebFX Sortable Table JS file under a similar
license. SortableTable.js is currently under GPLv2.

Bug reports and patches
-----------------------

You can directly send bug reports and patches to my personnal email address::

olivier.grisel@ensta.org

Or you can use `bzr`__ to branch my repository::

$ bzr branch lp:trace2html


then publish your branch on some site and send me a merge request. Please
follow the `5-minute tutorial`__ if you are new to bzr.

Credits
-------

`trace2html` is inspired by the `cobertura project`__ for java programs. It
includes Javascript code from WebFX Sortable Table and Cobertura.

.. References
__`bzr`:: http://bazaar-vcs.org/
__`5-minute tutorial`:: http://bazaar-vcs.org/QuickHackingWithBzr
__`cobertura project`:: http://cobertura.sourceforge.net

Changelog
=========

0.2.1
-----

- packaging bugfixes (added missing files in the source distribution)
(thanks to Grig Gheorghiu for the bug reports)

0.2.0
-----

- trace2html.py can now be directly used to collect coverage data
- new whitelist system to explicitely restrict the traced modules

0.1.1
-----

- minor bugfix in options help message

0.1.0
-----

- initial revision

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

trace2html-0.2.1.tar.gz (25.7 kB view hashes)

Uploaded Source

Built Distribution

trace2html-0.2.1-py2.4.egg (15.1 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page