1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47
|
.. _api:
============
Coverage API
============
:history: 20090524T134300, brand new docs.
:history: 20090613T164000, final touches for 3.0
:history: 20100221T151500, docs for 3.3 (on the plane back from PyCon)
:history: 20100725T211700, updated for 3.4.
:history: 20121111T235800, added a bit of clarification.
The API to coverage.py is very simple, contained in a single module called
`coverage`. Most of the interface is in a single class, also called
`coverage`. Methods on the coverage object correspond roughly to operations
available in the command line interface. For example, a simple use would be::
import coverage
cov = coverage.coverage()
cov.start()
# .. call your code ..
cov.stop()
cov.save()
cov.html_report()
The coverage module
-------------------
.. module:: coverage
.. autoclass:: coverage
:members:
Starting coverage automatically
-------------------------------
This function is used to start coverage measurement automatically when Python
starts. See :ref:`subprocess` for details.
.. autofunction:: process_startup
|