initialisation.py 3.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113
  1. """Initialisation unique : chargement .env, validation, démarrage du moteur MCP."""
  2. from __future__ import annotations
  3. import os
  4. from dotenv import load_dotenv
  5. from dokuwiki_mcp.config.logging_setup import configure_logging, get_logger
  6. REQUIRED_VARS = ("BASE_URL", "WIKI_USERNAME", "WIKI_PASSWORD")
  7. JSONRPC_ENDPOINT = "/lib/exe/jsonrpc.php"
  8. DEFAULT_TTL = 60
  9. DEFAULT_MAX_ENTRIES = 20
  10. DEFAULT_TIMEOUT = 5.0
  11. class ConfigError(RuntimeError):
  12. """Variables d'environnement manquantes ou invalides."""
  13. class Initialisation:
  14. """Singleton de configuration globale (conception §7.3)."""
  15. _instance: Initialisation | None = None
  16. def __new__(cls) -> Initialisation:
  17. if cls._instance is None:
  18. cls._instance = super().__new__(cls)
  19. return cls._instance
  20. def __init__(self) -> None:
  21. if getattr(self, "_loaded", False):
  22. return
  23. load_dotenv()
  24. self._loaded = True
  25. @classmethod
  26. def reset(cls) -> None:
  27. cls._instance = None
  28. def _require(self, name: str) -> str:
  29. value = (os.environ.get(name) or "").strip()
  30. if not value:
  31. raise ConfigError(
  32. f"Variables d'environnement manquantes: {name}. "
  33. "Renseigner BASE_URL, WIKI_USERNAME et WIKI_PASSWORD dans .env."
  34. )
  35. return value
  36. def valider(self) -> None:
  37. missing = [name for name in REQUIRED_VARS if not (os.environ.get(name) or "").strip()]
  38. if missing:
  39. raise ConfigError(
  40. f"Variables d'environnement manquantes: {', '.join(missing)}. "
  41. "Renseigner BASE_URL, WIKI_USERNAME et WIKI_PASSWORD dans .env."
  42. )
  43. @property
  44. def base_url(self) -> str:
  45. return self._require("BASE_URL").rstrip("/")
  46. @property
  47. def username(self) -> str:
  48. return self._require("WIKI_USERNAME")
  49. @property
  50. def password(self) -> str:
  51. return self._require("WIKI_PASSWORD")
  52. def _positive_int(self, name: str, default: int) -> int:
  53. raw = (os.environ.get(name) or "").strip()
  54. if not raw:
  55. return default
  56. try:
  57. value = int(raw)
  58. except ValueError as exc:
  59. raise ConfigError(f"{name} doit être un entier.") from exc
  60. if value <= 0:
  61. raise ConfigError(f"{name} doit être strictement positif.")
  62. return value
  63. @property
  64. def ttl(self) -> int:
  65. return self._positive_int("CACHE_TTL", DEFAULT_TTL)
  66. @property
  67. def max_entries(self) -> int:
  68. return self._positive_int("CACHE_MAX_ENTRIES", DEFAULT_MAX_ENTRIES)
  69. @property
  70. def timeout(self) -> float:
  71. return DEFAULT_TIMEOUT
  72. @property
  73. def jsonrpc_endpoint(self) -> str:
  74. return JSONRPC_ENDPOINT
  75. def execute(self) -> None:
  76. configure_logging()
  77. logger = get_logger()
  78. try:
  79. self.valider()
  80. except ConfigError as exc:
  81. logger.error("%s", exc)
  82. raise SystemExit(str(exc)) from exc
  83. from dokuwiki_mcp.mcp.server import run
  84. run()
  85. def main() -> None:
  86. Initialisation().execute()