gtest_filter_unittest Namespace Reference

Classes
class	GTestFilterUnitTest

Functions
def	SetEnvVar (env_var, value)
def	RunAndReturnOutput (args=None)
def	RunAndExtractTestList (args=None)
def	InvokeWithModifiedEnv (extra_env, function, *args, **kwargs)
def	RunWithSharding (total_shards, shard_index, command)

Variables
str	__author__ = 'wan@google.com (Zhanyong Wan)'
	try :
gtest_test_utils	child
eval	CAN_PASS_EMPTY_ENV = eval(child.output)
eval	CAN_UNSET_ENV = eval(child.output)
tuple	CAN_TEST_EMPTY_FILTER = (CAN_PASS_EMPTY_ENV and CAN_UNSET_ENV)
str	FILTER_ENV_VAR = 'GTEST_FILTER'
str	TOTAL_SHARDS_ENV_VAR = 'GTEST_TOTAL_SHARDS'
str	SHARD_INDEX_ENV_VAR = 'GTEST_SHARD_INDEX'
str	SHARD_STATUS_FILE_ENV_VAR = 'GTEST_SHARD_STATUS_FILE'
str	FILTER_FLAG = 'gtest_filter'
str	ALSO_RUN_DISABED_TESTS_FLAG = 'gtest_also_run_disabled_tests'
gtest_test_utils	COMMAND = gtest_test_utils.GetTestExecutablePath('gtest_filter_unittest_')
re	PARAM_TEST_REGEX = re.compile(r'/ParamTest')
re	TEST_CASE_REGEX = re.compile(r'^\[\-+\] \d+ tests? from (\w+(/\w+)?)')
re	TEST_REGEX = re.compile(r'^\[\s*RUN\s*\].*\.(\w+(/\w+)?)')
str	LIST_TESTS_FLAG = '--gtest_list_tests'
str	SUPPORTS_DEATH_TESTS
list	PARAM_TESTS
list	DISABLED_TESTS
list	DEATH_TESTS
	else :
list	ACTIVE_TESTS
None	param_tests_present = None
os	environ = os.environ.copy()

Detailed Description

Unit test for Google Test test filters.

A user can specify which test(s) in a Google Test program to run via either
the GTEST_FILTER environment variable or the --gtest_filter flag.
This script tests such functionality by invoking
gtest_filter_unittest_ (a program written with Google Test) with different
environments and command line flags.

Note that test sharding may also influence which tests are filtered. Therefore,
we test that here also.

Function Documentation

InvokeWithModifiedEnv()

def gtest_filter_unittest.InvokeWithModifiedEnv	(		extra_env,
			function,
		*	args,
		**	kwargs
	)

Runs the given function and arguments in a modified environment.

RunAndExtractTestList()

def gtest_filter_unittest.RunAndExtractTestList

(

args = None

)

Runs the test program and returns its exit code and a list of tests run.

RunAndReturnOutput()

def gtest_filter_unittest.RunAndReturnOutput

(

args = None

)

Runs the test program and returns its output.

RunWithSharding()

def gtest_filter_unittest.RunWithSharding	(		total_shards,
			shard_index,
			command
	)

Runs a test program shard and returns exit code and a list of tests run.

SetEnvVar()

def gtest_filter_unittest.SetEnvVar	(		env_var,
			value
	)

Sets the env variable to 'value'; unsets it when 'value' is None.

Variable Documentation

__author__

str gtest_filter_unittest.__author__ = 'wan@google.com (Zhanyong Wan)'

private

ACTIVE_TESTS

list gtest_filter_unittest.ACTIVE_TESTS

Initial value:

=  [
    'FooTest.Abc',
    'FooTest.Xyz',
 
    'BarTest.TestOne',
    'BarTest.TestTwo',
    'BarTest.TestThree',
 
    'BazTest.TestOne',
    'BazTest.TestA',
    'BazTest.TestB',
    ] + DEATH_TESTS + PARAM_TESTS

ALSO_RUN_DISABED_TESTS_FLAG

str gtest_filter_unittest.ALSO_RUN_DISABED_TESTS_FLAG = 'gtest_also_run_disabled_tests'

CAN_PASS_EMPTY_ENV

eval gtest_filter_unittest.CAN_PASS_EMPTY_ENV = eval(child.output)

CAN_TEST_EMPTY_FILTER

tuple gtest_filter_unittest.CAN_TEST_EMPTY_FILTER = (CAN_PASS_EMPTY_ENV and CAN_UNSET_ENV)

CAN_UNSET_ENV

eval gtest_filter_unittest.CAN_UNSET_ENV = eval(child.output)

child

gtest_test_utils gtest_filter_unittest.child

Initial value:

=  gtest_test_utils.Subprocess(
    [sys.executable, '-c', 'import os; print(\'EMPTY_VAR\' in os.environ)'])

COMMAND

gtest_test_utils gtest_filter_unittest.COMMAND = gtest_test_utils.GetTestExecutablePath('gtest_filter_unittest_')

DEATH_TESTS

list gtest_filter_unittest.DEATH_TESTS

Initial value:

=  [
    'HasDeathTest.Test1',
    'HasDeathTest.Test2',
    ]

DISABLED_TESTS

list gtest_filter_unittest.DISABLED_TESTS

Initial value:

=  [
    'BarTest.DISABLED_TestFour',
    'BarTest.DISABLED_TestFive',
    'BazTest.DISABLED_TestC',
    'DISABLED_FoobarTest.Test1',
    'DISABLED_FoobarTest.DISABLED_Test2',
    'DISABLED_FoobarbazTest.TestA',
    ]

else

gtest_filter_unittest.else :

environ

os gtest_filter_unittest.environ = os.environ.copy()

FILTER_ENV_VAR

str gtest_filter_unittest.FILTER_ENV_VAR = 'GTEST_FILTER'

FILTER_FLAG

str gtest_filter_unittest.FILTER_FLAG = 'gtest_filter'

LIST_TESTS_FLAG

str gtest_filter_unittest.LIST_TESTS_FLAG = '--gtest_list_tests'

PARAM_TEST_REGEX

re gtest_filter_unittest.PARAM_TEST_REGEX = re.compile(r'/ParamTest')

PARAM_TESTS

list gtest_filter_unittest.PARAM_TESTS

Initial value:

=  [
    'SeqP/ParamTest.TestX/0',
    'SeqP/ParamTest.TestX/1',
    'SeqP/ParamTest.TestY/0',
    'SeqP/ParamTest.TestY/1',
    'SeqQ/ParamTest.TestX/0',
    'SeqQ/ParamTest.TestX/1',
    'SeqQ/ParamTest.TestY/0',
    'SeqQ/ParamTest.TestY/1',
    ]

param_tests_present

None gtest_filter_unittest.param_tests_present = None

SHARD_INDEX_ENV_VAR

str gtest_filter_unittest.SHARD_INDEX_ENV_VAR = 'GTEST_SHARD_INDEX'

SHARD_STATUS_FILE_ENV_VAR

str gtest_filter_unittest.SHARD_STATUS_FILE_ENV_VAR = 'GTEST_SHARD_STATUS_FILE'

SUPPORTS_DEATH_TESTS

str gtest_filter_unittest.SUPPORTS_DEATH_TESTS

Initial value:

=  'HasDeathTest' in gtest_test_utils.Subprocess(
    [COMMAND, LIST_TESTS_FLAG]).output

TEST_CASE_REGEX

re gtest_filter_unittest.TEST_CASE_REGEX = re.compile(r'^\[\-+\] \d+ tests? from (\w+(/\w+)?)')

TEST_REGEX

re gtest_filter_unittest.TEST_REGEX = re.compile(r'^\[\s*RUN\s*\].*\.(\w+(/\w+)?)')

TOTAL_SHARDS_ENV_VAR

str gtest_filter_unittest.TOTAL_SHARDS_ENV_VAR = 'GTEST_TOTAL_SHARDS'

try

gtest_filter_unittest.try :