test_ok1/doc/test/plugin/terminal.txt


Implements terminal reporting of the full testing process.
==========================================================


.. contents::
  :local:

This is a good source for looking at the various reporting hooks.

command line options
--------------------


``-v, --verbose``
    increase verbosity.
``-r chars``
    show extra test summary info as specified by chars (f)ailed, (s)skipped, (x)failed, (X)passed.
``-l, --showlocals``
    show locals in tracebacks (disabled by default).
``--report=opts``
    (deprecated, use -r)
``--tb=style``
    traceback print mode (long/short/line/no).
``--fulltrace``
    don't cut any tracebacks (default is to cut).
``--funcargs``
    show available function arguments, sorted by plugin

Start improving this plugin in 30 seconds
=========================================


1. Download `pytest_terminal.py`_ plugin source code
2. put it somewhere as ``pytest_terminal.py`` into your import path
3. a subsequent ``py.test`` run will use your local version

Checkout customize_, other plugins_ or `get in contact`_.

.. include:: links.txt
new cleaner layout, many improvements to docs --HG-- branch : 1.0.x 2009-07-21 00:54:08 +08:00
update docs, leave out internal plugins --HG-- branch : 1.0.x 2009-07-22 22:09:49 +08:00			`Implements terminal reporting of the full testing process.`
remove dist-testing and looponfail code from core. there remain some (pytest_runner particularly) tests that test both plain and dist modes which cannot be easily dis-entangled. food for thought. --HG-- branch : trunk 2010-01-13 23:00:33 +08:00			`==========================================================`

new cleaner layout, many improvements to docs --HG-- branch : 1.0.x 2009-07-21 00:54:08 +08:00
update docs, leave out internal plugins --HG-- branch : 1.0.x 2009-07-22 22:09:49 +08:00			`.. contents::`
			`:local:`
new cleaner layout, many improvements to docs --HG-- branch : 1.0.x 2009-07-21 00:54:08 +08:00
update docs, leave out internal plugins --HG-- branch : 1.0.x 2009-07-22 22:09:49 +08:00			`This is a good source for looking at the various reporting hooks.`
new cleaner layout, many improvements to docs --HG-- branch : 1.0.x 2009-07-21 00:54:08 +08:00
showing relative paths by default, improving xfail output a bit, bumping version info to 1.0.0 --HG-- branch : 1.0.x 2009-08-03 22:01:32 +08:00			`command line options`
			`--------------------`


refine naming, API and docs for py.test.mark mechanism - now contained in pytest_mark plugin --HG-- branch : trunk 2009-10-23 02:57:21 +08:00			``-v, --verbose``
			`increase verbosity.`
updating docs --HG-- branch : trunk 2010-05-06 03:01:54 +08:00			``-r chars``
			`show extra test summary info as specified by chars (f)ailed, (s)skipped, (x)failed, (X)passed.`
refine naming, API and docs for py.test.mark mechanism - now contained in pytest_mark plugin --HG-- branch : trunk 2009-10-23 02:57:21 +08:00			``-l, --showlocals``
			`show locals in tracebacks (disabled by default).`
			``--report=opts``
updating docs --HG-- branch : trunk 2010-05-06 03:01:54 +08:00			`(deprecated, use -r)`
refine naming, API and docs for py.test.mark mechanism - now contained in pytest_mark plugin --HG-- branch : trunk 2009-10-23 02:57:21 +08:00			``--tb=style``
fix docs to not point to a downloadable plugin if the plugin is external (thanks to prologic for feedbacking on this confusion) --HG-- branch : trunk 2010-02-10 21:21:49 +08:00			`traceback print mode (long/short/line/no).`
refine naming, API and docs for py.test.mark mechanism - now contained in pytest_mark plugin --HG-- branch : trunk 2009-10-23 02:57:21 +08:00			``--fulltrace``
			`don't cut any tracebacks (default is to cut).`
fix docs to not point to a downloadable plugin if the plugin is external (thanks to prologic for feedbacking on this confusion) --HG-- branch : trunk 2010-02-10 21:21:49 +08:00			``--funcargs``
			`show available function arguments, sorted by plugin`
showing relative paths by default, improving xfail output a bit, bumping version info to 1.0.0 --HG-- branch : 1.0.x 2009-08-03 22:01:32 +08:00
update docs, leave out internal plugins --HG-- branch : 1.0.x 2009-07-22 22:09:49 +08:00			`Start improving this plugin in 30 seconds`
			`=========================================`
new cleaner layout, many improvements to docs --HG-- branch : 1.0.x 2009-07-21 00:54:08 +08:00

remove trailing whitespace everywhere --HG-- branch : trunk 2010-07-27 03:15:15 +08:00			1. Download `pytest_terminal.py`_ plugin source code
			2. put it somewhere as ``pytest_terminal.py`` into your import path
update docs, leave out internal plugins --HG-- branch : 1.0.x 2009-07-22 22:09:49 +08:00			3. a subsequent ``py.test`` run will use your local version
new cleaner layout, many improvements to docs --HG-- branch : 1.0.x 2009-07-21 00:54:08 +08:00
remove trailing whitespace everywhere --HG-- branch : trunk 2010-07-27 03:15:15 +08:00			Checkout customize_, other plugins_ or `get in contact`_.
new cleaner layout, many improvements to docs --HG-- branch : 1.0.x 2009-07-21 00:54:08 +08:00
regen manifest, improve docs generation --HG-- branch : 1.0.x 2009-07-31 20:43:04 +08:00			`.. include:: links.txt`