Edit

kc3-lang/angle/src/tests/capture_replay_tests.py

Branch :

  • Show log

    Commit

  • Author : Gert Wollny
    Date : 2021-03-15 14:39:30
    Hash : cee0bfd6
    Message : Capture/Replay: serialize context to JSON Bug: angleproject:5715 Change-Id: Ibc6897d7567fedab4a2ba7bf8d2bd5a7e496bd4b Reviewed-on: https://chromium-review.googlesource.com/c/angle/angle/+/2760325 Reviewed-by: Jamie Madill <jmadill@chromium.org> Reviewed-by: Cody Northrop <cnorthrop@google.com> Commit-Queue: Jamie Madill <jmadill@chromium.org>

  • src/tests/capture_replay_tests.py
  • #! /usr/bin/env python3
    #
    # Copyright 2020 The ANGLE Project Authors. All rights reserved.
    # Use of this source code is governed by a BSD-style license that can be
    # found in the LICENSE file.
    #
    """
    Script testing capture_replay with angle_end2end_tests
    """
    
    # Automation script will:
    # 1. Build all tests in angle_end2end with frame capture enabled
    # 2. Run each test with frame capture
    # 3. Build CaptureReplayTest with cpp trace files
    # 4. Run CaptureReplayTest
    # 5. Output the number of test successes and failures. A test succeeds if no error occurs during
    # its capture and replay, and the GL states at the end of two runs match. Any unexpected failure
    # will return non-zero exit code
    
    # Run this script with Python to test capture replay on angle_end2end tests
    # python path/to/capture_replay_tests.py
    # Command line arguments: run with --help for a full list.
    
    import argparse
    import distutils.util
    import fnmatch
    import logging
    import math
    import multiprocessing
    import os
    import queue
    import re
    import shutil
    import subprocess
    import sys
    import time
    
    from sys import platform
    
    PIPE_STDOUT = True
    DEFAULT_OUT_DIR = "out/CaptureReplayTest"  # relative to angle folder
    DEFAULT_FILTER = "*/ES2_Vulkan"
    DEFAULT_TEST_SUITE = "angle_end2end_tests"
    REPLAY_SAMPLE_FOLDER = "src/tests/capture_replay_tests"  # relative to angle folder
    DEFAULT_BATCH_COUNT = 8  # number of tests batched together
    TRACE_FILE_SUFFIX = "_capture_context"  # because we only deal with 1 context right now
    RESULT_TAG = "*RESULT"
    TIME_BETWEEN_MESSAGE = 20  # in seconds
    SUBPROCESS_TIMEOUT = 600  # in seconds
    DEFAULT_RESULT_FILE = "results.txt"
    DEFAULT_LOG_LEVEL = "info"
    DEFAULT_MAX_JOBS = 8
    REPLAY_BINARY = "capture_replay_tests"
    if platform == "win32":
        REPLAY_BINARY += ".exe"
    TRACE_FOLDER = "traces"
    
    EXIT_SUCCESS = 0
    EXIT_FAILURE = 1
    
    switch_case_without_return_template = \
    """        case {case}:
                {namespace}::{call}({params});
                break;
    """
    
    switch_case_with_return_template = \
    """        case {case}:
                return {namespace}::{call}({params});
    """
    
    default_case_without_return_template = \
    """        default:
                break;"""
    default_case_with_return_template = \
    """        default:
                return {default_val};"""
    
    switch_statement_template = \
    """switch(test)
        {{
    {switch_cases}{default_case}
        }}
    """
    
    test_trace_info_init_template = \
    """    {{
            "{namespace}",
            {namespace}::kReplayContextClientMajorVersion,
            {namespace}::kReplayContextClientMinorVersion,
            {namespace}::kReplayPlatformType,
            {namespace}::kReplayDeviceType,
            {namespace}::kReplayFrameStart,
            {namespace}::kReplayFrameEnd,
            {namespace}::kReplayDrawSurfaceWidth,
            {namespace}::kReplayDrawSurfaceHeight,
            {namespace}::kDefaultFramebufferRedBits,
            {namespace}::kDefaultFramebufferGreenBits,
            {namespace}::kDefaultFramebufferBlueBits,
            {namespace}::kDefaultFramebufferAlphaBits,
            {namespace}::kDefaultFramebufferDepthBits,
            {namespace}::kDefaultFramebufferStencilBits,
            {namespace}::kIsBinaryDataCompressed
        }},
    """
    
    composite_h_file_template = \
    """#pragma once
    #include <vector>
    #include <string>
    
    {trace_headers}
    
    using DecompressCallback = uint8_t *(*)(const std::vector<uint8_t> &);
    
    void SetupContextReplay(uint32_t test);
    void ReplayContextFrame(uint32_t test, uint32_t frameIndex);
    void ResetContextReplay(uint32_t test);
    const char *GetSerializedContextState(uint32_t test, uint32_t frameIndex);
    void SetBinaryDataDecompressCallback(uint32_t test, DecompressCallback callback);
    void SetBinaryDataDir(uint32_t test, const char *dataDir);
    
    struct TestTraceInfo {{
        std::string testName;
        uint32_t replayContextMajorVersion;
        uint32_t replayContextMinorVersion;
        EGLint replayPlatformType;
        EGLint replayDeviceType;
        uint32_t replayFrameStart;
        uint32_t replayFrameEnd;
        EGLint replayDrawSurfaceWidth;
        EGLint replayDrawSurfaceHeight;
        EGLint defaultFramebufferRedBits;
        EGLint defaultFramebufferGreenBits;
        EGLint defaultFramebufferBlueBits;
        EGLint defaultFramebufferAlphaBits;
        EGLint defaultFramebufferDepthBits;
        EGLint defaultFramebufferStencilBits;
        bool isBinaryDataCompressed;
    }};
    
    extern std::vector<TestTraceInfo> testTraceInfos;
    """
    
    composite_cpp_file_template = \
    """#include "{h_filename}"
    
    std::vector<TestTraceInfo> testTraceInfos =
    {{
    {test_trace_info_inits}
    }};
    void SetupContextReplay(uint32_t test)
    {{
        {setup_context1_replay_switch_statement}
    }}
    
    void ReplayContextFrame(uint32_t test, uint32_t frameIndex)
    {{
        {replay_context1_replay_switch_statement}
    }}
    
    void ResetContextReplay(uint32_t test)
    {{
        {reset_context1_replay_switch_statement}
    }}
    
    const char *GetSerializedContextState(uint32_t test, uint32_t frameIndex)
    {{
        {get_serialized_context1_state_data_switch_statement}
    }}
    
    void SetBinaryDataDecompressCallback(uint32_t test, DecompressCallback callback)
    {{
        {set_binary_data_decompress_callback_switch_statement}
    }}
    
    void SetBinaryDataDir(uint32_t test, const char *dataDir)
    {{
        {set_binary_data_dir_switch_statement}
    }}
    """
    
    
    def debug(str):
        logging.debug('%s: %s' % (multiprocessing.current_process().name, str))
    
    
    def info(str):
        logging.info('%s: %s' % (multiprocessing.current_process().name, str))
    
    
    class SubProcess():
    
        def __init__(self, command, env=os.environ, pipe_stdout=PIPE_STDOUT):
            # shell=False so that only 1 subprocess is spawned.
            # if shell=True, a shell process is spawned, which in turn spawns the process running
            # the command. Since we do not have a handle to the 2nd process, we cannot terminate it.
            if pipe_stdout:
                self.proc_handle = subprocess.Popen(
                    command, env=env, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, shell=False)
            else:
                self.proc_handle = subprocess.Popen(command, env=env, shell=False)
    
        def Join(self, timeout):
            debug('Joining with subprocess %d, timeout %s' % (self.Pid(), str(timeout)))
            output = self.proc_handle.communicate(timeout=timeout)[0]
            if output:
                output = output.decode('utf-8')
            else:
                output = ''
            return self.proc_handle.returncode, output
    
        def Pid(self):
            return self.proc_handle.pid
    
        def Kill(self):
            self.proc_handle.terminate()
            self.proc_handle.wait()
    
    
    # class that manages all child processes of a process. Any process thats spawns subprocesses
    # should have this. This object is created inside the main process, and each worker process.
    class ChildProcessesManager():
    
        @classmethod
        def _GetGnAndNinjaAbsolutePaths(self, depot_tools_path):
    
            def find_depot_tools_from_env():
                depot_tools_name = "depot_tools"
                if platform == "win32":
                    paths = os.environ["PATH"].split(";")
                else:
                    paths = os.environ["PATH"].split(":")
                for path in paths:
                    if path.endswith(depot_tools_name):
                        return path
                logging.exception("No gn or ninja found on system")
    
            def winext(name, ext):
                return ("%s.%s" % (name, ext)) if platform == "win32" else name
    
            path = depot_tools_path if depot_tools_path else find_depot_tools_from_env()
            return os.path.join(path, winext('gn', 'bat')), os.path.join(path, winext('ninja', 'exe'))
    
        def __init__(self, depot_tools_path):
            # a dictionary of Subprocess, with pid as key
            self.subprocesses = {}
            # list of Python multiprocess.Process handles
            self.workers = []
    
            self._gn_path, self._ninja_path = self._GetGnAndNinjaAbsolutePaths(depot_tools_path)
    
        def RunSubprocess(self, command, env=None, pipe_stdout=True, timeout=None):
            proc = SubProcess(command, env, pipe_stdout)
            debug('Created subprocess: %s with pid %d' % (' '.join(command), proc.Pid()))
            self.subprocesses[proc.Pid()] = proc
            try:
                returncode, output = self.subprocesses[proc.Pid()].Join(timeout)
                self.RemoveSubprocess(proc.Pid())
                if returncode != 0:
                    return -1, output
                return returncode, output
            except KeyboardInterrupt:
                raise
            except subprocess.TimeoutExpired as e:
                self.RemoveSubprocess(proc.Pid())
                return -2, str(e)
            except Exception as e:
                self.RemoveSubprocess(proc.Pid())
                return -1, str(e)
    
        def RemoveSubprocess(self, subprocess_id):
            assert subprocess_id in self.subprocesses
            self.subprocesses[subprocess_id].Kill()
            del self.subprocesses[subprocess_id]
    
        def AddWorker(self, worker):
            self.workers.append(worker)
    
        def KillAll(self):
            for subprocess_id in self.subprocesses:
                self.subprocesses[subprocess_id].Kill()
            for worker in self.workers:
                worker.terminate()
                worker.join()
                worker.close()  # to release file descriptors immediately
            self.subprocesses = {}
            self.workers = []
    
        def JoinWorkers(self):
            for worker in self.workers:
                worker.join()
                worker.close()
            self.workers = []
    
        def IsAnyWorkerAlive(self):
            return any([worker.is_alive() for worker in self.workers])
    
        def GetRemainingWorkers(self):
            count = 0
            for worker in self.workers:
                if worker.is_alive():
                    count += 1
            return count
    
        def RunGNGenProcess(self, build_dir, gn_args, pipe_stdout):
            debug('Calling GN gen with %s' % str(gn_args))
            args_str = ' '.join(['%s=%s' % (k, v) for (k, v) in gn_args])
            cmd = [self._gn_path, 'gen', '--args=%s' % args_str, build_dir]
            return self.RunSubprocess(cmd, pipe_stdout=pipe_stdout)
    
        def RunNinjaProcess(self, args, build_dir, target, pipe_stdout):
            cmd = [self._ninja_path]
    
            # This code is taken from depot_tools/autoninja.py
            if args.use_goma:
                num_cores = multiprocessing.cpu_count()
                cmd.append('-j')
                core_multiplier = 40
                j_value = num_cores * core_multiplier
    
                if sys.platform.startswith('win'):
                    # On windows, j value higher than 1000 does not improve build performance.
                    j_value = min(j_value, 1000)
                elif sys.platform == 'darwin':
                    # On Mac, j value higher than 500 causes 'Too many open files' error
                    # (crbug.com/936864).
                    j_value = min(j_value, 500)
    
                cmd.append('%d' % j_value)
    
            cmd += ['-C', build_dir, target]
            return self.RunSubprocess(cmd, pipe_stdout=pipe_stdout)
    
    
    def GetTestsListForFilter(test_path, filter):
        cmd = [test_path, "--list-tests", "--gtest_filter=%s" % filter]
        info('Getting test list from "%s"' % " ".join(cmd))
        return subprocess.check_output(cmd, text=True)
    
    
    def GetSkippedTestPatterns():
        skipped_test_patterns = []
        test_expectations_filename = "capture_replay_expectations.txt"
        test_expectations_path = os.path.join(REPLAY_SAMPLE_FOLDER, test_expectations_filename)
        with open(test_expectations_path, "rt") as f:
            for line in f:
                l = line.strip()
                if l != "" and not l.startswith("#"):
                    skipped_test_patterns.append(l)
        return skipped_test_patterns
    
    
    def ParseTestNamesFromTestList(output):
    
        def SkipTest(skipped_test_patterns, test):
            for skipped_test_pattern in skipped_test_patterns:
                if fnmatch.fnmatch(test, skipped_test_pattern):
                    return True
            return False
    
        output_lines = output.splitlines()
        tests = []
        skipped_test_patterns = GetSkippedTestPatterns()
        seen_start_of_tests = False
        skips = 0
        for line in output_lines:
            l = line.strip()
            if l == "Tests list:":
                seen_start_of_tests = True
            elif not seen_start_of_tests:
                pass
            elif not SkipTest(skipped_test_patterns, l):
                tests.append(l)
            else:
                skips += 1
    
        info('Found %s tests and %d skipped tests.' % (len(tests), skips))
        return tests
    
    
    def WriteGeneratedSwitchStatements(tests, call, params, returns=False, default_val=""):
        call_lists = []
        call_splitter = "Context"
        for test in tests:
            actual_call_name = call
            if call_splitter in call:
                # split the call so we can put the context id in the middle
                prefix, suffix = call.split(call_splitter)
                actual_call_name = prefix + call_splitter + str(test.context_id) + suffix
            call_lists.append(actual_call_name)
    
        switch_cases = "".join(
            [
                switch_case_with_return_template.format(
                    case=str(i), namespace=tests[i].GetLabel(), call=call_lists[i], params=params) if returns
                else switch_case_without_return_template.format(
                    case=str(i), namespace=tests[i].GetLabel(), call=call_lists[i], params=params) \
                for i in range(len(tests))
            ]
        )
        default_case = default_case_with_return_template.format(default_val=default_val) if returns \
            else default_case_without_return_template
        return switch_statement_template.format(switch_cases=switch_cases, default_case=default_case)
    
    
    def WriteAngleTraceGLHeader():
        f = open(os.path.join(REPLAY_SAMPLE_FOLDER, "angle_trace_gl.h"), "w")
        f.write("""#ifndef ANGLE_TRACE_GL_H_
    #define ANGLE_TRACE_GL_H_
    
    #include "util/util_gl.h"
    
    #endif  // ANGLE_TRACE_GL_H_
    """)
        f.close()
    
    
    class GroupedResult():
        Passed = "Passed"
        Failed = "Comparison Failed"
        TimedOut = "Timeout"
        Crashed = "Crashed"
        CompileFailed = "CompileFailed"
        Skipped = "Skipped"
    
    
        def __init__(self, resultcode, message, output, tests):
            self.resultcode = resultcode
            self.message = message
            self.output = output
            self.tests = []
            for test in tests:
                self.tests.append(test)
    
    
    class TestBatchResult():
    
        display_output_lines = 20
    
        def __init__(self, grouped_results, verbose):
            self.passes = []
            self.fails = []
            self.timeouts = []
            self.crashes = []
            self.compile_fails = []
            self.skips = []
    
            for grouped_result in grouped_results:
                if grouped_result.resultcode == GroupedResult.Passed:
                    for test in grouped_result.tests:
                        self.passes.append(test.full_test_name)
                elif grouped_result.resultcode == GroupedResult.Failed:
                    for test in grouped_result.tests:
                        self.fails.append(test.full_test_name)
                elif grouped_result.resultcode == GroupedResult.TimedOut:
                    for test in grouped_result.tests:
                        self.timeouts.append(test.full_test_name)
                elif grouped_result.resultcode == GroupedResult.Crashed:
                    for test in grouped_result.tests:
                        self.crashes.append(test.full_test_name)
                elif grouped_result.resultcode == GroupedResult.CompileFailed:
                    for test in grouped_result.tests:
                        self.compile_fails.append(test.full_test_name)
                elif grouped_result.resultcode == GroupedResult.Skipped:
                    for test in grouped_result.tests:
                        self.skips.append(test.full_test_name)
    
            self.repr_str = ""
            self.GenerateRepresentationString(grouped_results, verbose)
    
        def __str__(self):
            return self.repr_str
    
        def GenerateRepresentationString(self, grouped_results, verbose):
            for grouped_result in grouped_results:
                self.repr_str += grouped_result.resultcode + ": " + grouped_result.message + "\n"
                for test in grouped_result.tests:
                    self.repr_str += "\t" + test.full_test_name + "\n"
                if verbose:
                    self.repr_str += grouped_result.output
                else:
                    if grouped_result.resultcode == GroupedResult.CompileFailed:
                        self.repr_str += TestBatchResult.ExtractErrors(grouped_result.output)
                    else:
                        self.repr_str += TestBatchResult.GetAbbreviatedOutput(grouped_result.output)
    
        def ExtractErrors(output):
            lines = output.splitlines()
            error_lines = []
            for i in range(len(lines)):
                if ": error:" in lines[i]:
                    error_lines.append(lines[i] + "\n")
                    if i + 1 < len(lines):
                        error_lines.append(lines[i + 1] + "\n")
            return "".join(error_lines)
    
        def GetAbbreviatedOutput(output):
    
            # Get all lines after and including the last occurance of "Run".
            lines = output.splitlines()
            line_count = 0
            for line_index in reversed(range(len(lines))):
                line_count += 1
                if "[ RUN      ]" in lines[line_index]:
                    break
    
            return '\n' + '\n'.join(lines[-line_count:]) + '\n'
    
    
    class Test():
    
        def __init__(self, test_name):
            self.full_test_name = test_name
            self.params = test_name.split('/')[1]
            self.context_id = 0
            self.test_index = -1  # index of test within a test batch
    
        def __str__(self):
            return self.full_test_name + " Params: " + self.params
    
        def GetLabel(self):
            return self.full_test_name.replace(".", "_").replace("/", "_")
    
        def CanRunReplay(self, trace_folder_path):
            test_files = []
            label = self.GetLabel()
            assert (self.context_id == 0)
            for f in os.listdir(trace_folder_path):
                if os.path.isfile(os.path.join(trace_folder_path, f)) and f.startswith(label):
                    test_files.append(f)
            frame_files_count = 0
            context_header_count = 0
            context_source_count = 0
            source_txt_count = 0
            context_id = 0
            for f in test_files:
                if "_frame" in f:
                    frame_files_count += 1
                elif f.endswith(".txt"):
                    source_txt_count += 1
                elif f.endswith(".h"):
                    context_header_count += 1
                    context_id = int(f.split("capture_context")[1][:-2])
                elif f.endswith(".cpp"):
                    context_source_count += 1
            can_run_replay = frame_files_count >= 1 and context_header_count == 1 \
                and context_source_count == 1 and source_txt_count == 1
            if not can_run_replay:
                return False
            self.context_id = context_id
            return True
    
    
    class TestBatch():
    
        def __init__(self, use_goma, batch_count, keep_temp_files, goma_dir, verbose):
            self.use_goma = use_goma
            self.tests = []
            self.batch_count = batch_count
            self.keep_temp_files = keep_temp_files
            self.goma_dir = goma_dir
            self.verbose = verbose
            self.results = []
    
        def SetWorkerId(self, worker_id):
            self.trace_dir = "%s%d" % (TRACE_FOLDER, worker_id)
            self.trace_folder_path = os.path.join(REPLAY_SAMPLE_FOLDER, self.trace_dir)
    
        def RunWithCapture(self, args, child_processes_manager):
            test_exe_path = os.path.join(args.out_dir, 'Capture', args.test_suite)
    
            # set the static environment variables that do not change throughout the script run
            env = os.environ.copy()
            env['ANGLE_CAPTURE_FRAME_END'] = '100'
            env['ANGLE_CAPTURE_SERIALIZE_STATE'] = '1'
            env['ANGLE_CAPTURE_ENABLED'] = '1'
    
            info('Setting ANGLE_CAPTURE_OUT_DIR to %s' % self.trace_folder_path)
            env['ANGLE_CAPTURE_OUT_DIR'] = self.trace_folder_path
    
            if not self.keep_temp_files:
                ClearFolderContent(self.trace_folder_path)
            filt = ':'.join([test.full_test_name for test in self.tests])
    
            if args.xvfb:
                cmd = ['vpython', 'testing/xvfb.py', test_exe_path]
            else:
                cmd = [test_exe_path]
            cmd += ['--gtest_filter=%s' % filt, '--angle-per-test-capture-label']
    
            returncode, output = child_processes_manager.RunSubprocess(
                cmd, env, timeout=SUBPROCESS_TIMEOUT)
            if returncode == -1:
                self.results.append(GroupedResult(GroupedResult.Crashed, "", output, self.tests))
                return False
            elif returncode == -2:
                self.results.append(GroupedResult(GroupedResult.TimedOut, "", "", self.tests))
                return False
            return True
    
        def RemoveTestsThatDoNotProduceAppropriateTraceFiles(self):
            continued_tests = []
            skipped_tests = []
            for test in self.tests:
                if not test.CanRunReplay(self.trace_folder_path):
                    skipped_tests.append(test)
                else:
                    continued_tests.append(test)
            if len(skipped_tests) > 0:
                self.results.append(
                    GroupedResult(
                        GroupedResult.Skipped,
                        "Skipping replay since capture didn't produce necessary trace files", "",
                        skipped_tests))
            return continued_tests
    
        def BuildReplay(self, args, replay_build_dir, composite_file_id, tests,
                        child_processes_manager):
            # write gni file that holds all the traces files in a list
            self.CreateGNIFile(composite_file_id, tests)
            # write header and cpp composite files, which glue the trace files with
            # CaptureReplayTests.cpp
            self.CreateTestsCompositeFiles(composite_file_id, tests)
    
            gn_args = [("use_goma", str(self.use_goma).lower()),
                       ("angle_build_capture_replay_tests", "true"),
                       ("angle_capture_replay_test_trace_dir", '"%s"' % self.trace_dir),
                       ("angle_with_capture_by_default", "false"),
                       ("angle_capture_replay_composite_file_id", str(composite_file_id))]
            if self.goma_dir:
                gn_args.append(('goma_dir', '"%s"' % self.goma_dir))
            returncode, output = child_processes_manager.RunGNGenProcess(replay_build_dir, gn_args,
                                                                         True)
            if returncode != 0:
                self.results.append(
                    GroupedResult(GroupedResult.CompileFailed, "Build replay failed at gn generation",
                                  output, tests))
                return False
            returncode, output = child_processes_manager.RunNinjaProcess(args, replay_build_dir,
                                                                         REPLAY_BINARY, True)
            if returncode != 0:
                self.results.append(
                    GroupedResult(GroupedResult.CompileFailed, "Build replay failed at ninja", output,
                                  tests))
                return False
            return True
    
        def RunReplay(self, replay_exe_path, child_processes_manager, tests):
            env = os.environ.copy()
            env['ANGLE_CAPTURE_ENABLED'] = '0'
            env['ANGLE_FEATURE_OVERRIDES_ENABLED'] = 'enable_capture_limits'
            returncode, output = child_processes_manager.RunSubprocess([replay_exe_path],
                                                                       env,
                                                                       timeout=SUBPROCESS_TIMEOUT)
            if returncode == -1:
                self.results.append(
                    GroupedResult(GroupedResult.Crashed, "Replay run crashed", output, tests))
                return
            elif returncode == -2:
                self.results.append(
                    GroupedResult(GroupedResult.TimedOut, "Replay run timed out", "", tests))
                return
    
            output_lines = output.splitlines()
            passes = []
            fails = []
            count = 0
            for output_line in output_lines:
                words = output_line.split(" ")
                if len(words) == 3 and words[0] == RESULT_TAG:
                    if int(words[2]) == 0:
                        passes.append(self.FindTestByLabel(words[1]))
                    else:
                        fails.append(self.FindTestByLabel(words[1]))
                    count += 1
            if len(passes) > 0:
                self.results.append(GroupedResult(GroupedResult.Passed, "", "", passes))
            if len(fails) > 0:
                self.results.append(GroupedResult(GroupedResult.Failed, "", "", fails))
    
        def FindTestByLabel(self, label):
            for test in self.tests:
                if test.GetLabel() == label:
                    return test
            return None
    
        def AddTest(self, test):
            assert len(self.tests) <= self.batch_count
            test.index = len(self.tests)
            self.tests.append(test)
    
        # gni file, which holds all the sources for a replay application
        def CreateGNIFile(self, composite_file_id, tests):
            capture_sources = []
            for test in tests:
                label = test.GetLabel()
                assert (test.context_id > 0)
                trace_file_suffix = TRACE_FILE_SUFFIX + str(test.context_id)
                trace_files = [label + trace_file_suffix + ".h", label + trace_file_suffix + ".cpp"]
                try:
                    # reads from {label}_capture_context1_files.txt and adds the traces files recorded
                    # in there to the list of trace files
                    f = open(
                        os.path.join(self.trace_folder_path, label + trace_file_suffix + "_files.txt"))
                    trace_files += f.read().splitlines()
                    f.close()
                except IOError:
                    continue
                capture_sources += trace_files
            f = open(
                os.path.join(self.trace_folder_path, "traces" + str(composite_file_id) + ".gni"), "w")
            f.write("generated_sources = [\n")
            # write the list of trace files to the gni file
            for filename in capture_sources:
                f.write('    "' + filename + '",\n')
            f.write("]")
            f.close()
    
        # header and cpp composite files, which glue the trace files with CaptureReplayTests.cpp
        def CreateTestsCompositeFiles(self, composite_file_id, tests):
            # write CompositeTests header file
            h_filename = "CompositeTests" + str(composite_file_id) + ".h"
            h_file = open(os.path.join(self.trace_folder_path, h_filename), "w")
    
            include_header_template = '#include "{header_file_path}.h"\n'
            trace_headers = "".join([
                include_header_template.format(header_file_path=test.GetLabel() + TRACE_FILE_SUFFIX +
                                               str(test.context_id)) for test in tests
            ])
            h_file.write(composite_h_file_template.format(trace_headers=trace_headers))
            h_file.close()
    
            # write CompositeTests cpp file
            cpp_file = open(
                os.path.join(self.trace_folder_path,
                             "CompositeTests" + str(composite_file_id) + ".cpp"), "w")
    
            test_trace_info_inits = "".join([
                test_trace_info_init_template.format(namespace=tests[i].GetLabel())
                for i in range(len(tests))
            ])
            setup_context1_replay_switch_statement = WriteGeneratedSwitchStatements(
                tests, "SetupContextReplay", "")
            replay_context1_replay_switch_statement = WriteGeneratedSwitchStatements(
                tests, "ReplayContextFrame", "frameIndex")
            reset_context1_replay_switch_statement = WriteGeneratedSwitchStatements(
                tests, "ResetContextReplay", "")
            get_serialized_context1_state_data_switch_statement = WriteGeneratedSwitchStatements(
                tests, "GetSerializedContextState", "frameIndex", True, "{}")
            set_binary_data_decompress_callback_switch_statement = WriteGeneratedSwitchStatements(
                tests, "SetBinaryDataDecompressCallback", "callback")
            set_binary_data_dir_switch_statement = WriteGeneratedSwitchStatements(
                tests, "SetBinaryDataDir", "dataDir")
            cpp_file.write(
                composite_cpp_file_template.format(
                    h_filename=h_filename,
                    test_trace_info_inits=test_trace_info_inits,
                    setup_context1_replay_switch_statement=setup_context1_replay_switch_statement,
                    replay_context1_replay_switch_statement=replay_context1_replay_switch_statement,
                    reset_context1_replay_switch_statement=reset_context1_replay_switch_statement,
                    get_serialized_context1_state_data_switch_statement=get_serialized_context1_state_data_switch_statement,
                    set_binary_data_decompress_callback_switch_statement=set_binary_data_decompress_callback_switch_statement,
                    set_binary_data_dir_switch_statement=set_binary_data_dir_switch_statement))
            cpp_file.close()
    
        def __str__(self):
            repr_str = "TestBatch:\n"
            for test in self.tests:
                repr_str += ("\t" + str(test) + "\n")
            return repr_str
    
        def __getitem__(self, index):
            assert index < len(self.tests)
            return self.tests[index]
    
        def __iter__(self):
            return iter(self.tests)
    
        def GetResults(self):
            return TestBatchResult(self.results, self.verbose)
    
    
    def ClearFolderContent(path):
        all_files = []
        for f in os.listdir(path):
            if os.path.isfile(os.path.join(path, f)):
                os.remove(os.path.join(path, f))
    
    def SetCWDToAngleFolder():
        cwd = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", ".."))
        os.chdir(cwd)
        return cwd
    
    
    def RunTests(args, worker_id, job_queue, result_list, message_queue):
        replay_build_dir = os.path.join(args.out_dir, 'Replay%d' % worker_id)
        replay_exec_path = os.path.join(replay_build_dir, REPLAY_BINARY)
    
        child_processes_manager = ChildProcessesManager(args.depot_tools_path)
        # used to differentiate between multiple composite files when there are multiple test batchs
        # running on the same worker and --deleted_trace is set to False
        composite_file_id = 1
        while not job_queue.empty():
            try:
                test_batch = job_queue.get()
                message_queue.put("Starting {} tests on worker {}. Unstarted jobs: {}".format(
                    len(test_batch.tests), worker_id, job_queue.qsize()))
    
                test_batch.SetWorkerId(worker_id)
    
                success = test_batch.RunWithCapture(args, child_processes_manager)
                if not success:
                    result_list.append(test_batch.GetResults())
                    message_queue.put(str(test_batch.GetResults()))
                    continue
                continued_tests = test_batch.RemoveTestsThatDoNotProduceAppropriateTraceFiles()
                if len(continued_tests) == 0:
                    result_list.append(test_batch.GetResults())
                    message_queue.put(str(test_batch.GetResults()))
                    continue
                success = test_batch.BuildReplay(args, replay_build_dir, composite_file_id,
                                                 continued_tests, child_processes_manager)
                if test_batch.keep_temp_files:
                    composite_file_id += 1
                if not success:
                    result_list.append(test_batch.GetResults())
                    message_queue.put(str(test_batch.GetResults()))
                    continue
                test_batch.RunReplay(replay_exec_path, child_processes_manager, continued_tests)
                result_list.append(test_batch.GetResults())
                message_queue.put(str(test_batch.GetResults()))
            except KeyboardInterrupt:
                child_processes_manager.KillAll()
                raise
            except queue.Empty:
                child_processes_manager.KillAll()
                break
            except Exception as e:
                message_queue.put("RunTestsException: " + repr(e))
                child_processes_manager.KillAll()
                pass
        child_processes_manager.KillAll()
    
    
    def SafeDeleteFolder(folder_name):
        while os.path.isdir(folder_name):
            try:
                shutil.rmtree(folder_name)
            except KeyboardInterrupt:
                raise
            except PermissionError:
                pass
    
    
    def DeleteReplayBuildFolders(folder_num, replay_build_dir, trace_folder):
        for i in range(folder_num):
            folder_name = replay_build_dir + str(i)
            if os.path.isdir(folder_name):
                SafeDeleteFolder(folder_name)
    
    
    def CreateTraceFolders(folder_num):
        for i in range(folder_num):
            folder_name = TRACE_FOLDER + str(i)
            folder_path = os.path.join(REPLAY_SAMPLE_FOLDER, folder_name)
            if os.path.isdir(folder_path):
                shutil.rmtree(folder_path)
            os.makedirs(folder_path)
    
    
    def DeleteTraceFolders(folder_num):
        for i in range(folder_num):
            folder_name = TRACE_FOLDER + str(i)
            folder_path = os.path.join(REPLAY_SAMPLE_FOLDER, folder_name)
            if os.path.isdir(folder_path):
                SafeDeleteFolder(folder_path)
    
    
    def main(args):
        child_processes_manager = ChildProcessesManager(args.depot_tools_path)
        try:
            start_time = time.time()
            # set the number of workers to be cpu_count - 1 (since the main process already takes up a
            # CPU core). Whenever a worker is available, it grabs the next job from the job queue and
            # runs it. The worker closes down when there is no more job.
            worker_count = min(multiprocessing.cpu_count() - 1, args.max_jobs)
            cwd = SetCWDToAngleFolder()
    
            CreateTraceFolders(worker_count)
            WriteAngleTraceGLHeader()
            # generate gn files
            gn_args = [("use_goma", str(args.use_goma).lower()),
                       ("angle_with_capture_by_default", "true")]
            if args.goma_dir:
                gn_args.append(('goma_dir', '"%s"' % args.goma_dir))
            capture_build_dir = os.path.normpath(r"%s/Capture" % args.out_dir)
            returncode, output = child_processes_manager.RunGNGenProcess(capture_build_dir, gn_args,
                                                                         False)
            if returncode != 0:
                logging.error(output)
                child_processes_manager.KillAll()
                return EXIT_FAILURE
            # run ninja to build all tests
            returncode, output = child_processes_manager.RunNinjaProcess(args, capture_build_dir,
                                                                         args.test_suite, False)
            if returncode != 0:
                logging.error(output)
                child_processes_manager.KillAll()
                return EXIT_FAILURE
            # get a list of tests
            test_path = os.path.join(capture_build_dir, args.test_suite)
            test_list = GetTestsListForFilter(test_path, args.gtest_filter)
            test_names = ParseTestNamesFromTestList(test_list)
            # objects created by manager can be shared by multiple processes. We use it to create
            # collections that are shared by multiple processes such as job queue or result list.
            manager = multiprocessing.Manager()
            job_queue = manager.Queue()
            test_batch_num = int(math.ceil(len(test_names) / float(args.batch_count)))
    
            # put the test batchs into the job queue
            for batch_index in range(test_batch_num):
                batch = TestBatch(args.use_goma, int(args.batch_count), args.keep_temp_files,
                                  args.goma_dir, args.verbose)
                test_index = batch_index
                while test_index < len(test_names):
                    batch.AddTest(Test(test_names[test_index]))
                    test_index += test_batch_num
                job_queue.put(batch)
    
            passed_count = 0
            failed_count = 0
            timedout_count = 0
            crashed_count = 0
            compile_failed_count = 0
            skipped_count = 0
    
            failed_tests = []
            timed_out_tests = []
            crashed_tests = []
            compile_failed_tests = []
            skipped_tests = []
    
    
            # result list is created by manager and can be shared by multiple processes. Each
            # subprocess populates the result list with the results of its test runs. After all
            # subprocesses finish, the main process processes the results in the result list.
            # An item in the result list is a tuple with 3 values (testname, result, output).
            # The "result" can take 3 values "Passed", "Failed", "Skipped". The output is the
            # stdout and the stderr of the test appended together.
            result_list = manager.list()
            message_queue = manager.Queue()
            # so that we do not spawn more processes than we actually need
            worker_count = min(worker_count, test_batch_num)
            # spawning and starting up workers
            for worker_id in range(worker_count):
                proc = multiprocessing.Process(
                    target=RunTests, args=(args, worker_id, job_queue, result_list, message_queue))
                child_processes_manager.AddWorker(proc)
                proc.start()
    
            # print out messages from the message queue populated by workers
            # if there is no message, and the elapsed time between now and when the last message is
            # print exceeds TIME_BETWEEN_MESSAGE, prints out a message to signal that tests are still
            # running
            last_message_timestamp = 0
            while child_processes_manager.IsAnyWorkerAlive():
                while not message_queue.empty():
                    msg = message_queue.get()
                    info(msg)
                    last_message_timestamp = time.time()
                cur_time = time.time()
                if cur_time - last_message_timestamp > TIME_BETWEEN_MESSAGE:
                    last_message_timestamp = cur_time
                    info("Tests are still running. Remaining workers: " + \
                    str(child_processes_manager.GetRemainingWorkers()) + \
                    ". Unstarted jobs: " + str(job_queue.qsize()))
                time.sleep(1.0)
            child_processes_manager.JoinWorkers()
            while not message_queue.empty():
                msg = message_queue.get()
                logging.warning(msg)
            end_time = time.time()
    
            # print out results
            logging.info("\n\n\n")
            logging.info("Results:")
            for test_batch_result in result_list:
                debug(str(test_batch_result))
                passed_count += len(test_batch_result.passes)
                failed_count += len(test_batch_result.fails)
                timedout_count += len(test_batch_result.timeouts)
                crashed_count += len(test_batch_result.crashes)
                compile_failed_count += len(test_batch_result.compile_fails)
                skipped_count += len(test_batch_result.skips)
    
                for failed_test in test_batch_result.fails:
                    failed_tests.append(failed_test)
                for timeout_test in test_batch_result.timeouts:
                    timed_out_tests.append(timeout_test)
                for crashed_test in test_batch_result.crashes:
                    crashed_tests.append(crashed_test)
                for compile_failed_test in test_batch_result.compile_fails:
                    compile_failed_tests.append(compile_failed_test)
                for skipped_test in test_batch_result.skips:
                    skipped_tests.append(skipped_test)
    
            logging.info("\n\n")
            logging.info("Elapsed time: %.2lf seconds" % (end_time - start_time))
            logging.info(
                "Passed: %d, Comparison Failed: %d, Crashed: %d, CompileFailed %d, Skipped: %d, Timeout: %d"
                % (passed_count, failed_count, crashed_count, compile_failed_count, skipped_count,
                   timedout_count))
    
            retval = EXIT_SUCCESS
    
            if len(failed_tests):
                logging.info("Comparison Failed tests:")
                for failed_test in sorted(failed_tests):
                    logging.info("  " + failed_test)
                retval = EXIT_FAILURE
            if len(crashed_tests):
                logging.info("Crashed tests:")
                for crashed_test in sorted(crashed_tests):
                    logging.info("  " + crashed_test)
                retval = EXIT_FAILURE
            if len(compile_failed_tests):
                logging.info("Compile failed tests:")
                for compile_failed_test in sorted(compile_failed_tests):
                    logging.info("  " + compile_failed_test)
                retval = EXIT_FAILURE
            if len(skipped_tests):
                logging.info("Skipped tests:")
                for skipped_test in sorted(skipped_tests):
                    logging.info("  " + skipped_test)
            if len(timed_out_tests):
                logging.info("Timeout tests:")
                for timeout_test in sorted(timed_out_tests):
                    logging.info("  " + timeout_test)
                retval = EXIT_FAILURE
    
            # delete generated folders if --keep_temp_files flag is set to false
            if args.purge:
                os.remove(os.path.join(REPLAY_SAMPLE_FOLDER, "angle_trace_gl.h"))
                DeleteTraceFolders(worker_count)
                if os.path.isdir(args.out_dir):
                    SafeDeleteFolder(args.out_dir)
    
            # Try hard to ensure output is finished before ending the test.
            logging.shutdown()
            sys.stdout.flush()
            time.sleep(2.0)
            return retval
    
        except KeyboardInterrupt:
            child_processes_manager.KillAll()
            return EXIT_FAILURE
    
    
    if __name__ == "__main__":
        parser = argparse.ArgumentParser()
        parser.add_argument(
            '--out-dir',
            default=DEFAULT_OUT_DIR,
            help='Where to build ANGLE for capture and replay. Relative to the ANGLE folder. Default is "%s".'
            % DEFAULT_OUT_DIR)
        parser.add_argument(
            '--use-goma',
            action='store_true',
            help='Use goma for distributed builds. Requires internal access. Off by default.')
        parser.add_argument(
            '--gtest_filter',
            default=DEFAULT_FILTER,
            help='Same as GoogleTest\'s filter argument. Default is "%s".' % DEFAULT_FILTER)
        parser.add_argument(
            '--test-suite',
            default=DEFAULT_TEST_SUITE,
            help='Test suite binary to execute. Default is "%s".' % DEFAULT_TEST_SUITE)
        parser.add_argument(
            '--batch-count',
            default=DEFAULT_BATCH_COUNT,
            help='Number of tests in a batch. Default is %d.' % DEFAULT_BATCH_COUNT)
        parser.add_argument(
            '--keep-temp-files',
            action='store_true',
            help='Whether to keep the temp files and folders. Off by default')
        parser.add_argument('--purge', help='Purge all build directories on exit.')
        parser.add_argument(
            "--goma-dir",
            default="",
            help='Set custom goma directory. Uses the goma in path by default.')
        parser.add_argument(
            "--output-to-file",
            action='store_true',
            help='Whether to write output to a result file. Off by default')
        parser.add_argument(
            "--result-file",
            default=DEFAULT_RESULT_FILE,
            help='Name of the result file in the capture_replay_tests folder. Default is "%s".' %
            DEFAULT_RESULT_FILE)
        parser.add_argument('-v', "--verbose", action='store_true', help='Off by default')
        parser.add_argument(
            "-l",
            "--log",
            default=DEFAULT_LOG_LEVEL,
            help='Controls the logging level. Default is "%s".' % DEFAULT_LOG_LEVEL)
        parser.add_argument(
            '-j',
            '--max-jobs',
            default=DEFAULT_MAX_JOBS,
            type=int,
            help='Maximum number of test processes. Default is %d.' % DEFAULT_MAX_JOBS)
        parser.add_argument('--depot-tools-path', default=None, help='Path to depot tools')
        parser.add_argument('--xvfb', action='store_true', help='Run with xvfb.')
        args = parser.parse_args()
        if platform == "win32":
            args.test_suite += ".exe"
        if args.output_to_file:
            logging.basicConfig(level=args.log.upper(), filename=args.result_file)
        else:
            logging.basicConfig(level=args.log.upper())
        sys.exit(main(args))