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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
|
.. _faq:
==================
FAQ and other help
==================
:history: 20090613T141800, brand new docs.
Frequently asked questions
--------------------------
**Q: Why do unexecutable lines show up as executed?**
Usually this is because you've updated your code and run coverage on it
again without erasing the old data. Coverage records line numbers executed, so
the old data may have recorded a line number which has since moved, causing
coverage to claim a line has been executed which cannot be.
If you are using the ``-x`` command line action, it doesn't erase first by
default. Switch to the ``coverage run`` command, or use the ``-e`` switch to
erase all data before starting the next run.
**Q: Why do the bodies of functions (or classes) show as executed, but the def
lines do not?**
This happens because coverage is started after the functions are defined. The
definition lines are executed without coverage measurement, then coverage is
started, then the function is called. This means the body is measured, but
the definition of the function itself is not.
To fix this, start coverage earlier. If you use the :ref:`command line <cmd>`
to run your program with coverage, then your entire program will be monitored.
If you are using the :ref:`API <api>`, you need to call coverage.start() before
importing the modules that define your functions.
**Q: Does coverage work on Python 3.x?**
Not yet, but that's next on my list.
**Q: Isn't coverage testing the best thing ever?**
It's good, but `it isn't perfect
<http://nedbatchelder.com/blog/200710/flaws_in_coverage_measurement.html>`_.
Getting more help
-----------------
You can discuss coverage or get help using it on the `Testing In Python
<http://lists.idyll.org/listinfo/testing-in-python>`_ mailing list.
Bug reports are gladly accepted at the `bitbucket issue tracker
<http://bitbucket.org/ned/coveragepy/issues/>`_. Bitbucket also hosts the
`code repository <http://bitbucket.org/ned/coveragepy>`_.
Lastly, `I can be reached <http://nedbatchelder.com/site/aboutned.html>`_ in a
number of ways.
|
