test_ok1/doc/en/test/plugin/nose.rst


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


.. contents::
  :local:

This is an experimental plugin for allowing to run tests written
in 'nosetests' style with ``pytest``.

Usage
-------------

type::

    pytest  # instead of 'nosetests'

and you should be able to run nose style tests and at the same
time can make full use of pytest's capabilities.

Supported nose Idioms
----------------------

* setup and teardown at module/class/method level
* SkipTest exceptions and markers
* setup/teardown decorators
* yield-based tests and their setup
* general usage of nose utilities

Unsupported idioms / issues
----------------------------------

- nose-style doctests are not collected and executed correctly,
  also fixtures don't work.

- no nose-configuration is recognized

If you find other issues or have suggestions please run::

    pytest --pastebin=all

and send the resulting URL to a ``pytest`` contact channel,
at best to the mailing list.

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


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

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

.. include:: links.txt
* add pytest_nose plugin * have unittest functions always receive a fresh instance --HG-- branch : 1.0.x 2009-08-10 17:27:13 +08:00
			`nose-compatibility plugin: allow to run nose test suites natively.`
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			`==================================================================`

* add pytest_nose plugin * have unittest functions always receive a fresh instance --HG-- branch : 1.0.x 2009-08-10 17:27:13 +08:00
			`.. contents::`
			`:local:`

remove trailing whitespace everywhere --HG-- branch : trunk 2010-07-27 03:15:15 +08:00			`This is an experimental plugin for allowing to run tests written`
replace py.test module references with pytest The only remaining 'py.test' references are: * those referring to the 'py.test' executable * those in code explicitly testing py.test/pytest module compatibility * those in old CHANGES documentation * those in documentation generated based on external data * those in seemingly unfinished & unmaintained Japanese documentation Minor stylistic changes and typo corrections made to documentation next to several applied py.test --> pytest content changes. 2014-01-18 19:31:33 +08:00			in 'nosetests' style with ``pytest``.
* add pytest_nose plugin * have unittest functions always receive a fresh instance --HG-- branch : 1.0.x 2009-08-10 17:27:13 +08:00
			`Usage`
			`-------------`

enable nose by default --HG-- branch : 1.0.x 2009-08-19 23:53:08 +08:00			`type::`
* add pytest_nose plugin * have unittest functions always receive a fresh instance --HG-- branch : 1.0.x 2009-08-10 17:27:13 +08:00
Introduce pytest command as recommended entry point Fixes #1629 2016-06-21 22:16:57 +08:00			`pytest # instead of 'nosetests'`
* add pytest_nose plugin * have unittest functions always receive a fresh instance --HG-- branch : 1.0.x 2009-08-10 17:27:13 +08:00
merged ronny's nose-compatibility hacks, i.e. nosestyle setup_module() and setup() functions are supported. added a few notes to changelog and documentation about it --HG-- branch : trunk 2009-10-27 23:49:38 +08:00			`and you should be able to run nose style tests and at the same`
replace py.test module references with pytest The only remaining 'py.test' references are: * those referring to the 'py.test' executable * those in code explicitly testing py.test/pytest module compatibility * those in old CHANGES documentation * those in documentation generated based on external data * those in seemingly unfinished & unmaintained Japanese documentation Minor stylistic changes and typo corrections made to documentation next to several applied py.test --> pytest content changes. 2014-01-18 19:31:33 +08:00			`time can make full use of pytest's capabilities.`
* add pytest_nose plugin * have unittest functions always receive a fresh instance --HG-- branch : 1.0.x 2009-08-10 17:27:13 +08:00
merged ronny's nose-compatibility hacks, i.e. nosestyle setup_module() and setup() functions are supported. added a few notes to changelog and documentation about it --HG-- branch : trunk 2009-10-27 23:49:38 +08:00			`Supported nose Idioms`
			`----------------------`
* add pytest_nose plugin * have unittest functions always receive a fresh instance --HG-- branch : 1.0.x 2009-08-10 17:27:13 +08:00
merged ronny's nose-compatibility hacks, i.e. nosestyle setup_module() and setup() functions are supported. added a few notes to changelog and documentation about it --HG-- branch : trunk 2009-10-27 23:49:38 +08:00			`* setup and teardown at module/class/method level`
remove trailing whitespace everywhere --HG-- branch : trunk 2010-07-27 03:15:15 +08:00			`* SkipTest exceptions and markers`
merged ronny's nose-compatibility hacks, i.e. nosestyle setup_module() and setup() functions are supported. added a few notes to changelog and documentation about it --HG-- branch : trunk 2009-10-27 23:49:38 +08:00			`* setup/teardown decorators`
remove trailing whitespace everywhere --HG-- branch : trunk 2010-07-27 03:15:15 +08:00			`* yield-based tests and their setup`
			`* general usage of nose utilities`
* add pytest_nose plugin * have unittest functions always receive a fresh instance --HG-- branch : 1.0.x 2009-08-10 17:27:13 +08:00
merged ronny's nose-compatibility hacks, i.e. nosestyle setup_module() and setup() functions are supported. added a few notes to changelog and documentation about it --HG-- branch : trunk 2009-10-27 23:49:38 +08:00			`Unsupported idioms / issues`
			`----------------------------------`
* add pytest_nose plugin * have unittest functions always receive a fresh instance --HG-- branch : 1.0.x 2009-08-10 17:27:13 +08:00
			`- nose-style doctests are not collected and executed correctly,`
remove trailing whitespace everywhere --HG-- branch : trunk 2010-07-27 03:15:15 +08:00			`also fixtures don't work.`
enable nose by default --HG-- branch : 1.0.x 2009-08-19 23:53:08 +08:00
remove trailing whitespace everywhere --HG-- branch : trunk 2010-07-27 03:15:15 +08:00			`- no nose-configuration is recognized`
merged ronny's nose-compatibility hacks, i.e. nosestyle setup_module() and setup() functions are supported. added a few notes to changelog and documentation about it --HG-- branch : trunk 2009-10-27 23:49:38 +08:00
remove trailing whitespace everywhere --HG-- branch : trunk 2010-07-27 03:15:15 +08:00			`If you find other issues or have suggestions please run::`
merged ronny's nose-compatibility hacks, i.e. nosestyle setup_module() and setup() functions are supported. added a few notes to changelog and documentation about it --HG-- branch : trunk 2009-10-27 23:49:38 +08:00
Introduce pytest command as recommended entry point Fixes #1629 2016-06-21 22:16:57 +08:00			`pytest --pastebin=all`
merged ronny's nose-compatibility hacks, i.e. nosestyle setup_module() and setup() functions are supported. added a few notes to changelog and documentation about it --HG-- branch : trunk 2009-10-27 23:49:38 +08:00
replace py.test module references with pytest The only remaining 'py.test' references are: * those referring to the 'py.test' executable * those in code explicitly testing py.test/pytest module compatibility * those in old CHANGES documentation * those in documentation generated based on external data * those in seemingly unfinished & unmaintained Japanese documentation Minor stylistic changes and typo corrections made to documentation next to several applied py.test --> pytest content changes. 2014-01-18 19:31:33 +08:00			and send the resulting URL to a ``pytest`` contact channel,
merged ronny's nose-compatibility hacks, i.e. nosestyle setup_module() and setup() functions are supported. added a few notes to changelog and documentation about it --HG-- branch : trunk 2009-10-27 23:49:38 +08:00			`at best to the mailing list.`
* add pytest_nose plugin * have unittest functions always receive a fresh instance --HG-- branch : 1.0.x 2009-08-10 17:27:13 +08:00
			`Start improving this plugin in 30 seconds`
			`=========================================`


remove trailing whitespace everywhere --HG-- branch : trunk 2010-07-27 03:15:15 +08:00			1. Download `pytest_nose.py`_ plugin source code
			2. put it somewhere as ``pytest_nose.py`` into your import path
replace py.test module references with pytest The only remaining 'py.test' references are: * those referring to the 'py.test' executable * those in code explicitly testing py.test/pytest module compatibility * those in old CHANGES documentation * those in documentation generated based on external data * those in seemingly unfinished & unmaintained Japanese documentation Minor stylistic changes and typo corrections made to documentation next to several applied py.test --> pytest content changes. 2014-01-18 19:31:33 +08:00			3. a subsequent ``pytest`` run will use your local version
* add pytest_nose plugin * have unittest functions always receive a fresh instance --HG-- branch : 1.0.x 2009-08-10 17:27:13 +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`_.
* add pytest_nose plugin * have unittest functions always receive a fresh instance --HG-- branch : 1.0.x 2009-08-10 17:27:13 +08:00
			`.. include:: links.txt`