openstack/os-testr
Code Issues Proposed changes

Merge "Add whitelist file to ostestr docs"

Browse Source
This commit is contained in:
Jenkins 2016-05-26 02:00:46 +00:00 committed by Gerrit Code Review
commit e5e11dca2e
1 changed files with 20 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
doc/source/ostestr.rst
View File

@ -14,6 +14,7 @@ default behavior might change in future version.
Summary Summary
------- -------
ostestr [-b|--blacklist_file <blacklist_file>] [-r|--regex REGEX] ostestr [-b|--blacklist_file <blacklist_file>] [-r|--regex REGEX]
[-w|--whitelist_file <whitelist_file>]
[-p|--pretty] [--no-pretty] [-s|--subunit] [-l|--list] [-p|--pretty] [--no-pretty] [-s|--subunit] [-l|--list]
[-n|--no-discover <test_id>] [--slowest] [--no-slowest] [-n|--no-discover <test_id>] [--slowest] [--no-slowest]
[--pdb <test_id>] [--parallel] [--serial] [--pdb <test_id>] [--parallel] [--serial]
@ -25,6 +26,9 @@ Options
--blacklist_file BLACKLIST_FILE, -b BLACKLIST_FILE --blacklist_file BLACKLIST_FILE, -b BLACKLIST_FILE
Path to a blacklist file, this file contains a Path to a blacklist file, this file contains a
separate regex exclude on each newline separate regex exclude on each newline
--whitelist_file WHITELIST_FILE, -w WHITELIST_FILE
Path to a whitelist file, this file contains a
separate regex on each newline
--regex REGEX, -r REGEX --regex REGEX, -r REGEX
A normal testr selection regex. If a blacklist file is A normal testr selection regex. If a blacklist file is
specified, the regex will be appended to the end of specified, the regex will be appended to the end of
@ -134,6 +138,22 @@ regex test selection options can not be used in conjunction with the
because the regex selection requires using testr under the covers to actually because the regex selection requires using testr under the covers to actually
do the filtering, and those 2 options do not use testr. do the filtering, and those 2 options do not use testr.
The dual of the blacklist file is the whitelist file which works in the exact
same manner, except that instead of excluding regex matches it includes them.
You can specify the path to the file with --whitelist_file/-w, for example::
$ ostestr --whitelist_file $path_to_file
The format for the file is more or less identical to the blacklist file::
# Whitelist File
^regex1 # Include these tests
.*regex2 # include those tests
However, instead of excluding the matches it will include them. Note that a
blacklist file can not be used at the same time as a whitelist file, they
are mutually exclusive.
It's also worth noting that you can use the test list option to dry run any It's also worth noting that you can use the test list option to dry run any
selection arguments you are using. You just need to use --list/-l with your selection arguments you are using. You just need to use --list/-l with your
selection options to do this, for example:: selection options to do this, for example::