[svn r37991] remove colons and change the subsecion title
--HG-- branch : trunk
This commit is contained in:
parent
eb01cfa78e
commit
d45b45a74e
|
@ -376,77 +376,77 @@ Some ``py.test`` command-line options
|
||||||
Regular options
|
Regular options
|
||||||
---------------
|
---------------
|
||||||
|
|
||||||
``-v, --verbose``:
|
``-v, --verbose``
|
||||||
|
|
||||||
Increase verbosity. This shows a test per line while running and also
|
Increase verbosity. This shows a test per line while running and also
|
||||||
shows the traceback after interrupting the test run with Ctrl-C.
|
shows the traceback after interrupting the test run with Ctrl-C.
|
||||||
|
|
||||||
|
|
||||||
``-x, --exitfirst``:
|
``-x, --exitfirst``
|
||||||
|
|
||||||
exit instantly on the first error or the first failed test.
|
exit instantly on the first error or the first failed test.
|
||||||
|
|
||||||
|
|
||||||
``-s, --nocapture``:
|
``-s, --nocapture``
|
||||||
|
|
||||||
disable catching of sys.stdout/stderr output.
|
disable catching of sys.stdout/stderr output.
|
||||||
|
|
||||||
|
|
||||||
``-k KEYWORD``:
|
``-k KEYWORD``
|
||||||
|
|
||||||
only run test items matching the given keyword expression. You can also add
|
only run test items matching the given keyword expression. You can also add
|
||||||
use ``-k -KEYWORD`` to exlude tests from being run. The keyword is matched
|
use ``-k -KEYWORD`` to exlude tests from being run. The keyword is matched
|
||||||
against filename, test class name, method name.
|
against filename, test class name, method name.
|
||||||
|
|
||||||
|
|
||||||
``-l, --showlocals``:
|
``-l, --showlocals``
|
||||||
show locals in tracebacks: for every frame in the traceback, show the values
|
show locals in tracebacks: for every frame in the traceback, show the values
|
||||||
of the local variables.
|
of the local variables.
|
||||||
|
|
||||||
|
|
||||||
``--pdb``:
|
``--pdb``
|
||||||
|
|
||||||
drop into pdb (the `Python debugger`_) on exceptions. If the debugger is
|
drop into pdb (the `Python debugger`_) on exceptions. If the debugger is
|
||||||
quitted, the next test is run. This implies ``-s``.
|
quitted, the next test is run. This implies ``-s``.
|
||||||
|
|
||||||
|
|
||||||
``--tb=TBSTYLE``:
|
``--tb=TBSTYLE``
|
||||||
|
|
||||||
traceback verboseness: ``long`` is the default, ``short`` are the normal
|
traceback verboseness: ``long`` is the default, ``short`` are the normal
|
||||||
Python tracebacks, ``no`` omits tracebacks completely.
|
Python tracebacks, ``no`` omits tracebacks completely.
|
||||||
|
|
||||||
|
|
||||||
``--fulltrace``:
|
``--fulltrace``
|
||||||
|
|
||||||
Don't cut any tracebacks. The default is to leave out frames if an infinite
|
Don't cut any tracebacks. The default is to leave out frames if an infinite
|
||||||
recursion is detected.
|
recursion is detected.
|
||||||
|
|
||||||
|
|
||||||
``--nomagic``:
|
``--nomagic``
|
||||||
|
|
||||||
Refrain from using magic as much as possible. This can be useful if you are
|
Refrain from using magic as much as possible. This can be useful if you are
|
||||||
suspicious that ``py.test`` somehow interferes with your program in
|
suspicious that ``py.test`` somehow interferes with your program in
|
||||||
unintended ways (if this is the case, please contact us!).
|
unintended ways (if this is the case, please contact us!).
|
||||||
|
|
||||||
|
|
||||||
``--collectonly``:
|
``--collectonly``
|
||||||
|
|
||||||
Only collect tests, don't execute them.
|
Only collect tests, don't execute them.
|
||||||
|
|
||||||
|
|
||||||
``--traceconfig``:
|
``--traceconfig``
|
||||||
|
|
||||||
trace considerations of conftest.py files. Useful when you have various
|
trace considerations of conftest.py files. Useful when you have various
|
||||||
conftest.py files around and are unsure about their interaction.
|
conftest.py files around and are unsure about their interaction.
|
||||||
|
|
||||||
|
|
||||||
More experimental options
|
experimental options
|
||||||
-------------------------
|
--------------------
|
||||||
|
|
||||||
**Note**: these options could change in the future.
|
**Note**: these options could change in the future.
|
||||||
|
|
||||||
|
|
||||||
``-f, --looponfailing``:
|
``-f, --looponfailing``
|
||||||
|
|
||||||
Loop on failing test set. This is a feature you can use when you are trying
|
Loop on failing test set. This is a feature you can use when you are trying
|
||||||
to fix a number of failing tests: First all the tests are being run. If a
|
to fix a number of failing tests: First all the tests are being run. If a
|
||||||
|
@ -455,34 +455,34 @@ More experimental options
|
||||||
testing for is changed. If one of the previously failing tests now passes,
|
testing for is changed. If one of the previously failing tests now passes,
|
||||||
it is removed from the test set.
|
it is removed from the test set.
|
||||||
|
|
||||||
``--exec=EXECUTABLE``:
|
``--exec=EXECUTABLE``
|
||||||
|
|
||||||
Python executable to run the tests with. Useful for testing on different
|
Python executable to run the tests with. Useful for testing on different
|
||||||
versions of Python.
|
versions of Python.
|
||||||
|
|
||||||
|
|
||||||
``-d, --dist``:
|
``-d, --dist``
|
||||||
|
|
||||||
ad-hoc `distribute tests across machines`_ (requires conftest settings)
|
ad-hoc `distribute tests across machines`_ (requires conftest settings)
|
||||||
|
|
||||||
|
|
||||||
``-w, --startserver``:
|
``-w, --startserver``
|
||||||
|
|
||||||
starts local web server for displaying test progress.
|
starts local web server for displaying test progress.
|
||||||
|
|
||||||
|
|
||||||
``-r, --runbrowser``:
|
``-r, --runbrowser``
|
||||||
|
|
||||||
Run browser (implies --startserver).
|
Run browser (implies --startserver).
|
||||||
|
|
||||||
|
|
||||||
``--box``:
|
``--box``
|
||||||
|
|
||||||
Use boxing: run each test in an external process. Very useful for testing
|
Use boxing: run each test in an external process. Very useful for testing
|
||||||
things that occasionally segfault (since normally the segfault then would
|
things that occasionally segfault (since normally the segfault then would
|
||||||
stop the whole test process).
|
stop the whole test process).
|
||||||
|
|
||||||
``--rest``:
|
``--rest``
|
||||||
|
|
||||||
`reStructured Text`_ output reporting.
|
`reStructured Text`_ output reporting.
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue