Files
hermes-webui/tests/test_cron_run_job_import.py
T
2026-05-06 18:11:14 +00:00

98 lines
4.1 KiB
Python

"""Regression test for #1312 / #1310 — _run_cron_tracked must import run_job.
The function runs inside a worker thread (threading.Thread), so any
names it references must be resolvable from that thread's scope.
Before the fix, run_job was only imported inside _handle_cron_run
(a local scope invisible to _run_cron_tracked), causing NameError.
"""
import ast
import inspect
from pathlib import Path
import pytest
ROUTES_PY = Path(__file__).resolve().parent.parent / "api" / "routes.py"
def _get_function_source(func_name: str) -> str:
"""Extract a top-level function's source via AST for stability."""
tree = ast.parse(ROUTES_PY.read_text(encoding="utf-8"))
for node in ast.iter_child_nodes(tree):
if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef)) and node.name == func_name:
lines = ROUTES_PY.read_text(encoding="utf-8").splitlines()
return "\n".join(lines[node.lineno - 1 : node.end_lineno])
pytest.fail(f"Function {func_name} not found in {ROUTES_PY}")
class TestRunCronTrackedImport:
"""_run_cron_tracked must be self-contained — it runs in a worker thread."""
def test_run_job_imported_inside_function(self):
"""run_job must be imported inside the subprocess target, not relied on
from a caller's local scope."""
src = _get_function_source("_cron_job_subprocess_main")
tree = ast.parse(src)
names_used = set()
class NameCollector(ast.NodeVisitor):
def visit_Name(self, node):
names_used.add(node.id)
ImportCollector = type(
"ImportCollector",
(ast.NodeVisitor,),
{
"imports": set(),
"visit_ImportFrom": lambda self, node: (
self.imports.add(a.name for a in node.names),
),
},
)
# Collect all names referenced in the function body
for node in ast.walk(tree):
if isinstance(node, ast.Name) and isinstance(node.ctx, ast.Load):
names_used.add(node.id)
# Collect imports inside the function
func_imports = set()
for node in ast.walk(tree):
if isinstance(node, ast.ImportFrom):
for alias in node.names:
func_imports.add(alias.name if alias.asname is None else alias.asname)
elif isinstance(node, ast.Import):
for alias in node.names:
func_imports.add(alias.name if alias.asname is None else alias.asname)
# run_job is referenced → must be imported inside the function
if "run_job" in names_used:
assert "run_job" in func_imports, (
"_run_cron_tracked references run_job but does not import it locally. "
"It runs in a worker thread and cannot rely on caller's local imports."
)
def test_handle_cron_run_does_not_import_run_job(self):
"""After the fix, _handle_cron_run should NOT need to import run_job
itself — it's now _run_cron_tracked's responsibility."""
src = _get_function_source("_handle_cron_run")
tree = ast.parse(src)
imported_names = set()
for node in ast.walk(tree):
if isinstance(node, ast.ImportFrom):
for alias in node.names:
imported_names.add(alias.name if alias.asname is None else alias.asname)
assert "run_job" not in imported_names, (
"_handle_cron_run still imports run_job — it should be moved to "
"_run_cron_tracked to avoid the NameError in worker threads."
)
def test_run_cron_tracked_calls_run_job_helper(self):
"""Sanity: the function still delegates to the cron job runner."""
src = _get_function_source("_run_cron_tracked")
assert "_run_cron_job_in_profile_subprocess" in src
def test_cron_subprocess_target_calls_run_job(self):
"""Sanity: the subprocess target still actually calls run_job."""
src = _get_function_source("_cron_job_subprocess_main")
assert "run_job" in src, "cron subprocess target should call run_job"