Document --full-trace option and KeyboardInterrupt

fix #513
This commit is contained in:
Omar Kohl 2016-03-20 19:53:02 +01:00
parent a341dddc74
commit 98c707561c
1 changed files with 8 additions and 0 deletions

View File

@ -74,6 +74,14 @@ Examples for modifying traceback printing::
py.test --tb=native # Python standard library formatting
py.test --tb=no # no traceback at all
The ``--full-trace`` causes very long traces to be printed on error (longer
than ``--tb=long``). It also ensures that a stack trace is printed on
**KeyboardInterrrupt** (Ctrl+C).
This is very useful if the tests are taking too long and you interrupt them
with Ctrl+C to find out where the tests are *hanging*. By default no output
will be shown (because KeyboardInterrupt is catched by pytest). By using this
option you make sure a trace is shown.
Dropping to PDB_ (Python Debugger) on failures
-----------------------------------------------