Function kill_stale_runner_processes

ci/meson/link_retry.py:66–116

Kill any runner.exe / example_runner.exe processes under *build_dir*. Iterates running processes (via ``psutil``) and terminates any whose name matches a known runner binary AND whose executable path resolves to somewhere under ``build_dir``. This avoids killing unrelated processes

(build_dir: Path)

def kill_stale_runner_processes(build_dir: Path) -> int:
    """Kill any runner.exe / example_runner.exe processes under *build_dir*.

    Iterates running processes (via ``psutil``) and terminates any whose name
    matches a known runner binary AND whose executable path resolves to
    somewhere under ``build_dir``. This avoids killing unrelated processes
    with the same name that happen to be running on the machine.

    Returns the number of processes killed. No-op and returns 0 on non-Windows.

    Safe to call when psutil is not importable — returns 0 silently.
    """
    if sys.platform != "win32":
        return 0

    try:
        import psutil  # noqa: PLC0415 - lazy import, Windows-only helper
    except ImportError:
        return 0

    try:
        build_root = str(build_dir.resolve())
    except OSError:
        return 0

    killed = 0
    for proc in psutil.process_iter(["pid", "name", "exe"]):
        try:
            name = (proc.info.get("name") or "").lower()
            if name not in _RUNNER_NAMES:
                continue

            exe = proc.info.get("exe")
            if not exe:
                continue

            # Only terminate runners launched from *our* build directory.
            try:
                exe_resolved = str(Path(exe).resolve())
            except OSError:
                continue

            if exe_resolved == build_root or exe_resolved.startswith(
                build_root + os.sep
            ):
                proc.kill()
                killed += 1
        except (psutil.NoSuchProcess, psutil.AccessDenied, OSError):
            continue

    return killed