Function profile_server_spawn

scripts/profile_spawn.py:357–397

(binary: str, sample_interval_s: float)

# Server spawn profiling
# --------------------------------------------------------------------------- #
def profile_server_spawn(binary: str, sample_interval_s: float) -> dict | None:
    root = tempfile.mkdtemp(prefix="jcode-spawn-server-")
    env = isolated_env(root)
    sock = env["JCODE_SOCKET"]
    proc = None
    try:
        t0 = time.perf_counter()
        proc = subprocess.Popen(
            [binary, "--no-update", "serve"],
            stdout=subprocess.DEVNULL,
            stderr=subprocess.DEVNULL,
            env=env,
        )
        mon = ProcessMonitor(proc.pid)
        ready_ms = None
        deadline = t0 + 8.0
        while time.perf_counter() < deadline:
            if not mon.poll():
                break
            if ready_ms is None and socket_connectable(sock):
                ready_ms = (time.perf_counter() - t0) * 1000.0
                # keep sampling briefly to capture steady-state footprint
                settle_until = time.perf_counter() + 0.4
                while time.perf_counter() < settle_until:
                    mon.poll()
                    time.sleep(sample_interval_s)
                break
            time.sleep(sample_interval_s)
        res = mon.finalize()
        out = asdict(res)
        out["ready_ms"] = ready_ms
        return out
    finally:
        if proc is not None:
            proc.terminate()
            try:
                proc.wait(timeout=2)
            except subprocess.TimeoutExpired:
                proc.kill()
                proc.wait(timeout=2)
        shutil.rmtree(root, ignore_errors=True)


# --------------------------------------------------------------------------- #