Function run_test

ci/run_tests.py:252–355

Run a single test and capture its output

(
    test_file: Path, verbose: bool = False, enable_stack_trace: bool = False
)

def run_test(
    test_file: Path, verbose: bool = False, enable_stack_trace: bool = False
) -> TestResult:
    """Run a single test and capture its output"""
    global _ABORT_EVENT
    if _ABORT_EVENT.is_set():
        return TestResult(
            name=test_file.stem,
            success=False,
            duration=0.0,
            output="Test aborted because _ABORT_EVENT was set.",
            captured_lines=[],
        )
    start_time = time.time()

    # Build command with doctest flags
    # Convert to absolute path for Windows compatibility
    test_executable = test_file.resolve()
    cmd = [str(test_executable)]
    if not verbose:
        cmd.append("--minimal")  # Only show output for failures
    captured_lines: list[str] = []
    try:
        # Set timeout when stack traces are enabled to ensure stack trace functionality works
        timeout = (
            120 if enable_stack_trace else None
        )  # 2 minutes timeout for stack traces

        process = RunningProcess(
            command=cmd,
            cwd=_PROJECT_ROOT,
            check=False,
            shell=False,
            auto_run=True,
            timeout=timeout,
            output_formatter=TimestampFormatter(),
        )

        with process.line_iter(timeout=30) as it:
            if _ABORT_EVENT.is_set():
                return TestResult(
                    name=test_file.stem,
                    success=False,
                    duration=time.time() - start_time,
                    output="Test execution interrupted by user",
                    captured_lines=[],
                    return_code=130,  # SIGINT equivalent
                )
            for line in it:
                captured_lines.append(line)
                # Only print output if verbose is enabled
                if verbose:
                    print(line)

        # Wait for process to complete
        process.wait()
        return_code = process.poll()
        success = return_code == 0