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

[svn r61961] improve documentation about "-k" keyword handling. 

--HG--
branch : trunk
This commit is contained in:
hpk 2009-02-17 09:56:29 +01:00
parent 51e14dd1b0
commit 186c2610cd
2 changed files with 18 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
py/doc/test.txt
View File

@ -139,8 +139,8 @@ To make it easier to distinguish the generated tests it is possible to specify a
.. _`selection by keyword`: .. _`selection by keyword`:
selecting tests by keyword selecting/unselecting tests by keyword
-------------------------- ---------------------------------------------
You can selectively run tests by specifiying a keyword You can selectively run tests by specifiying a keyword
on the command line. Example:: on the command line. Example::
@ -151,10 +151,20 @@ will run all tests that are found from the current directory
and where the word "test_simple" equals the start of one part of the and where the word "test_simple" equals the start of one part of the
path leading up to the test item. Directory and file basenames as well path leading up to the test item. Directory and file basenames as well
as function, class and function/method names each form a possibly as function, class and function/method names each form a possibly
matching name. matching name. You can also unselect tests by preceding a keyword
with a dash::
Note that the exact semantics are still experimental but py.test. -k "-test_simple"
should always remain intuitive.
will run all tests except where the word "test_simple" matches a tests keyword.
Note that you need to quote the keyword if the shell recognizes "-" as an intro
to a cmdline option. Lastly, you may use
py.test. -k "test_simple:"
which will run all tests after the expression has *matched once*, i.e.
all tests that are seen after a test that matches the "test_simple"
keyword.
testing with multiple python versions / executables testing with multiple python versions / executables
--------------------------------------------------- ---------------------------------------------------

4
py/test/defaultconftest.py
View File

@ -42,7 +42,9 @@ def adddefaultoptions(config):
Option('-k', Option('-k',
action="store", dest="keyword", default='', action="store", dest="keyword", default='',
help="only run test items matching the given " help="only run test items matching the given "
"keyword expression."), "comma separated keywords. precede keyword with '-' to negate. "
"Terminate with ':' to treat a match as a signal to run all subsequent tests. "
),
Option('-l', '--showlocals', Option('-l', '--showlocals',
action="store_true", dest="showlocals", default=False, action="store_true", dest="showlocals", default=False,
help="show locals in tracebacks (disabled by default)."), help="show locals in tracebacks (disabled by default)."),