[svn r37991] remove colons and change the subsecion title

--HG--
branch : trunk
This commit is contained in:
cfbolz 2007-02-06 00:53:46 +01:00
parent eb01cfa78e
commit d45b45a74e
1 changed files with 20 additions and 20 deletions

View File

@ -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.