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
bool	CAN_PASS_EMPTY_ENV = False

	child

bool	CAN_UNSET_ENV = False

tuple	CAN_TEST_EMPTY_FILTER = (CAN_PASS_EMPTY_ENV and CAN_UNSET_ENV)

string	FILTER_ENV_VAR = 'GTEST_FILTER'

string	TOTAL_SHARDS_ENV_VAR = 'GTEST_TOTAL_SHARDS'

string	SHARD_INDEX_ENV_VAR = 'GTEST_SHARD_INDEX'

string	SHARD_STATUS_FILE_ENV_VAR = 'GTEST_SHARD_STATUS_FILE'

string	FILTER_FLAG = 'gtest_filter'

string	ALSO_RUN_DISABLED_TESTS_FLAG = 'gtest_also_run_disabled_tests'

	COMMAND = gtest_test_utils.GetTestExecutablePath('googletest-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'^\[\sRUN\s\].*\.(\w+(/\w+)?)')

string	LIST_TESTS_FLAG = '--gtest_list_tests'

string	SUPPORTS_DEATH_TESTS

list	PARAM_TESTS

list	DISABLED_TESTS

list	DEATH_TESTS

list	ACTIVE_TESTS

	param_tests_present = None

	environ = os.environ.copy()

Function Documentation

◆ InvokeWithModifiedEnv()

def googletest-filter-unittest.InvokeWithModifiedEnv	(		extra_env,
			function,
		*	args,
		**	kwargs
	)

Runs the given function and arguments in a modified environment.

Definition at line 209 of file googletest-filter-unittest.py.

def InvokeWithModifiedEnv(extra_env, function, *args, **kwargs):
  """Runs the given function and arguments in a modified environment."""
  try:
    original_env = environ.copy()
    environ.update(extra_env)
    return function(*args, **kwargs)
  finally:
    environ.clear()
    environ.update(original_env)
 
 

◆ RunAndExtractTestList()

def googletest-filter-unittest.RunAndExtractTestList ( args = None )

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

Definition at line 190 of file googletest-filter-unittest.py.

def RunAndExtractTestList(args = None):
  """Runs the test program and returns its exit code and a list of tests run."""
 
  p = gtest_test_utils.Subprocess([COMMAND] + (args or []), env=environ)
  tests_run = []
  test_case = ''
  test = ''
  for line in p.output.split('\n'):
    match = TEST_CASE_REGEX.match(line)
    if match is not None:
      test_case = match.group(1)
    else:
      match = TEST_REGEX.match(line)
      if match is not None:
        test = match.group(1)
        tests_run.append(test_case + '.' + test)
  return (tests_run, p.exit_code)
 
 

◆ RunAndReturnOutput()

def googletest-filter-unittest.RunAndReturnOutput ( args = None )

Runs the test program and returns its output.

Definition at line 183 of file googletest-filter-unittest.py.

def RunAndReturnOutput(args = None):
  """Runs the test program and returns its output."""
 
  return gtest_test_utils.Subprocess([COMMAND] + (args or []),
                                     env=environ).output

◆ RunWithSharding()

def googletest-filter-unittest.RunWithSharding	(	total_shards,
		shard_index,
		command
	)

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

Definition at line 220 of file googletest-filter-unittest.py.

def RunWithSharding(total_shards, shard_index, command):
  """Runs a test program shard and returns exit code and a list of tests run."""
 
  extra_env = {SHARD_INDEX_ENV_VAR: str(shard_index),
               TOTAL_SHARDS_ENV_VAR: str(total_shards)}
  return InvokeWithModifiedEnv(extra_env, RunAndExtractTestList, command)
 
# The unit test.
 
 

◆ SetEnvVar()

def googletest-filter-unittest.SetEnvVar	(	env_var,
		value
	)

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

Definition at line 174 of file googletest-filter-unittest.py.

def SetEnvVar(env_var, value):
  """Sets the env variable to 'value'; unsets it when 'value' is None."""
 
  if value is not None:
    environ[env_var] = value
  elif env_var in environ:
    del environ[env_var]
 
 

Variable Documentation

◆ ACTIVE_TESTS

list googletest-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

Definition at line 154 of file googletest-filter-unittest.py.

◆ ALSO_RUN_DISABLED_TESTS_FLAG

string googletest-filter-unittest.ALSO_RUN_DISABLED_TESTS_FLAG = 'gtest_also_run_disabled_tests'

Definition at line 102 of file googletest-filter-unittest.py.

◆ CAN_PASS_EMPTY_ENV

googletest-filter-unittest.CAN_PASS_EMPTY_ENV = False

Definition at line 59 of file googletest-filter-unittest.py.

◆ CAN_TEST_EMPTY_FILTER

tuple googletest-filter-unittest.CAN_TEST_EMPTY_FILTER = (CAN_PASS_EMPTY_ENV and CAN_UNSET_ENV)

Definition at line 87 of file googletest-filter-unittest.py.

◆ CAN_UNSET_ENV

googletest-filter-unittest.CAN_UNSET_ENV = False

Definition at line 73 of file googletest-filter-unittest.py.

◆ child

googletest-filter-unittest.child

Initial value:

1= gtest_test_utils.Subprocess(

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

Definition at line 62 of file googletest-filter-unittest.py.

◆ COMMAND

googletest-filter-unittest.COMMAND = gtest_test_utils.GetTestExecutablePath('googletest-filter-unittest_')

Definition at line 105 of file googletest-filter-unittest.py.

◆ DEATH_TESTS

list googletest-filter-unittest.DEATH_TESTS

Initial value:

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

Definition at line 146 of file googletest-filter-unittest.py.

◆ DISABLED_TESTS

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

Definition at line 136 of file googletest-filter-unittest.py.

◆ environ

googletest-filter-unittest.environ = os.environ.copy()

Definition at line 171 of file googletest-filter-unittest.py.

◆ FILTER_ENV_VAR

string googletest-filter-unittest.FILTER_ENV_VAR = 'GTEST_FILTER'

Definition at line 91 of file googletest-filter-unittest.py.

◆ FILTER_FLAG

string googletest-filter-unittest.FILTER_FLAG = 'gtest_filter'

Definition at line 99 of file googletest-filter-unittest.py.

◆ LIST_TESTS_FLAG

string googletest-filter-unittest.LIST_TESTS_FLAG = '--gtest_list_tests'

Definition at line 118 of file googletest-filter-unittest.py.

◆ PARAM_TEST_REGEX

googletest-filter-unittest.PARAM_TEST_REGEX = re.compile(r'/ParamTest')

Definition at line 108 of file googletest-filter-unittest.py.

◆ PARAM_TESTS

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