test_ok1/doc/test/plugin/index.txt


advanced python testing
=======================

skipping_ advanced skipping for python test functions, classes or modules.

mark_ generic mechanism for marking python functions.

pdb_ interactive debugging with the Python Debugger.

figleaf_ report test coverage using the 'figleaf' package.

coverage_ (external) for testing with Ned's coverage module 

monkeypatch_ safely patch object attributes, dicts and environment variables.

capture_ configurable per-test stdout/stderr capturing mechanisms.

recwarn_ helpers for asserting deprecation and other warnings.

tmpdir_ provide temporary directories to test functions.


other testing domains, misc
===========================

oejskit_ (external) run javascript tests in real life browsers

django_ (external) for testing django applications

xdist_ loop on failing tests, distribute test runs to CPUs and hosts.

genscript_ generate standalone test script to be distributed along with an application.


reporting and failure logging
=============================

pastebin_ submit failure or test session information to a pastebin service.

logxml_ logging of test results in JUnit-XML format, for use with Hudson

xmlresult_ (external) for generating xml reports and CruiseControl integration

resultlog_ non-xml machine-readable logging of test results.

terminal_ Implements terminal reporting of the full testing process.


other testing conventions
=========================

unittest_ automatically discover and run traditional "unittest.py" style tests.

nose_ nose-compatibility plugin: allow to run nose test suites natively.

doctest_ collect and execute doctests from modules and test files.

restdoc_ perform ReST syntax, local and remote reference tests on .rst/.txt files.


core debugging / help functionality
===================================

helpconfig_ provide version info, conftest/environment config names.

hooklog_ log invocations of extension hooks to a file.


.. include:: links.txt
new cleaner layout, many improvements to docs --HG-- branch : 1.0.x 2009-07-21 00:54:08 +08:00
largely improve and reshuffle docs, heading strongly towards a 1.1.0 --HG-- branch : trunk 2009-11-05 10:18:55 +08:00			`advanced python testing`
			`=======================`
new cleaner layout, many improvements to docs --HG-- branch : 1.0.x 2009-07-21 00:54:08 +08:00
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			`skipping_ advanced skipping for python test functions, classes or modules.`
new cleaner layout, many improvements to docs --HG-- branch : 1.0.x 2009-07-21 00:54:08 +08:00
largely improve and reshuffle docs, heading strongly towards a 1.1.0 --HG-- branch : trunk 2009-11-05 10:18:55 +08:00			`mark_ generic mechanism for marking python functions.`

			`pdb_ interactive debugging with the Python Debugger.`

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			`figleaf_ report test coverage using the 'figleaf' package.`
new cleaner layout, many improvements to docs --HG-- branch : 1.0.x 2009-07-21 00:54:08 +08:00
remove figleaf which now lives "outside" --HG-- branch : trunk 2010-01-13 07:47:20 +08:00			`coverage_ (external) for testing with Ned's coverage module`
largely improve and reshuffle docs, heading strongly towards a 1.1.0 --HG-- branch : trunk 2009-11-05 10:18:55 +08:00
new cleaner layout, many improvements to docs --HG-- branch : 1.0.x 2009-07-21 00:54:08 +08:00			`monkeypatch_ safely patch object attributes, dicts and environment variables.`

rename iocapture to capture, add/remove some missing files --HG-- branch : 1.0.x 2009-08-03 18:16:12 +08:00			`capture_ configurable per-test stdout/stderr capturing mechanisms.`
new cleaner layout, many improvements to docs --HG-- branch : 1.0.x 2009-07-21 00:54:08 +08:00
			`recwarn_ helpers for asserting deprecation and other warnings.`

largely improve and reshuffle docs, heading strongly towards a 1.1.0 --HG-- branch : trunk 2009-11-05 10:18:55 +08:00			`tmpdir_ provide temporary directories to test functions.`
new cleaner layout, many improvements to docs --HG-- branch : 1.0.x 2009-07-21 00:54:08 +08:00

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			`other testing domains, misc`
			`===========================`
[mq]: 101doc --HG-- branch : 1.0.x 2009-08-19 01:04:57 +08:00
remove figleaf which now lives "outside" --HG-- branch : trunk 2010-01-13 07:47:20 +08:00			`oejskit_ (external) run javascript tests in real life browsers`
new cleaner layout, many improvements to docs --HG-- branch : 1.0.x 2009-07-21 00:54:08 +08:00
remove figleaf which now lives "outside" --HG-- branch : trunk 2010-01-13 07:47:20 +08:00			`django_ (external) for testing django applications`
new cleaner layout, many improvements to docs --HG-- branch : 1.0.x 2009-07-21 00:54:08 +08:00
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			`xdist_ loop on failing tests, distribute test runs to CPUs and hosts.`

re-arrange "py.test -h" command line option grouping and update some plugin docs. --HG-- branch : trunk 2010-01-03 19:41:29 +08:00			`genscript_ generate standalone test script to be distributed along with an application.`

finalizing doc bits for 1.0.2 --HG-- branch : 1.0.x 2009-08-27 17:43:46 +08:00
largely improve and reshuffle docs, heading strongly towards a 1.1.0 --HG-- branch : trunk 2009-11-05 10:18:55 +08:00			`reporting and failure logging`
			`=============================`
new cleaner layout, many improvements to docs --HG-- branch : 1.0.x 2009-07-21 00:54:08 +08:00
rename pocoo to "pastebin" plugin, write documentation, implement whole-session-pasting --HG-- branch : 1.0.x 2009-08-03 17:56:56 +08:00			`pastebin_ submit failure or test session information to a pastebin service.`
new cleaner layout, many improvements to docs --HG-- branch : 1.0.x 2009-07-21 00:54:08 +08:00
re-arrange "py.test -h" command line option grouping and update some plugin docs. --HG-- branch : trunk 2010-01-03 19:41:29 +08:00			`logxml_ logging of test results in JUnit-XML format, for use with Hudson`

remove figleaf which now lives "outside" --HG-- branch : trunk 2010-01-13 07:47:20 +08:00			`xmlresult_ (external) for generating xml reports and CruiseControl integration`
largely improve and reshuffle docs, heading strongly towards a 1.1.0 --HG-- branch : trunk 2009-11-05 10:18:55 +08:00
re-arrange "py.test -h" command line option grouping and update some plugin docs. --HG-- branch : trunk 2010-01-03 19:41:29 +08:00			`resultlog_ non-xml machine-readable logging of test results.`
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			`terminal_ Implements terminal reporting of the full testing process.`
new cleaner layout, many improvements to docs --HG-- branch : 1.0.x 2009-07-21 00:54:08 +08:00

largely improve and reshuffle docs, heading strongly towards a 1.1.0 --HG-- branch : trunk 2009-11-05 10:18:55 +08:00			`other testing conventions`
			`=========================`
added a pytest_helpconfig plugin which groups --version and the new "--help-config" option. rename options and configuration names. streamlines docs. --HG-- branch : 1.0.x 2009-08-19 21:45:01 +08:00
largely improve and reshuffle docs, heading strongly towards a 1.1.0 --HG-- branch : trunk 2009-11-05 10:18:55 +08:00			`unittest_ automatically discover and run traditional "unittest.py" style tests.`
added a pytest_helpconfig plugin which groups --version and the new "--help-config" option. rename options and configuration names. streamlines docs. --HG-- branch : 1.0.x 2009-08-19 21:45:01 +08:00
largely improve and reshuffle docs, heading strongly towards a 1.1.0 --HG-- branch : trunk 2009-11-05 10:18:55 +08:00			`nose_ nose-compatibility plugin: allow to run nose test suites natively.`
added a pytest_helpconfig plugin which groups --version and the new "--help-config" option. rename options and configuration names. streamlines docs. --HG-- branch : 1.0.x 2009-08-19 21:45:01 +08:00
largely improve and reshuffle docs, heading strongly towards a 1.1.0 --HG-- branch : trunk 2009-11-05 10:18:55 +08:00			`doctest_ collect and execute doctests from modules and test files.`
added a pytest_helpconfig plugin which groups --version and the new "--help-config" option. rename options and configuration names. streamlines docs. --HG-- branch : 1.0.x 2009-08-19 21:45:01 +08:00
largely improve and reshuffle docs, heading strongly towards a 1.1.0 --HG-- branch : trunk 2009-11-05 10:18:55 +08:00			`restdoc_ perform ReST syntax, local and remote reference tests on .rst/.txt files.`
added a pytest_helpconfig plugin which groups --version and the new "--help-config" option. rename options and configuration names. streamlines docs. --HG-- branch : 1.0.x 2009-08-19 21:45:01 +08:00
* reworked capturing to only capture once per runtest cycle * added readouterr() method to py.io capturing helpers --HG-- branch : 1.0.x 2009-07-31 20:21:02 +08:00
largely improve and reshuffle docs, heading strongly towards a 1.1.0 --HG-- branch : trunk 2009-11-05 10:18:55 +08:00			`core debugging / help functionality`
			`===================================`
* reworked capturing to only capture once per runtest cycle * added readouterr() method to py.io capturing helpers --HG-- branch : 1.0.x 2009-07-31 20:21:02 +08:00
largely improve and reshuffle docs, heading strongly towards a 1.1.0 --HG-- branch : trunk 2009-11-05 10:18:55 +08:00			`helpconfig_ provide version info, conftest/environment config names.`
* reworked capturing to only capture once per runtest cycle * added readouterr() method to py.io capturing helpers --HG-- branch : 1.0.x 2009-07-31 20:21:02 +08:00
			`hooklog_ log invocations of extension hooks to a file.`


regen manifest, improve docs generation --HG-- branch : 1.0.x 2009-07-31 20:43:04 +08:00			`.. include:: links.txt`