OLD | NEW |
1 .. _faq: | 1 .. _faq: |
2 | 2 |
3 ================== | 3 ================== |
4 FAQ and other help | 4 FAQ and other help |
5 ================== | 5 ================== |
6 | 6 |
7 :history: 20090613T141800, brand new docs. | 7 :history: 20090613T141800, brand new docs. |
8 :history: 20091005T073900, updated for 3.1. | 8 :history: 20091005T073900, updated for 3.1. |
9 :history: 20091127T201500, updated for 3.2. | 9 :history: 20091127T201500, updated for 3.2. |
10 :history: 20110605T175500, add the announcement mailing list. | 10 :history: 20110605T175500, add the announcement mailing list. |
11 :history: 20121231T104700, Tweak the py3 text. | 11 :history: 20121231T104700, Tweak the py3 text. |
12 | 12 |
13 | 13 |
14 Frequently asked questions | 14 Frequently asked questions |
15 -------------------------- | 15 -------------------------- |
16 | 16 |
17 **Q: I use nose to run my tests, and its cover plugin doesn't let me create | 17 **Q: I use nose to run my tests, and its cover plugin doesn't let me create |
18 HTML or XML reports. What should I do?** | 18 HTML or XML reports. What should I do?** |
19 | 19 |
20 First run your tests and collect coverage data with `nose`_ and its plugin. | 20 First run your tests and collect coverage data with `nose`_ and its plugin. |
21 This will write coverage data into a .coverage file. Then run coverage.py from | 21 This will write coverage data into a .coverage file. Then run coverage.py from |
22 the :ref:`command line <cmd>` to create the reports you need from that data. | 22 the :ref:`command line <cmd>` to create the reports you need from that data. |
23 | 23 |
24 .. _nose: http://somethingaboutorange.com/mrl/projects/nose | 24 .. _nose: http://somethingaboutorange.com/mrl/projects/nose |
25 | 25 |
26 | 26 |
27 **Q: Why do unexecutable lines show up as executed?** | 27 **Q: Why do unexecutable lines show up as executed?** |
28 | 28 |
29 Usually this is because you've updated your code and run coverage on it | 29 Usually this is because you've updated your code and run coverage on it again |
30 again without erasing the old data. Coverage records line numbers executed, so | 30 without erasing the old data. Coverage records line numbers executed, so the |
31 the old data may have recorded a line number which has since moved, causing | 31 old data may have recorded a line number which has since moved, causing |
32 coverage to claim a line has been executed which cannot be. | 32 coverage to claim a line has been executed which cannot be. |
33 | 33 |
34 If you are using the ``-x`` command line action, it doesn't erase first by | 34 If you are using the ``-x`` command line action, it doesn't erase first by |
35 default. Switch to the ``coverage run`` command, or use the ``-e`` switch to | 35 default. Switch to the ``coverage run`` command, or use the ``-e`` switch to |
36 erase all data before starting the next run. | 36 erase all data before starting the next run. |
37 | 37 |
38 | 38 |
39 **Q: Why do the bodies of functions (or classes) show as executed, but the def | 39 **Q: Why do the bodies of functions (or classes) show as executed, but the def |
40 lines do not?** | 40 lines do not?** |
41 | 41 |
(...skipping 49 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
91 Bug reports are gladly accepted at the `Bitbucket issue tracker`_. | 91 Bug reports are gladly accepted at the `Bitbucket issue tracker`_. |
92 | 92 |
93 .. _Bitbucket issue tracker: http://bitbucket.org/ned/coveragepy/issues | 93 .. _Bitbucket issue tracker: http://bitbucket.org/ned/coveragepy/issues |
94 | 94 |
95 Announcements of new coverage.py releases are sent to the | 95 Announcements of new coverage.py releases are sent to the |
96 `coveragepy-announce`_ mailing list. | 96 `coveragepy-announce`_ mailing list. |
97 | 97 |
98 .. _coveragepy-announce: http://groups.google.com/group/coveragepy-announce | 98 .. _coveragepy-announce: http://groups.google.com/group/coveragepy-announce |
99 | 99 |
100 `I can be reached`__ in a number of ways, I'm happy to answer questions about | 100 `I can be reached`__ in a number of ways, I'm happy to answer questions about |
101 using coverage.py. I'm also available hourly for consultation or custom | 101 using coverage.py. |
102 development. | |
103 | 102 |
104 __ http://nedbatchelder.com/site/aboutned.html | 103 __ http://nedbatchelder.com/site/aboutned.html |
105 | 104 |
106 | 105 |
107 History | 106 History |
108 ------- | 107 ------- |
109 | 108 |
110 Coverage.py was originally written by `Gareth Rees`_. | 109 Coverage.py was originally written by `Gareth Rees`_. |
111 Since 2004, `Ned Batchelder`_ has extended and maintained it with the help of | 110 Since 2004, `Ned Batchelder`_ has extended and maintained it with the help of |
112 `many others`_. The :ref:`change history <changes>` has all the details. | 111 `many others`_. The :ref:`change history <changes>` has all the details. |
113 | 112 |
114 .. _Gareth Rees: http://garethrees.org/ | 113 .. _Gareth Rees: http://garethrees.org/ |
115 .. _Ned Batchelder: http://nedbatchelder.com | 114 .. _Ned Batchelder: http://nedbatchelder.com |
116 .. _many others: http://bitbucket.org/ned/coveragepy/src/tip/AUTHORS.txt | 115 .. _many others: http://bitbucket.org/ned/coveragepy/src/tip/AUTHORS.txt |
OLD | NEW |