p53209761
/
test_ok2
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Document single-method usage 

It is possible to run a single test method in a class, but the syntax is
not glaringly obvious and documentation would help people out.
This commit is contained in:
Evan Bender 2015-09-04 15:11:57 -04:00
parent 8625eb643e
commit 6ffb659282
1 changed files with 5 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
doc/en/usage.rst
View File

@ -46,12 +46,14 @@ Several test run options::
py.test test_mod.py # run tests in module py.test test_mod.py # run tests in module
py.test somepath # run all tests below somepath py.test somepath # run all tests below somepath
py.test -k stringexpr # only run tests with names that match the py.test -k stringexpr # only run tests with names that match the
# the "string expression", e.g. "MyClass and not method" # the "string expression", e.g. "MyClass and not method"
# will select TestMyClass.test_something # will select TestMyClass.test_something
# but not TestMyClass.test_method_simple # but not TestMyClass.test_method_simple
py.test test_mod.py::test_func # only run tests that match the "node ID", py.test test_mod.py::test_func # only run tests that match the "node ID",
# e.g "test_mod.py::test_func" will select # e.g "test_mod.py::test_func" will select
# only test_func in test_mod.py # only test_func in test_mod.py
py.test test_mod.py::TestClass::test_method # run a single method in
# a single class
Import 'pkg' and use its filesystem location to find and run tests:: Import 'pkg' and use its filesystem location to find and run tests::
@ -87,7 +89,7 @@ failure situation::
py.test -x --pdb # drop to PDB on first failure, then end test session py.test -x --pdb # drop to PDB on first failure, then end test session
py.test --pdb --maxfail=3 # drop to PDB for first three failures py.test --pdb --maxfail=3 # drop to PDB for first three failures
Note that on any failure the exception information is stored on Note that on any failure the exception information is stored on
``sys.last_value``, ``sys.last_type`` and ``sys.last_traceback``. In ``sys.last_value``, ``sys.last_type`` and ``sys.last_traceback``. In
interactive use, this allows one to drop into postmortem debugging with interactive use, this allows one to drop into postmortem debugging with
any debug tool. One can also manually access the exception information, any debug tool. One can also manually access the exception information,
@ -260,6 +262,6 @@ hook was invoked::
$ python myinvoke.py $ python myinvoke.py
*** test run reporting finishing *** test run reporting finishing
.. include:: links.inc .. include:: links.inc