gtest_filter_unittest Namespace Reference

Classes
class	GTestFilterUnitTest

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

Variables
str	__author__ = 'wan@google.com (Zhanyong Wan)'
	child
	CAN_PASS_EMPTY_ENV = eval(child.output)
	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'
	COMMAND = gtest_test_utils.GetTestExecutablePath('gtest_filter_unittest_')
	PARAM_TEST_REGEX = re.compile(r'/ParamTest')
	TEST_CASE_REGEX = re.compile(r'^\‍[\-+\‍] \d+ tests? from (\w+(/\w+)?)')
	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
list	ACTIVE_TESTS
	param_tests_present = None
	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()

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

Runs the given function and arguments in a modified environment.

RunAndExtractTestList()

gtest_filter_unittest.RunAndExtractTestList

(

args = None

)

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

RunAndReturnOutput()

gtest_filter_unittest.RunAndReturnOutput

(

args = None

)

Runs the test program and returns its output.

RunWithSharding()

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()

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

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

gtest_filter_unittest.CAN_UNSET_ENV = eval(child.output)

child

gtest_filter_unittest.child

Initial value:

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

COMMAND

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',
    ]

environ

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

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

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

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

TEST_REGEX

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'