150 lines
6.3 KiB
Plaintext
150 lines
6.3 KiB
Plaintext
py.test 2.0.0: standalone, features++, implementation++, docs++
|
|
===========================================================================
|
|
|
|
XXX PENDING
|
|
|
|
Welcome to pytest-2.0.0, rapid and easy testing for and with Python.
|
|
py.test now comes as its own PyPI distribution named ``pytest`` which
|
|
installs the ``py.test`` tool. It removes most long-deprecated code,
|
|
providing for a much smaller and easier to understand code base. There
|
|
are also many new features and much improved documentation. See
|
|
|
|
http://pytest.org
|
|
|
|
for details or below for some more information.
|
|
|
|
Thanks to all issue reporters and people asking questions or
|
|
complaining. Particular thanks to Floris Bruynooghe and Ronny Pfannschmidt
|
|
for their great coding contributions.
|
|
|
|
best,
|
|
holger
|
|
|
|
|
|
New Features
|
|
-----------------------
|
|
|
|
- new invocations through Python interpreter and from Python::
|
|
|
|
python -m pytest # on all pythons >= 2.5
|
|
|
|
or from a python program::
|
|
|
|
import pytest ; pytest.main(args, plugins)
|
|
|
|
see http://pytest.org/2.0.0/usage.html for details.
|
|
|
|
- new and better reporting information in assert expressions
|
|
if comparing lists, sequences or strings.
|
|
|
|
see http://pytest.org/2.0.0/assert.html for details.
|
|
|
|
- new configuration through ini-files (setup.cfg or tox.ini recognized),
|
|
for example::
|
|
|
|
[pytest]
|
|
norecursedirs = .hg data* # don't ever recurse in such dirs
|
|
addopts = -x --pyargs # add these command line options by default
|
|
|
|
see http://pytest.org/2.0.0/customize.html
|
|
|
|
- improved standard unittest support. For example you can now run
|
|
the tests of an installed 'unittest' package with py.test::
|
|
|
|
py.test --pyargs unittest
|
|
|
|
- new "-q" option which decreases verbosity and prints a more
|
|
nose/unittest-style "dot" output.
|
|
|
|
|
|
Fixes
|
|
-----------------------
|
|
|
|
- fix issue126 - introduce py.test.set_trace() to trace execution via
|
|
PDB during the running of tests even if capturing is ongoing.
|
|
- fix issue124 - make reporting more resilient against tests opening
|
|
files on filedescriptor 1 (stdout).
|
|
- fix issue109 - sibling conftest.py files will not be loaded.
|
|
(and Directory collectors cannot be customized anymore from a Directory's
|
|
conftest.py - this needs to happen at least one level up).
|
|
- fix issue88 (finding custom test nodes from command line arg)
|
|
- fix issue93 stdout/stderr is captured while importing conftest.py
|
|
- fix bug: unittest collected functions now also can have "pytestmark"
|
|
applied at class/module level
|
|
|
|
Important Note on importing "pytest" versus "py.test"
|
|
-------------------------------------------------------
|
|
|
|
The usual way in pre-2.0 times to use py.test in python code was
|
|
to import "py" and then e.g. use "py.test.raises" for the helper.
|
|
This remains valid and is not planned to be deprecated. However,
|
|
in most examples and internal code you'll find "import pytest"
|
|
and "pytest.raises" used as the recommended default way.
|
|
|
|
(Incompatible) Removals
|
|
-----------------------------
|
|
|
|
- py.test.config is now only available if you are in a test run.
|
|
|
|
- the following (mostly already deprecated) functionality was removed:
|
|
- removed support for Module/Class/... collection node definitions
|
|
in conftest.py files. They will cause nothing special.
|
|
- removed support for calling the pre-1.0 collection API of "run()" and "join"
|
|
- removed reading option values from conftest.py files or env variables.
|
|
This can now be done much much better and easier through the ini-file
|
|
mechanism and the "addopts" entry in particular.
|
|
- removed the "disabled" attribute in test classes. Use the skipping
|
|
and pytestmark mechanism to skip or xfail a test class.
|
|
|
|
- py.test.collect.Directory does not exist anymore and it
|
|
is not possible to provide an own "Directory" object.
|
|
If you have used this and don#t know what to do, get
|
|
in contact. We'll figure someting out.
|
|
|
|
Note that pytest_collect_directory() is still called but
|
|
any return value will be ignored. This allows to keep
|
|
old code working that performed for example "py.test.skip()"
|
|
in collect() to prevent recursion into directory trees
|
|
if a certain dependency or command line option is missing.
|
|
|
|
|
|
More Detailed Changes between 1.3.4 and 2.0.0
|
|
==================================================
|
|
|
|
- pytest-2.0 is now its own package and depends on pylib-2.0
|
|
- new ability: python -m pytest / python -m pytest.main ability
|
|
- new python invcation: pytest.main(args, plugins) to load
|
|
some custom plugins early.
|
|
- try harder to run unittest test suites in a more compatible manner
|
|
by deferring setup/teardown semantics to the unittest package.
|
|
- introduce a new way to set config options via ini-style files,
|
|
by default setup.cfg and tox.ini files are searched. The old
|
|
ways (certain environment variables, dynamic conftest.py reading
|
|
is removed).
|
|
- add a new "-q" option which decreases verbosity and prints a more
|
|
nose/unittest-style "dot" output.
|
|
- fix issue126 - introduce py.test.set_trace() to trace execution via
|
|
PDB during the running of tests even if capturing is ongoing.
|
|
- fix issue123 - new "python -m py.test" invocation for py.test
|
|
(requires Python 2.5 or above)
|
|
- fix issue124 - make reporting more resilient against tests opening
|
|
files on filedescriptor 1 (stdout).
|
|
- fix issue109 - sibling conftest.py files will not be loaded.
|
|
(and Directory collectors cannot be customized anymore from a Directory's
|
|
conftest.py - this needs to happen at least one level up).
|
|
- introduce (customizable) assertion failure representations and enhance
|
|
output on assertion failures for comparisons and other cases (Floris Bruynooghe)
|
|
- nose-plugin: pass through type-signature failures in setup/teardown
|
|
functions instead of not calling them (Ed Singleton)
|
|
- remove py.test.collect.Directory (follows from a major refactoring
|
|
and simplification of the collection process)
|
|
- majorly reduce py.test core code, shift function/python testing to own plugin
|
|
- fix issue88 (finding custom test nodes from command line arg)
|
|
- refine 'tmpdir' creation, will now create basenames better associated
|
|
with test names (thanks Ronny)
|
|
- "xpass" (unexpected pass) tests don't cause exitcode!=0
|
|
- fix issue131 / issue60 - importing doctests in __init__ files used as namespace packages
|
|
- fix issue93 stdout/stderr is captured while importing conftest.py
|
|
- fix bug: unittest collected functions now also can have "pytestmark"
|
|
applied at class/module level
|