9fb2079458
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.
55 lines
1.9 KiB
Plaintext
55 lines
1.9 KiB
Plaintext
Running tests written for nose
|
|
=======================================
|
|
|
|
.. include:: links.inc
|
|
|
|
``pytest`` has basic support for running tests written for nose_.
|
|
|
|
.. _nosestyle:
|
|
|
|
Usage
|
|
-------------
|
|
|
|
After :ref:`installation` type::
|
|
|
|
python setup.py develop # make sure tests can import our package
|
|
py.test # instead of 'nosetests'
|
|
|
|
and you should be able to run your nose style tests and
|
|
make 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 / known issues
|
|
----------------------------------
|
|
|
|
- unittest-style ``setUp, tearDown, setUpClass, tearDownClass``
|
|
are recognized only on ``unittest.TestCase`` classes but not
|
|
on plain classes. ``nose`` supports these methods also on plain
|
|
classes but pytest deliberately does not. As nose and pytest already
|
|
both support ``setup_class, teardown_class, setup_method, teardown_method``
|
|
it doesn't seem useful to duplicate the unittest-API like nose does.
|
|
If you however rather think pytest should support the unittest-spelling on
|
|
plain classes please post `to this issue
|
|
<https://bitbucket.org/hpk42/pytest/issue/377/>`_.
|
|
|
|
- nose imports test modules with the same import path (e.g.
|
|
``tests.test_mod``) but different file system paths
|
|
(e.g. ``tests/test_mode.py`` and ``other/tests/test_mode.py``)
|
|
by extending sys.path/import semantics. pytest does not do that
|
|
but there is discussion in `issue268 <https://bitbucket.org/hpk42/pytest/issue/268>`_ for adding some support. Note that
|
|
`nose2 choose to avoid this sys.path/import hackery <https://nose2.readthedocs.org/en/latest/differences.html#test-discovery-and-loading>`_.
|
|
|
|
- nose-style doctests are not collected and executed correctly,
|
|
also doctest fixtures don't work.
|
|
|
|
- no nose-configuration is recognized
|
|
|