summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorNed Batchelder <ned@nedbatchelder.com>2016-11-26 10:24:34 -0500
committerNed Batchelder <ned@nedbatchelder.com>2016-11-26 10:24:34 -0500
commita72ae361b0a9049b5a9b90e7af5a299032af7187 (patch)
tree9a3277ad5858ce11502da2a2e39b999885245864 /doc
parent9dec07e671f911ebd1ce6f6dfafc524c2ae57169 (diff)
downloadpython-coveragepy-a72ae361b0a9049b5a9b90e7af5a299032af7187.tar.gz
Updates for pytest
Diffstat (limited to 'doc')
-rw-r--r--doc/contributing.rst90
1 files changed, 46 insertions, 44 deletions
diff --git a/doc/contributing.rst b/doc/contributing.rst
index 472f7ce..f6155ca 100644
--- a/doc/contributing.rst
+++ b/doc/contributing.rst
@@ -67,51 +67,49 @@ The tests are written as standard unittest-style tests, and are run with
`tox`_::
$ tox
- py27 create: /Users/ned/coverage/trunk/.tox/py27
- py27 installdeps: nose==1.3.7, mock==1.3.0, PyContracts==1.7.6, gevent==1.0.2, eventlet==0.17.4, greenlet==0.4.7
- py27 develop-inst: /Users/ned/coverage/trunk
- py27 installed: -f /Users/ned/Downloads/local_pypi,-e hg+ssh://hg@bitbucket.org/ned/coveragepy@22fe9a2b7796f6498aa013c860c268ac21651226#egg=coverage-dev,decorator==4.0.2,eventlet==0.17.4,funcsigs==0.4,gevent==1.0.2,greenlet==0.4.7,mock==1.3.0,nose==1.3.7,pbr==1.6.0,PyContracts==1.7.6,pyparsing==2.0.3,six==1.9.0,wheel==0.24.0
- py27 runtests: PYTHONHASHSEED='1294330776'
+ py27 develop-inst-noop: /Users/ned/coverage/trunk
+ py27 installed: apipkg==1.4,-e hg+ssh://hg@bitbucket.org/ned/coveragepy@6664140e34beddd6fee99b729bb9f4545a429c12#egg=coverage,covtestegg1==0.0.0,decorator==4.0.10,eventlet==0.19.0,execnet==1.4.1,funcsigs==1.0.2,gevent==1.1.2,greenlet==0.4.10,mock==2.0.0,pbr==1.10.0,py==1.4.31,PyContracts==1.7.12,pyparsing==2.1.10,pytest==3.0.5.dev0,pytest-warnings==0.2.0,pytest-xdist==1.15.0,six==1.10.0,unittest-mixins==1.1.1
+ py27 runtests: PYTHONHASHSEED='4113423111'
py27 runtests: commands[0] | python setup.py --quiet clean develop
+ no previously-included directories found matching 'tests/eggsrc/dist'
+ no previously-included directories found matching 'tests/eggsrc/*.egg-info'
py27 runtests: commands[1] | python igor.py zip_mods install_egg remove_extension
py27 runtests: commands[2] | python igor.py test_with_tracer py
- === CPython 2.7.10 with Python tracer (.tox/py27/bin/python) ===
- ............................................................................(etc)
- ----------------------------------------------------------------------
- Ran 592 tests in 65.524s
-
- OK (SKIP=20)
+ === CPython 2.7.12 with Python tracer (.tox/py27/bin/python) ===
+ gw0 [679] / gw1 [679] / gw2 [679]
+ scheduling tests via LoadScheduling
+ ...........ss...................................................................................ss...s.......s...........................s...............................................................................s.....................................................................................................................................................s.........................................................................................s.s.s.s.s.ssssssssssss.ss..................................................s...................................................................s..............................................................................
+ 649 passed, 30 skipped in 42.89 seconds
py27 runtests: commands[3] | python setup.py --quiet build_ext --inplace
py27 runtests: commands[4] | python igor.py test_with_tracer c
- === CPython 2.7.10 with C tracer (.tox/py27/bin/python) ===
- ............................................................................(etc)
- ----------------------------------------------------------------------
- Ran 592 tests in 69.635s
-
- OK (SKIP=4)
- py33 create: /Users/ned/coverage/trunk/.tox/py33
- py33 installdeps: nose==1.3.7, mock==1.3.0, PyContracts==1.7.6, greenlet==0.4.7
- py33 develop-inst: /Users/ned/coverage/trunk
- py33 installed: -f /Users/ned/Downloads/local_pypi,-e hg+ssh://hg@bitbucket.org/ned/coveragepy@22fe9a2b7796f6498aa013c860c268ac21651226#egg=coverage-dev,decorator==4.0.2,greenlet==0.4.7,mock==1.3.0,nose==1.3.7,pbr==1.6.0,PyContracts==1.7.6,pyparsing==2.0.3,six==1.9.0,wheel==0.24.0
- py33 runtests: PYTHONHASHSEED='1294330776'
- py33 runtests: commands[0] | python setup.py --quiet clean develop
- py33 runtests: commands[1] | python igor.py zip_mods install_egg remove_extension
- py33 runtests: commands[2] | python igor.py test_with_tracer py
- === CPython 3.3.6 with Python tracer (.tox/py33/bin/python) ===
- ............................................S...............................(etc)
- ----------------------------------------------------------------------
- Ran 592 tests in 73.007s
-
- OK (SKIP=22)
- py33 runtests: commands[3] | python setup.py --quiet build_ext --inplace
- py33 runtests: commands[4] | python igor.py test_with_tracer c
- === CPython 3.3.6 with C tracer (.tox/py33/bin/python) ===
- ............................................S...............................(etc)
- ----------------------------------------------------------------------
- Ran 592 tests in 72.071s
-
- OK (SKIP=5)
- (and so on...)
+ === CPython 2.7.12 with C tracer (.tox/py27/bin/python) ===
+ gw0 [679] / gw1 [679] / gw2 [679]
+ scheduling tests via LoadScheduling
+ ............ss................................................................................s..s.....s......s.........................s..........................................................................................s............................................................................................................s............................................................................................................................s...................................................................s........................................................................s............................................................................
+ 667 passed, 12 skipped in 41.87 seconds
+ py35 develop-inst-noop: /Users/ned/coverage/trunk
+ py35 installed: apipkg==1.4,-e hg+ssh://hg@bitbucket.org/ned/coveragepy@6664140e34beddd6fee99b729bb9f4545a429c12#egg=coverage,covtestegg1==0.0.0,decorator==4.0.10,eventlet==0.19.0,execnet==1.4.1,gevent==1.1.2,greenlet==0.4.10,mock==2.0.0,pbr==1.10.0,py==1.4.31,PyContracts==1.7.12,pyparsing==2.1.10,pytest==3.0.5.dev0,pytest-warnings==0.2.0,pytest-xdist==1.15.0,six==1.10.0,unittest-mixins==1.1.1
+ py35 runtests: PYTHONHASHSEED='4113423111'
+ py35 runtests: commands[0] | python setup.py --quiet clean develop
+ no previously-included directories found matching 'tests/eggsrc/dist'
+ no previously-included directories found matching 'tests/eggsrc/*.egg-info'
+ py35 runtests: commands[1] | python igor.py zip_mods install_egg remove_extension
+ py35 runtests: commands[2] | python igor.py test_with_tracer py
+ === CPython 3.5.2 with Python tracer (.tox/py35/bin/python) ===
+ gw0 [679] / gw1 [679] / gw2 [679]
+ scheduling tests via LoadScheduling
+ ............s..........................................................................................................................................................s..s...........................................................................................................................................................................................s.................................................................................................sssssssssssssssssss............................................................s................................................................s..............................................................................
+ 654 passed, 25 skipped in 47.25 seconds
+ py35 runtests: commands[3] | python setup.py --quiet build_ext --inplace
+ py35 runtests: commands[4] | python igor.py test_with_tracer c
+ === CPython 3.5.2 with C tracer (.tox/py35/bin/python) ===
+ gw0 [679] / gw1 [679] / gw2 [679]
+ scheduling tests via LoadScheduling
+ ...........s...............................................................................................................................................................................................s......s..........................................................................................................................................................s.................................................................................................s....................................................................................................................................s..................................................................................
+ 673 passed, 6 skipped in 53.20 seconds
+ _________________________________________________________________________________________ summary __________________________________________________________________________________________
+ py27: commands succeeded
+ py35: commands succeeded
Tox runs the complete test suite twice for each version of Python you have
installed. The first run uses the Python implementation of the trace function,
@@ -121,16 +119,20 @@ To limit tox to just a few versions of Python, use the ``-e`` switch::
$ tox -e py27,py33
-To run just a few tests, you can use nose test selector syntax::
+To run just a few tests, you can use `pytest test selectors`_::
- $ tox tests.test_misc:SetupPyTest.test_metadata
+ $ tox tests/test_misc.py
+ $ tox tests/test_misc.py::SetupPyTest
+ $ tox tests/test_misc.py::SetupPyTest::test_metadata
-This looks in `tests/test_misc.py` to find the `SetupPyTest` class, and runs
-the `test_metadata` test method.
+These command run the tests in one file, one class, and just one test,
+respectively.
Of course, run all the tests on every version of Python you have, before
submitting a change.
+.. _pytest test selectors: http://doc.pytest.org/en/latest/usage.html#specifying-tests-selecting-tests
+
Lint, etc
---------