_search_worker.py 2.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273
  1. """DDGS search child-process entrypoint, run as ``python plugins/web/ddgs/_search_worker.py``.
  2. Reads one JSON request ``{"query": str, "safe_limit": int}`` from stdin, writes one
  3. envelope ``{"ok": true, "results": [...]}`` / ``{"ok": false, "error": str}`` to
  4. stdout, exits. Test hooks (``"test_hook": "sleep"|"gil"|"empty"``) are honored only
  5. when ``HERMES_DDGS_ALLOW_TEST_HOOKS=1``.
  6. """
  7. from __future__ import annotations
  8. import json
  9. import os
  10. import sys
  11. import time
  12. def _hold_gil(secs: int) -> None:
  13. """Block in a foreign call that keeps the GIL — mirrors native ``primp``.
  14. ``ctypes.PyDLL`` (unlike ``CDLL``/``WinDLL``) does not release the GIL."""
  15. import ctypes
  16. if sys.platform == "win32":
  17. sleep, secs = ctypes.PyDLL("kernel32").Sleep, secs * 1000
  18. else:
  19. try:
  20. sleep = ctypes.PyDLL(None).sleep
  21. except AttributeError: # pragma: no cover — macOS libSystem fallback
  22. sleep = ctypes.PyDLL("/usr/lib/libSystem.B.dylib").sleep
  23. sleep.argtypes = [ctypes.c_uint]
  24. sleep(int(secs))
  25. def _hang(block, name: str) -> dict:
  26. block(30)
  27. return {"ok": False, "error": f"{name} hook returned unexpectedly"}
  28. _TEST_HOOKS = {"sleep": lambda: _hang(time.sleep, "sleep"), "gil": lambda: _hang(_hold_gil, "gil"), "empty": lambda: {"ok": True, "results": []}}
  29. def _write_envelope(envelope: dict) -> None:
  30. json.dump(envelope, sys.stdout)
  31. sys.stdout.flush()
  32. def _fail(error: str, code: int) -> int:
  33. _write_envelope({"ok": False, "error": error})
  34. return code
  35. def main() -> int:
  36. try:
  37. request = json.load(sys.stdin)
  38. except Exception as exc:
  39. return _fail(f"invalid request: {exc}", 2)
  40. hook = request.get("test_hook")
  41. if hook:
  42. if os.environ.get("HERMES_DDGS_ALLOW_TEST_HOOKS") != "1":
  43. return _fail("test_hook refused (hooks not enabled)", 3)
  44. fn = _TEST_HOOKS.get(str(hook))
  45. envelope = fn() if fn else {"ok": False, "error": f"unknown test_hook: {hook!r}"}
  46. _write_envelope(envelope)
  47. return 0 if envelope.get("ok") else 1
  48. query, safe_limit = str(request.get("query") or ""), max(1, int(request.get("safe_limit") or 1))
  49. try:
  50. from plugins.web.ddgs.provider import _run_ddgs_search # lazy: light startup, patchable
  51. _write_envelope({"ok": True, "results": _run_ddgs_search(query, safe_limit)})
  52. return 0
  53. except Exception as exc:
  54. return _fail(f"{type(exc).__name__}: {exc}", 1)
  55. if __name__ == "__main__":
  56. raise SystemExit(main())