Files
hermes-agent/tests/tools/test_daemon_pool.py
ethernet b48cc47a4c fix(tools): use Python 3.14 daemon worker contexts
Python 3.14 moves initializer state into a worker context. The old worker arguments fail on the first submission to a fresh executor.

Use the current stdlib worker signature while preserving daemon shutdown and per-submission profile isolation. Cover worker initialization and context isolation on reused threads.

Verified on Python 3.14.7: 41 focused tests pass through scripts/run_tests.sh. Ruff and diff checks pass. Packaged release verification remains pending.
2026-09-08 17:04:44 -04:00

130 lines
4.2 KiB
Python

"""Tests for tools.daemon_pool.DaemonThreadPoolExecutor.
The daemon pool exists so abandoned workers (interrupted/timed-out tool
batches, wedged memory-provider syncs) can never block interpreter exit:
stdlib ThreadPoolExecutor workers are non-daemon AND registered in
concurrent.futures.thread._threads_queues, whose atexit hook joins every
worker unconditionally — even after shutdown(wait=False).
"""
import subprocess
import sys
import threading
import time
from concurrent.futures.thread import _threads_queues
from tools.daemon_pool import DaemonThreadPoolExecutor
def test_workers_are_daemon_threads():
pool = DaemonThreadPoolExecutor(max_workers=2)
try:
info = pool.submit(
lambda: (threading.current_thread().daemon, threading.current_thread())
).result(timeout=10)
is_daemon, worker = info
assert is_daemon is True
# Not registered with concurrent.futures' atexit join hook.
assert worker not in _threads_queues
finally:
pool.shutdown(wait=True)
def test_initializer_runs_on_each_worker_before_tasks():
local = threading.local()
ready = threading.Barrier(2, timeout=10)
initialized = []
lock = threading.Lock()
marker = object()
def initialize(value):
local.value = value
with lock:
initialized.append(threading.current_thread())
def task():
ready.wait()
return local.value, threading.current_thread()
with DaemonThreadPoolExecutor(max_workers=2, initializer=initialize, initargs=(marker,)) as pool:
futures = [pool.submit(task) for _ in range(2)]
results = [future.result(timeout=10) for future in futures]
workers = {worker for _, worker in results}
assert len(workers) == 2
assert set(initialized) == workers
assert len(initialized) == len(workers)
assert all(value is marker for value, _ in results)
assert all(worker.daemon and worker not in _threads_queues for worker in workers)
def test_idle_worker_reuse():
pool = DaemonThreadPoolExecutor(max_workers=4)
try:
tid1 = pool.submit(threading.get_ident).result(timeout=10)
time.sleep(0.05) # let the worker park on the idle semaphore
tid2 = pool.submit(threading.get_ident).result(timeout=10)
assert tid1 == tid2
finally:
pool.shutdown(wait=True)
def test_wedged_worker_does_not_block_interpreter_exit():
"""A worker stuck in a long sleep must not hold the process open.
With stdlib ThreadPoolExecutor this subprocess hangs until the sleep
finishes (the atexit hook joins the worker); with the daemon pool it
exits as soon as the main thread returns.
"""
script = (
"import sys; sys.path.insert(0, %r)\n"
"from tools.daemon_pool import DaemonThreadPoolExecutor\n"
"import time\n"
"pool = DaemonThreadPoolExecutor(max_workers=1)\n"
"pool.submit(time.sleep, 120)\n"
"time.sleep(0.3)\n"
"pool.shutdown(wait=False)\n"
"print('main-done', flush=True)\n"
) % (str(_repo_root()),)
proc = subprocess.run(
[sys.executable, "-c", script],
capture_output=True,
text=True,
timeout=30,
)
assert proc.returncode == 0
assert "main-done" in proc.stdout
def test_submit_propagates_caller_contextvars():
"""A reused worker must not mix profile scopes or leak task mutations."""
from contextvars import ContextVar
var = ContextVar("daemon_pool_test_var", default="unset")
def read_and_mutate():
seen = var.get()
var.set("worker mutation")
return seen, threading.current_thread()
with DaemonThreadPoolExecutor(max_workers=1) as pool:
futures = []
for profile in ("first", "second"):
token = var.set(profile)
try:
futures.append(pool.submit(read_and_mutate))
finally:
var.reset(token)
results = [future.result(timeout=10) for future in futures]
assert [seen for seen, _ in results] == ["first", "second"]
assert results[0][1] is results[1][1]
assert pool.submit(var.get).result(timeout=10) == "unset"
assert var.get() == "unset"
def _repo_root():
import pathlib
return pathlib.Path(__file__).resolve().parents[2]