Function stop_daemon

src/cocoindex_code/client.py:498–546

Stop the daemon gracefully. Escalation: StopRequest → SIGTERM → SIGKILL.

()

def stop_daemon() -> None:
    """Stop the daemon gracefully.

    Escalation: StopRequest → SIGTERM → SIGKILL.
    """
    global _daemon_ensured  # noqa: PLW0603
    _daemon_ensured = False
    _surfaced_warnings.clear()
    pid_path = daemon_pid_path()

    pid: int | None = None
    try:
        pid = int(pid_path.read_text().strip())
        if pid == os.getpid():
            pid = None
    except (FileNotFoundError, ValueError):
        pass

    # 1) Graceful StopRequest via socket (bypass auto-start)
    try:
        conn = _raw_connect_and_handshake()
        try:
            conn.send_bytes(encode_request(StopRequest()))
            conn.recv_bytes()
        finally:
            conn.close()
    except (ConnectionRefusedError, OSError, RuntimeError, DaemonVersionError):
        pass

    if _wait_for_daemon_exit(timeout=3.0):
        return

    # 2) SIGTERM
    if pid is not None and _pid_alive(pid):
        try:
            os.kill(pid, signal.SIGTERM)
        except (ProcessLookupError, PermissionError):
            pass
        if _wait_for_daemon_exit(timeout=2.0):
            return

    # 3) SIGKILL (Unix) — on Windows SIGTERM already calls TerminateProcess
    if sys.platform != "win32" and pid is not None and _pid_alive(pid):
        try:
            os.kill(pid, signal.SIGKILL)
        except (ProcessLookupError, PermissionError):
            pass

    _cleanup_stale_files(pid_path, pid)


def _cleanup_stale_files(pid_path: Path, pid: int | None) -> None: