[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