""" Integration tests for the desktop boot handshake fix (PR #50231 / issue #50209). Simulates a slow hermes_cli.gateway import (15-30 s on a fresh Windows install with Defender scanning every new .pyc) by patching the two helpers that touch the blocking import and measuring response latency. Three scenarios are covered: 1. _lifespan synchronous warmup: patched _warm_gateway_module sleeps N seconds; TestClient startup blocks for >= N seconds (intentional — see #73083/#73291: the import doesn't release the GIL on Windows + Python 3.11, so run_in_executor still froze the event loop. Absorbing the cost before the lifespan yield ensures the server socket doesn't accept probes until the import is complete). 2. get_status run_in_executor: patched _resolve_restart_drain_timeout sleeps N seconds in a thread; a concurrent fast endpoint (/api/version) must respond during the wait, proving the event loop stayed free. 3. No orphan accumulation: three concurrent /api/status requests all receive a 200 response — no socket timeouts, no connection resets. """ from __future__ import annotations import asyncio import time import threading from unittest.mock import patch import pytest import hermes_cli.web_server as web_server_mod SLOW_SECONDS = 3 # represents the Defender worst-case (scaled down for CI speed) # --------------------------------------------------------------------------- # Helpers # --------------------------------------------------------------------------- def _make_slow_warm(seconds: float): """Return a _warm_gateway_module replacement that sleeps in the caller thread.""" def _slow(): time.sleep(seconds) return _slow def _make_slow_drain(seconds: float): """Return a _resolve_restart_drain_timeout replacement that sleeps in thread.""" def _slow(): time.sleep(seconds) return 180.0 return _slow # --------------------------------------------------------------------------- # Test 1 — _lifespan synchronous warmup blocks startup (intentional) # --------------------------------------------------------------------------- def test_lifespan_warmup_is_synchronous(): """ _warm_gateway_module runs synchronously before the lifespan yield (#73083). Startup blocks for at least SLOW_SECONDS — this is intentional: on Windows + Python 3.11 the import doesn't release the GIL, so run_in_executor still froze the event loop. Absorbing the cost before the yield ensures probes arrive after the import is complete. """ from fastapi.testclient import TestClient with patch.object(web_server_mod, "_warm_gateway_module", _make_slow_warm(SLOW_SECONDS)): t0 = time.perf_counter() with TestClient(web_server_mod.app, raise_server_exceptions=False) as _client: startup_ms = (time.perf_counter() - t0) * 1000 # Startup must block for at least SLOW_SECONDS (the import runs synchronously). # If startup were faster, the import would still be fire-and-forget (old behavior). threshold_ms = (SLOW_SECONDS * 1000) * 0.8 assert startup_ms >= threshold_ms, ( f"_lifespan did not block for the warmup import: startup took {startup_ms:.0f} ms " f"but slow import is {SLOW_SECONDS * 1000:.0f} ms — " f"warmup is not synchronous." ) # --------------------------------------------------------------------------- # Test 2 — get_status run_in_executor keeps event loop free for other requests # --------------------------------------------------------------------------- def test_get_status_does_not_block_event_loop(): """ /api/status calls _resolve_restart_drain_timeout via run_in_executor. While that slow call is running in a thread, a concurrent fast request (/api/version) must still get a response — proving the event loop stayed free during the import. """ import httpx from anyio import from_thread, to_thread results: dict[str, float] = {} errors: list[str] = [] async def _run(): transport = httpx.ASGITransport(app=web_server_mod.app) async with httpx.AsyncClient( transport=transport, base_url="http://test" ) as client: # Fire both requests concurrently async with asyncio.TaskGroup() as tg: async def _status(): t = time.perf_counter() r = await client.get("/api/status", timeout=SLOW_SECONDS + 5) results["status_ms"] = (time.perf_counter() - t) * 1000 results["status_code"] = r.status_code async def _version(): # Small delay so /api/status starts first await asyncio.sleep(0.1) t = time.perf_counter() r = await client.get("/api/version", timeout=5) results["version_ms"] = (time.perf_counter() - t) * 1000 results["version_code"] = r.status_code tg.create_task(_status()) tg.create_task(_version()) with patch.object( web_server_mod, "_resolve_restart_drain_timeout", _make_slow_drain(SLOW_SECONDS) ): asyncio.run(_run()) # /api/version must have responded well before /api/status finished assert "version_ms" in results, "Fast endpoint never responded" assert "status_ms" in results, "/api/status never responded" version_ms = results["version_ms"] status_ms = results["status_ms"] # /api/version should respond in < SLOW_SECONDS (event loop free) assert version_ms < SLOW_SECONDS * 1000, ( f"/api/version took {version_ms:.0f} ms — event loop was blocked by " f"/api/status (which waited {status_ms:.0f} ms for the slow import)." ) # /api/status itself eventually returns 200 assert results.get("status_code") == 200, ( f"/api/status returned {results.get('status_code')} instead of 200" ) # --------------------------------------------------------------------------- # Test 3 — no orphan accumulation: concurrent probes all receive 200 # --------------------------------------------------------------------------- def test_concurrent_status_probes_all_respond(): """ Three concurrent /api/status requests must all receive HTTP 200. If the event loop were blocked, later requests would pile up and the desktop shell would eventually reset the connection (WinError 10054). """ import httpx PROBES = 3 responses: list[int] = [] async def _run(): transport = httpx.ASGITransport(app=web_server_mod.app) async with httpx.AsyncClient( transport=transport, base_url="http://test" ) as client: tasks = [ client.get("/api/status", timeout=SLOW_SECONDS + 5) for _ in range(PROBES) ] results = await asyncio.gather(*tasks, return_exceptions=True) for r in results: if isinstance(r, Exception): responses.append(-1) else: responses.append(r.status_code) with patch.object( web_server_mod, "_resolve_restart_drain_timeout", _make_slow_drain(SLOW_SECONDS) ): asyncio.run(_run()) failed = [c for c in responses if c != 200] assert not failed, ( f"{len(failed)}/{PROBES} probes failed (codes: {responses}). " f"This would cause WinError 10054 and orphan accumulation on desktop." )