diff options
| author | Ned Batchelder <ned@nedbatchelder.com> | 2012-12-31 08:51:13 -0500 |
|---|---|---|
| committer | Ned Batchelder <ned@nedbatchelder.com> | 2012-12-31 08:51:13 -0500 |
| commit | 60e826db58659f42848dbbb847c986d485db9d3f (patch) | |
| tree | 9127192d4c8d6e8005e0497de1c9467f0411b233 | |
| parent | 6c2594a41d99ead5c6734ed62f6fc0db21750ccb (diff) | |
| download | python-coveragepy-git-60e826db58659f42848dbbb847c986d485db9d3f.tar.gz | |
A new page for known big problems, for #226.
| -rw-r--r-- | doc/index.rst | 1 | ||||
| -rw-r--r-- | doc/trouble.rst | 49 |
2 files changed, 50 insertions, 0 deletions
diff --git a/doc/index.rst b/doc/index.rst index 319e525b..9d085302 100644 --- a/doc/index.rst +++ b/doc/index.rst @@ -159,6 +159,7 @@ More information subprocess api contributing + trouble faq changes diff --git a/doc/trouble.rst b/doc/trouble.rst new file mode 100644 index 00000000..9d021de4 --- /dev/null +++ b/doc/trouble.rst @@ -0,0 +1,49 @@ +.. _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 |