modx_client.py 6.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204
  1. """
  2. -----------------------------------------------------------------------------------------
  3. INTERSEL - 4 cité d'Hauteville - 75010 PARIS
  4. RCS PARIS 488 379 660 - NAF 721Z
  5. File : api/modx_client.py
  6. Object : HTTP client to interact with the MODX REST API
  7. -----------------------------------------------------------------------------------------
  8. Modifications :
  9. - 2026/01/27 - Damien Lugagne-Delpon - V1.0.0- Creation
  10. -----------------------------------------------------------------------------------------
  11. @copyright : Intersel 2026
  12. @author : Damien Lugagne-Delpon - damien.lugagne-delpon@livinweb.fr
  13. @version : 1.0.0 (to be updated to the current_version of the developed software if file is touched)
  14. -----------------------------------------------------------------------------------------
  15. """
  16. import httpx
  17. import logging
  18. from typing import Dict, Any, Optional
  19. from mcp_server.config import settings
  20. from mcp_server.core.errors import (
  21. AuthenticationError,
  22. MODXAPIError,
  23. InternalError,
  24. )
  25. logger = logging.getLogger(__name__)
  26. class ModxClient:
  27. """Client HTTP pour communiquer avec l'API REST MODX."""
  28. def __init__(self):
  29. """Initialiser le client MODX."""
  30. self.base_url = settings.MODX_API_BASE_URL
  31. self.timeout = settings.MODX_API_TIMEOUT
  32. self.auth_type = settings.AUTH_TYPE
  33. self.auth_token = settings.AUTH_TOKEN
  34. self.client = httpx.Client(timeout=self.timeout)
  35. def _get_headers(self) -> Dict[str, str]:
  36. """
  37. Construire les headers pour les requêtes.
  38. Returns:
  39. Dict contenant les headers d'authentification
  40. """
  41. headers = {
  42. "Content-Type": "application/json",
  43. }
  44. # Ajouter l'authentification
  45. if self.auth_type == "bearer" and self.auth_token:
  46. headers["Authorization"] = f"Bearer {self.auth_token}"
  47. elif self.auth_type == "api_key" and self.auth_token:
  48. headers["X-API-Key"] = self.auth_token
  49. return headers
  50. def _handle_response(self, response: httpx.Response) -> Dict[str, Any]:
  51. """
  52. Traiter la réponse HTTP et lever les exceptions appropriées.
  53. Args:
  54. response: Réponse httpx
  55. Returns:
  56. Données JSON de la réponse
  57. Raises:
  58. AuthenticationError: Si authentification échouée
  59. MODXAPIError: Si erreur API MODX
  60. InternalError: Si erreur serveur
  61. """
  62. try:
  63. data = response.json()
  64. except Exception as e:
  65. logger.error(f"Erreur décodage JSON: {e}")
  66. raise InternalError(f"Invalid JSON response from MODX API: {str(e)}")
  67. # Vérifier statut HTTP
  68. if response.status_code == 401:
  69. raise AuthenticationError(
  70. "Authentication failed with MODX API",
  71. details={"status_code": 401, "response": data}
  72. )
  73. elif response.status_code == 403:
  74. raise AuthenticationError(
  75. "Access denied to MODX resource",
  76. details={"status_code": 403, "response": data}
  77. )
  78. elif response.status_code >= 400:
  79. error_msg = data.get("message", f"HTTP {response.status_code}")
  80. raise MODXAPIError(
  81. f"MODX API error: {error_msg}",
  82. code=response.status_code,
  83. details={"response": data}
  84. )
  85. return data
  86. def get(self, endpoint: str, params: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
  87. """
  88. Effectuer une requête GET.
  89. Args:
  90. endpoint: Chemin de l'endpoint (ex: "/resource/1")
  91. params: Paramètres query optionnels
  92. Returns:
  93. Réponse JSON
  94. """
  95. url = f"{self.base_url}{endpoint}"
  96. headers = self._get_headers()
  97. try:
  98. logger.debug(f"GET {url}")
  99. response = self.client.get(url, headers=headers, params=params)
  100. return self._handle_response(response)
  101. except (AuthenticationError, MODXAPIError, InternalError):
  102. raise
  103. except Exception as e:
  104. logger.error(f"Erreur requête GET {url}: {e}")
  105. raise InternalError(f"Request failed: {str(e)}")
  106. def post(self, endpoint: str, data: Dict[str, Any]) -> Dict[str, Any]:
  107. """
  108. Effectuer une requête POST.
  109. Args:
  110. endpoint: Chemin de l'endpoint (ex: "/resource")
  111. data: Données à envoyer
  112. Returns:
  113. Réponse JSON
  114. """
  115. url = f"{self.base_url}{endpoint}"
  116. headers = self._get_headers()
  117. try:
  118. logger.debug(f"POST {url} with data: {data}")
  119. response = self.client.post(url, headers=headers, json=data)
  120. return self._handle_response(response)
  121. except (AuthenticationError, MODXAPIError, InternalError):
  122. raise
  123. except Exception as e:
  124. logger.error(f"Erreur requête POST {url}: {e}")
  125. raise InternalError(f"Request failed: {str(e)}")
  126. def put(self, endpoint: str, data: Dict[str, Any]) -> Dict[str, Any]:
  127. """
  128. Effectuer une requête PUT.
  129. Args:
  130. endpoint: Chemin de l'endpoint (ex: "/resource/1")
  131. data: Données à envoyer
  132. Returns:
  133. Réponse JSON
  134. """
  135. url = f"{self.base_url}{endpoint}"
  136. headers = self._get_headers()
  137. try:
  138. logger.debug(f"PUT {url} with data: {data}")
  139. response = self.client.put(url, headers=headers, json=data)
  140. return self._handle_response(response)
  141. except (AuthenticationError, MODXAPIError, InternalError):
  142. raise
  143. except Exception as e:
  144. logger.error(f"Erreur requête PUT {url}: {e}")
  145. raise InternalError(f"Request failed: {str(e)}")
  146. def close(self):
  147. """Fermer la connexion du client."""
  148. self.client.close()
  149. def __enter__(self):
  150. """Support du context manager."""
  151. return self
  152. def __exit__(self, exc_type, exc_val, exc_tb):
  153. """Support du context manager."""
  154. self.close()
  155. # Instance globale du client
  156. _modx_client: Optional[ModxClient] = None
  157. def get_modx_client() -> ModxClient:
  158. """
  159. Obtenir l'instance globale du client MODX.
  160. Returns:
  161. Instance de ModxClient
  162. """
  163. global _modx_client
  164. if _modx_client is None:
  165. _modx_client = ModxClient()
  166. return _modx_client