| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204 |
- """
- -----------------------------------------------------------------------------------------
- INTERSEL - 4 cité d'Hauteville - 75010 PARIS
- RCS PARIS 488 379 660 - NAF 721Z
- File : api/modx_client.py
- Object : HTTP client to interact with the MODX REST API
- -----------------------------------------------------------------------------------------
- Modifications :
- - 2026/01/27 - Damien Lugagne-Delpon - V1.0.0- Creation
- -----------------------------------------------------------------------------------------
- @copyright : Intersel 2026
- @author : Damien Lugagne-Delpon - damien.lugagne-delpon@livinweb.fr
- @version : 1.0.0 (to be updated to the current_version of the developed software if file is touched)
- -----------------------------------------------------------------------------------------
- """
- import httpx
- import logging
- from typing import Dict, Any, Optional
- from mcp_server.config import settings
- from mcp_server.core.errors import (
- AuthenticationError,
- MODXAPIError,
- InternalError,
- )
- logger = logging.getLogger(__name__)
- class ModxClient:
- """Client HTTP pour communiquer avec l'API REST MODX."""
- def __init__(self):
- """Initialiser le client MODX."""
- self.base_url = settings.MODX_API_BASE_URL
- self.timeout = settings.MODX_API_TIMEOUT
- self.auth_type = settings.AUTH_TYPE
- self.auth_token = settings.AUTH_TOKEN
- self.client = httpx.Client(timeout=self.timeout)
- def _get_headers(self) -> Dict[str, str]:
- """
- Construire les headers pour les requêtes.
-
- Returns:
- Dict contenant les headers d'authentification
- """
- headers = {
- "Content-Type": "application/json",
- }
- # Ajouter l'authentification
- if self.auth_type == "bearer" and self.auth_token:
- headers["Authorization"] = f"Bearer {self.auth_token}"
- elif self.auth_type == "api_key" and self.auth_token:
- headers["X-API-Key"] = self.auth_token
- return headers
- def _handle_response(self, response: httpx.Response) -> Dict[str, Any]:
- """
- Traiter la réponse HTTP et lever les exceptions appropriées.
-
- Args:
- response: Réponse httpx
-
- Returns:
- Données JSON de la réponse
-
- Raises:
- AuthenticationError: Si authentification échouée
- MODXAPIError: Si erreur API MODX
- InternalError: Si erreur serveur
- """
- try:
- data = response.json()
- except Exception as e:
- logger.error(f"Erreur décodage JSON: {e}")
- raise InternalError(f"Invalid JSON response from MODX API: {str(e)}")
- # Vérifier statut HTTP
- if response.status_code == 401:
- raise AuthenticationError(
- "Authentication failed with MODX API",
- details={"status_code": 401, "response": data}
- )
- elif response.status_code == 403:
- raise AuthenticationError(
- "Access denied to MODX resource",
- details={"status_code": 403, "response": data}
- )
- elif response.status_code >= 400:
- error_msg = data.get("message", f"HTTP {response.status_code}")
- raise MODXAPIError(
- f"MODX API error: {error_msg}",
- code=response.status_code,
- details={"response": data}
- )
- return data
- def get(self, endpoint: str, params: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
- """
- Effectuer une requête GET.
-
- Args:
- endpoint: Chemin de l'endpoint (ex: "/resource/1")
- params: Paramètres query optionnels
-
- Returns:
- Réponse JSON
- """
- url = f"{self.base_url}{endpoint}"
- headers = self._get_headers()
- try:
- logger.debug(f"GET {url}")
- response = self.client.get(url, headers=headers, params=params)
- return self._handle_response(response)
- except (AuthenticationError, MODXAPIError, InternalError):
- raise
- except Exception as e:
- logger.error(f"Erreur requête GET {url}: {e}")
- raise InternalError(f"Request failed: {str(e)}")
- def post(self, endpoint: str, data: Dict[str, Any]) -> Dict[str, Any]:
- """
- Effectuer une requête POST.
-
- Args:
- endpoint: Chemin de l'endpoint (ex: "/resource")
- data: Données à envoyer
-
- Returns:
- Réponse JSON
- """
- url = f"{self.base_url}{endpoint}"
- headers = self._get_headers()
- try:
- logger.debug(f"POST {url} with data: {data}")
- response = self.client.post(url, headers=headers, json=data)
- return self._handle_response(response)
- except (AuthenticationError, MODXAPIError, InternalError):
- raise
- except Exception as e:
- logger.error(f"Erreur requête POST {url}: {e}")
- raise InternalError(f"Request failed: {str(e)}")
- def put(self, endpoint: str, data: Dict[str, Any]) -> Dict[str, Any]:
- """
- Effectuer une requête PUT.
-
- Args:
- endpoint: Chemin de l'endpoint (ex: "/resource/1")
- data: Données à envoyer
-
- Returns:
- Réponse JSON
- """
- url = f"{self.base_url}{endpoint}"
- headers = self._get_headers()
- try:
- logger.debug(f"PUT {url} with data: {data}")
- response = self.client.put(url, headers=headers, json=data)
- return self._handle_response(response)
- except (AuthenticationError, MODXAPIError, InternalError):
- raise
- except Exception as e:
- logger.error(f"Erreur requête PUT {url}: {e}")
- raise InternalError(f"Request failed: {str(e)}")
- def close(self):
- """Fermer la connexion du client."""
- self.client.close()
- def __enter__(self):
- """Support du context manager."""
- return self
- def __exit__(self, exc_type, exc_val, exc_tb):
- """Support du context manager."""
- self.close()
- # Instance globale du client
- _modx_client: Optional[ModxClient] = None
- def get_modx_client() -> ModxClient:
- """
- Obtenir l'instance globale du client MODX.
-
- Returns:
- Instance de ModxClient
- """
- global _modx_client
- if _modx_client is None:
- _modx_client = ModxClient()
- return _modx_client
|