class Tester(object):
def __init__(self, filesystem=None, webkit_finder=None):
self.filesystem = filesystem or FileSystem()
self.executive = Executive()
self.finder = Finder(self.filesystem)
self.printer = Printer(sys.stderr)
self.webkit_finder = webkit_finder or WebKitFinder(self.filesystem)
self._options = None
def add_tree(self, top_directory, starting_subdirectory=None):
self.finder.add_tree(top_directory, starting_subdirectory)
def skip(self, names, reason, bugid):
self.finder.skip(names, reason, bugid)
def _parse_args(self, argv):
parser = optparse.OptionParser(usage='usage: %prog [options] [args...]')
parser.add_option('-a', '--all', action='store_true', default=False,
help='run all the tests')
parser.add_option('-c', '--coverage', action='store_true', default=False,
help='generate code coverage info')
parser.add_option('-i', '--integration-tests', action='store_true', default=False,
help='run integration tests as well as unit tests'),
parser.add_option('-j', '--child-processes', action='store', type='int', default=(1 if sys.platform == 'win32' else multiprocessing.cpu_count()),
help='number of tests to run in parallel (default=%default)')
parser.add_option('-p', '--pass-through', action='store_true', default=False,
help='be debugger friendly by passing captured output through to the system')
parser.add_option('-q', '--quiet', action='store_true', default=False,
help='run quietly (errors, warnings, and progress only)')
parser.add_option('-t', '--timing', action='store_true', default=False,
help='display per-test execution time (implies --verbose)')
parser.add_option('-v', '--verbose', action='count', default=0,
help='verbose output (specify once for individual test results, twice for debug messages)')
parser.epilog = ('[args...] is an optional list of modules, test_classes, or individual tests. '
'If no args are given, all the tests will be run.')
return parser.parse_args(argv)
def run(self):
argv = sys.argv[1:]
self._options, args = self._parse_args(argv)
# Make sure PYTHONPATH is set up properly.
sys.path = self.finder.additional_paths(sys.path) + sys.path
# FIXME: unittest2 needs to be in sys.path for its internal imports to work.
thirdparty_path = self.webkit_finder.path_from_webkit_base('Tools', 'Scripts', 'webkitpy', 'thirdparty')
if not thirdparty_path in sys.path:
sys.path.append(thirdparty_path)
self.printer.configure(self._options)
# Do this after configuring the printer, so that logging works properly.
if self._options.coverage:
argv = ['-j', '1'] + [arg for arg in argv if arg not in ('-c', '--coverage', '-j', '--child-processes')]
_log.warning('Checking code coverage, so running things serially')
return self._run_under_coverage(argv)
self.finder.clean_trees()
names = self.finder.find_names(args, self._options.all)
if not names:
_log.error('No tests to run')
return False
return self._run_tests(names)
def _run_under_coverage(self, argv):
# coverage doesn't run properly unless its parent dir is in PYTHONPATH.
# This means we need to add that dir to the environment. Also, the
# report output is best when the paths are relative to the Scripts dir.
dirname = self.filesystem.dirname
script_dir = dirname(dirname(dirname(__file__)))
thirdparty_dir = self.filesystem.join(script_dir, 'webkitpy', 'thirdparty')
env = os.environ.copy()
python_path = env.get('PYTHONPATH', '')
python_path = python_path + os.pathsep + thirdparty_dir
env['PYTHONPATH'] = python_path
prefix_cmd = [sys.executable, 'webkitpy/thirdparty/coverage']
exit_code = self.executive.call(prefix_cmd + ['run', __file__] + argv, cwd=script_dir, env=env)
if not exit_code:
exit_code = self.executive.call(prefix_cmd + ['report', '--omit', 'webkitpy/thirdparty/*,/usr/*,/Library/*'], cwd=script_dir, env=env)
return (exit_code == 0)
def _run_tests(self, names):
self.printer.write_update("Checking imports ...")
if not self._check_imports(names):
return False
self.printer.write_update("Finding the individual test methods ...")
loader = _Loader()
parallel_tests, serial_tests = self._test_names(loader, names)
self.printer.write_update("Running the tests ...")
self.printer.num_tests = len(parallel_tests) + len(serial_tests)
start = time.time()
test_runner = Runner(self.printer, loader, self.webkit_finder)
test_runner.run(parallel_tests, self._options.child_processes)
test_runner.run(serial_tests, 1)
self.printer.print_result(time.time() - start)
return not self.printer.num_errors and not self.printer.num_failures
def _check_imports(self, names):
for name in names:
if self.finder.is_module(name):
# if we failed to load a name and it looks like a module,
# try importing it directly, because loadTestsFromName()
# produces lousy error messages for bad modules.
try:
__import__(name)
except ImportError:
_log.fatal('Failed to import %s:' % name)
self._log_exception()
return False
return True
def _test_names(self, loader, names):
parallel_test_method_prefixes = ['test_']
serial_test_method_prefixes = ['serial_test_']
if self._options.integration_tests:
parallel_test_method_prefixes.append('integration_test_')
serial_test_method_prefixes.append('serial_integration_test_')
parallel_tests = []
loader.test_method_prefixes = parallel_test_method_prefixes
for name in names:
parallel_tests.extend(self._all_test_names(loader.loadTestsFromName(name, None)))
serial_tests = []
loader.test_method_prefixes = serial_test_method_prefixes
for name in names:
serial_tests.extend(self._all_test_names(loader.loadTestsFromName(name, None)))
# loader.loadTestsFromName() will not verify that names begin with one of the test_method_prefixes
# if the names were explicitly provided (e.g., MainTest.test_basic), so this means that any individual
# tests will be included in both parallel_tests and serial_tests, and we need to de-dup them.
serial_tests = list(set(serial_tests).difference(set(parallel_tests)))
return (parallel_tests, serial_tests)
def _all_test_names(self, suite):
names = []
if hasattr(suite, '_tests'):
for t in suite._tests:
names.extend(self._all_test_names(t))
else:
names.append(unit_test_name(suite))
return names
def _log_exception(self):
s = StringIO.StringIO()
traceback.print_exc(file=s)
for l in s.buflist:
_log.error(' ' + l.rstrip())
class Tester(object):
def __init__(self, filesystem=None, webkit_finder=None):
self.filesystem = filesystem or FileSystem()
self.executive = Executive()
self.finder = Finder(self.filesystem)
self.printer = Printer(sys.stderr)
self.webkit_finder = webkit_finder or WebKitFinder(self.filesystem)
self._options = None
def add_tree(self, top_directory, starting_subdirectory=None):
self.finder.add_tree(top_directory, starting_subdirectory)
def skip(self, names, reason, bugid):
self.finder.skip(names, reason, bugid)
def _parse_args(self, argv):
parser = optparse.OptionParser(
usage='usage: %prog [options] [args...]')
parser.add_option('-a',
'--all',
action='store_true',
default=False,
help='run all the tests')
parser.add_option('-c',
'--coverage',
action='store_true',
default=False,
help='generate code coverage info')
parser.add_option(
'-j',
'--child-processes',
action='store',
type='int',
default=(1 if sys.platform == 'win32' else
multiprocessing.cpu_count()),
help='number of tests to run in parallel (default=%default)')
parser.add_option(
'-p',
'--pass-through',
action='store_true',
default=False,
help=
'be debugger friendly by passing captured output through to the system'
)
parser.add_option(
'-q',
'--quiet',
action='store_true',
default=False,
help='run quietly (errors, warnings, and progress only)')
parser.add_option(
'-t',
'--timing',
action='store_true',
default=False,
help='display per-test execution time (implies --verbose)')
parser.add_option(
'-v',
'--verbose',
action='count',
default=0,
help=
'verbose output (specify once for individual test results, twice for debug messages)'
)
parser.epilog = (
'[args...] is an optional list of modules, test_classes, or individual tests. '
'If no args are given, all the tests will be run.')
return parser.parse_args(argv)
def run(self):
argv = sys.argv[1:]
self._options, args = self._parse_args(argv)
# Make sure PYTHONPATH is set up properly.
sys.path = self.finder.additional_paths(sys.path) + sys.path
# FIXME: coverage needs to be in sys.path for its internal imports to work.
thirdparty_path = self.webkit_finder.path_from_webkit_base(
'tools', 'webkitpy', 'thirdparty')
if not thirdparty_path in sys.path:
sys.path.append(thirdparty_path)
self.printer.configure(self._options)
# Do this after configuring the printer, so that logging works properly.
if self._options.coverage:
argv = ['-j', '1'] + [
arg for arg in argv
if arg not in ('-c', '--coverage', '-j', '--child-processes')
]
_log.warning('Checking code coverage, so running things serially')
return self._run_under_coverage(argv)
self.finder.clean_trees()
names = self.finder.find_names(args, self._options.all)
if not names:
_log.error('No tests to run')
return False
return self._run_tests(names)
def _run_under_coverage(self, argv):
# coverage doesn't run properly unless its parent dir is in PYTHONPATH.
# This means we need to add that dir to the environment. Also, the
# report output is best when the paths are relative to the Scripts dir.
dirname = self.filesystem.dirname
script_dir = dirname(dirname(dirname(__file__)))
thirdparty_dir = self.filesystem.join(script_dir, 'webkitpy',
'thirdparty')
env = os.environ.copy()
python_path = env.get('PYTHONPATH', '')
python_path = python_path + os.pathsep + thirdparty_dir
env['PYTHONPATH'] = python_path
prefix_cmd = [sys.executable, 'webkitpy/thirdparty/coverage']
exit_code = self.executive.call(prefix_cmd + ['run', __file__] + argv,
cwd=script_dir,
env=env)
if not exit_code:
exit_code = self.executive.call(prefix_cmd + [
'report', '--omit', 'webkitpy/thirdparty/*,/usr/*,/Library/*'
],
cwd=script_dir,
env=env)
return (exit_code == 0)
def _run_tests(self, names):
self.printer.write_update("Checking imports ...")
if not self._check_imports(names):
return False
self.printer.write_update("Finding the individual test methods ...")
loader = unittest.TestLoader()
tests = self._test_names(loader, names)
self.printer.write_update("Running the tests ...")
self.printer.num_tests = len(tests)
start = time.time()
test_runner = Runner(self.printer, loader, self.webkit_finder)
test_runner.run(tests, self._options.child_processes)
self.printer.print_result(time.time() - start)
return not self.printer.num_errors and not self.printer.num_failures
def _check_imports(self, names):
for name in names:
if self.finder.is_module(name):
# if we failed to load a name and it looks like a module,
# try importing it directly, because loadTestsFromName()
# produces lousy error messages for bad modules.
try:
__import__(name)
except ImportError:
_log.fatal('Failed to import %s:' % name)
self._log_exception()
return False
return True
def _test_names(self, loader, names):
tests = []
for name in names:
tests.extend(
self._all_test_names(loader.loadTestsFromName(name, None)))
return tests
def _all_test_names(self, suite):
names = []
if hasattr(suite, '_tests'):
for t in suite._tests:
names.extend(self._all_test_names(t))
else:
names.append(unit_test_name(suite))
return names
def _log_exception(self):
s = StringIO.StringIO()
traceback.print_exc(file=s)
for l in s.buflist:
_log.error(' ' + l.rstrip())
