web_deps.py 3.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109
  1. """Late-binding dependency seam for extracted dashboard routers.
  2. ``web_server`` owns the dashboard app and its process state; routers under
  3. ``web_routers/`` cannot import it at import time (web_server imports them to mount them —
  4. a cycle) and must not copy its state (tests ``monkeypatch.setattr(web_server, ...)`` and
  5. expect that to win). ``late(name)`` / ``LateState(name)`` resolve ``<module>.<name>`` *at
  6. call time*; ``module`` defaults to ``web_server`` and may name a ``web_server_<concern>``
  7. module whose helper tests monkeypatch there.
  8. """
  9. from __future__ import annotations
  10. import importlib
  11. import sys
  12. from typing import Any
  13. WEB_SERVER = "hermes_cli.web_server"
  14. def _server(module: str = WEB_SERVER):
  15. """Return the live ``module`` (imported on demand)."""
  16. mod = sys.modules.get(module)
  17. if mod is None: # pragma: no cover - routers are only mounted by web_server
  18. mod = importlib.import_module(module)
  19. return mod
  20. def late(name: str, module: str = WEB_SERVER):
  21. """Late-binding proxy for a callable defined on ``module``."""
  22. def _proxy(*args: Any, **kwargs: Any):
  23. return getattr(_server(module), name)(*args, **kwargs)
  24. _proxy.__name__ = name
  25. _proxy.__qualname__ = name
  26. return _proxy
  27. class LateState:
  28. """Live proxy for module-level state owned by ``web_server``.
  29. Forwards attribute/item access, iteration, membership, len/truthiness, ``with`` (locks)
  30. and rich comparisons to ``web_server.<name>`` resolved at operation time — some state is
  31. defined *after* the router's ``include_router`` point, so a late import would miss it.
  32. """
  33. __slots__ = ("_module", "_name")
  34. def __init__(self, name: str, module: str = WEB_SERVER) -> None:
  35. object.__setattr__(self, "_name", name)
  36. object.__setattr__(self, "_module", module)
  37. def _target(self) -> Any:
  38. return getattr(_server(object.__getattribute__(self, "_module")),
  39. object.__getattribute__(self, "_name"))
  40. def __getattr__(self, attr: str) -> Any:
  41. return getattr(self._target(), attr)
  42. def __getitem__(self, key: Any) -> Any:
  43. return self._target()[key]
  44. def __setitem__(self, key: Any, value: Any) -> None:
  45. self._target()[key] = value
  46. def __delitem__(self, key: Any) -> None:
  47. del self._target()[key]
  48. def __contains__(self, item: Any) -> bool:
  49. return item in self._target()
  50. def __iter__(self):
  51. return iter(self._target())
  52. def __len__(self) -> int:
  53. return len(self._target())
  54. def __bool__(self) -> bool:
  55. return bool(self._target())
  56. def __enter__(self):
  57. return self._target().__enter__()
  58. def __exit__(self, *exc):
  59. return self._target().__exit__(*exc)
  60. def __eq__(self, other: object) -> bool:
  61. return self._target() == other
  62. def __ne__(self, other: object) -> bool:
  63. return self._target() != other
  64. def __lt__(self, other: Any) -> bool:
  65. return self._target() < other
  66. def __le__(self, other: Any) -> bool:
  67. return self._target() <= other
  68. def __gt__(self, other: Any) -> bool:
  69. return self._target() > other
  70. def __ge__(self, other: Any) -> bool:
  71. return self._target() >= other
  72. def __hash__(self) -> int:
  73. return hash(self._target())
  74. def __repr__(self) -> str: # pragma: no cover - debugging aid
  75. return f"<LateState {object.__getattribute__(self, '_name')} -> {self._target()!r}>"