Ned Batchelder avatar Ned Batchelder committed 1329905

A new page for known big problems, for #226.

Comments (0)

Files changed (2)

     subprocess
     api
     contributing
+    trouble
     faq
     changes
 
+.. _trouble:
+
+====================
+When things go wrong
+====================
+
+Coverage works pretty well, but occasionally things don't go as you would like.
+This page details problems, with links to coverage.py bug reports if
+appropriate.
+
+You can of course search the `coverage.py bug tracker`_ directly to see if 
+there is some mention of your problem.
+
+.. _coverage.py bug tracker: https://bitbucket.org/ned/coveragepy/issues?status=new&status=open
+
+
+Kryptonite
+----------
+
+There are a number of popular packages that prevent coverage.py from working 
+properly.  
+
+* gevent, `issue 149`_.
+
+* execv, or one of its variants, `issue 43`_.
+
+* multiprocessing, `issue 117`_.
+
+Code is marked as not executed when I know it is.
+
+link to DecoratorTools, TurboGears
+
+Try --timid
+
+psyco is an issue?
+
+.. _issue 43: https://bitbucket.org/ned/coveragepy/issue/43/coverage-measurement-fails-on-code
+.. _issue 117: https://bitbucket.org/ned/coveragepy/issue/117/enable-coverage-measurement-of-code-run-by
+.. _issue 149: https://bitbucket.org/ned/coveragepy/issue/149/coverage-gevent-looks-broken
+
+
+Really obscure stuff
+--------------------
+
+* Python 2.5 had a bug (`1569356`_) that could make your program behave
+  differently when being measured with coverage.  This is diagnosed in `issue 51`_.
+
+.. _issue 51: http://bitbucket.org/ned/coveragepy/issue/51/turbogears-15-test-failing-with-coverage
+.. _1569356: http://bugs.python.org/issue1569356
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.