thorcast_api_client 0.1.2__py3-none-any.whl

thorcast_api_client/auth.py

@@ -0,0 +1,34 @@
+import requests
+from thorcast_api_client.config import API_BASE_URL
+
+class AuthManager:
+    """Gère l'authentification et le rafraîchissement du token JWT."""
+
+    def __init__(self, identifier: str, password: str):
+        self.identifier = identifier
+        self.password = password
+        self.token = None
+        self.refresh_token = None
+        self.is_active = None
+        self.user_id = None
+
+    def authenticate(self):
+        """Récupère un token JWT"""
+        url = f"{API_BASE_URL}/backend/auth/token/"
+        payload = {"email": self.identifier, "password": self.password}
+        
+        response = requests.post(url, json=payload)
+        if response.status_code == 200:
+            data = response.json()
+            self.token = data["access"]
+            self.refresh_token = data["refresh"]
+            self.is_active = data.get("is_active", None)
+            self.user_id = data.get("user_id", None)
+        else:
+            raise Exception(f"Erreur d'authentification: {response.text}")
+
+    def get_headers(self):
+        """Retourne les headers avec le token d'accès"""
+        if not self.token:
+            raise Exception("Token non défini, veuillez vous authentifier.")
+        return {"Authorization": f"Bearer {self.token}"}

thorcast_api_client/client.py

@@ -0,0 +1,56 @@
+import requests
+from thorcast_api_client.auth import AuthManager
+from thorcast_api_client.config import API_BASE_URL
+from thorcast_api_client.exceptions import APIClientError, AuthenticationError, RateLimitExceeded, ServerError
+
+class ThorCastClient:
+    """Client pour interagir avec l'API ThorCast."""
+    
+    def __init__(self, username: str, password: str):
+        self.auth = AuthManager(username, password)
+        self.auth.authenticate()
+
+    def _request(self, method: str, endpoint: str, **kwargs):
+        """Méthode générique pour effectuer une requête."""
+        url = f"{API_BASE_URL}{endpoint}"
+        headers = self.auth.get_headers()
+
+        response = requests.request(method, url, headers=headers, **kwargs)
+        
+        if response.status_code == 401:
+            raise AuthenticationError(401, "Echec d'authentification, token invalide.")
+        elif response.status_code == 429:
+            raise RateLimitExceeded(429, "Limite de requêtes dépassée.")
+        elif response.status_code >= 500:
+            raise ServerError(response.status_code, "Erreur interne du serveur.")
+        elif not response.ok:
+            raise APIClientError(response.status_code, "Erreur inconnue.")
+
+        return response.json()
+
+    def get_lt_curves_versions(self, prms: list):
+        """Liste les versions disponibles des courbes de charge LT."""
+        endpoint = f"/backend/thorcast/v1/lt_curves/versions/?prms={','.join(prms)}"
+        return self._request("GET", endpoint)
+
+    def get_lt_curves(self, prms: list, sd: str, ed: str, versions: list = None, tz: str = "UTC"):
+        """Récupère les courbes de charge LT."""
+        endpoint = f"/backend/thorcast/v1/lt_curves/?prms={','.join(prms)}&sd={sd}&ed={ed}&tz={tz}"
+        if versions:
+            endpoint += f"&versions={','.join(versions)}"
+        return self._request("GET", endpoint)
+    
+    def get_historical_curves(self, prms: list, sd: str, ed: str, tz: str = "UTC"):
+        """Récupère les courbes de charge historiques."""
+        endpoint = f"/backend/thorcast/v1/historical_load_curves/?prms={','.join(prms)}&sd={sd}&ed={ed}&tz={tz}"
+        return self._request("GET", endpoint)
+    
+    def get_catalog_versions(self, catalogs: list, sd: str, ed: str):
+        """Liste les versions disponibles des courbes de charge LT."""
+        endpoint = f"/backend/thorcast/v1/catalog_curves/versions/?catalogs={','.join(catalogs)}&sd={sd}&ed={ed}"
+        return self._request("GET", endpoint)
+    
+    def get_catalog_curves(self, ids: list, tz: str = "UTC"):
+        """Récupère les courbes de charge catalog."""
+        endpoint = f"/backend/thorcast/v1/catalog_curves/?ids={','.join(ids)}&tz={tz}"
+        return self._request("GET", endpoint)

thorcast_api_client/config.py

@@ -0,0 +1,5 @@
+API_BASE_URL = "https://profilage-api.holmium-consulting.com"
+HEADERS = {
+    "Accept": "application/json",
+    "Content-Type": "application/json",
+}

thorcast_api_client/exceptions.py

@@ -0,0 +1,19 @@
+class APIClientError(Exception):
+    """Exception générique pour les erreurs API."""
+
+    def __init__(self, status_code, message):
+        self.status_code = status_code
+        self.message = message
+        super().__init__(f"API Error {status_code}: {message}")
+
+class AuthenticationError(APIClientError):
+    """Erreur spécifique à l'authentification (ex: JWT expiré, mauvais identifiants)."""
+    pass
+
+class RateLimitExceeded(APIClientError):
+    """Erreur lorsque la limite de requêtes est dépassée."""
+    pass
+
+class ServerError(APIClientError):
+    """Erreur interne du serveur API."""
+    pass

thorcast_api_client-0.1.2.dist-info/METADATA

@@ -0,0 +1,15 @@
+Metadata-Version: 2.3
+Name: thorcast_api_client
+Version: 0.1.2
+Summary: Un client Python pour interagir avec l'API ThorCast
+Author: JBCAYRE
+Author-email: jcayre@mint.eco
+Requires-Python: >=3.8,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: requests (>=2.26.0,<3.0.0)

thorcast_api_client-0.1.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+thorcast_api_client/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+thorcast_api_client/auth.py,sha256=BK0JY2W2uJ9CBEAbCTZJfeWcCg9wkXBZG0Lt42s6S4g,1303
+thorcast_api_client/client.py,sha256=4k5cwm7J8R9BKqThNstUfLX88OWMC30BPDdewspWRoU,2805
+thorcast_api_client/config.py,sha256=wITbKmrJAQ6aefoLc49mWaIajldD_VqvO-I0kwseXnE,155
+thorcast_api_client/exceptions.py,sha256=bzoZtKJiCQwxvtx3wG5pt8ePhHovsje2NdVSxYUTNU0,633
+thorcast_api_client-0.1.2.dist-info/METADATA,sha256=RjDkpQG9XAwVGuwS9oBcfDbiEI7YWSj38JOhwHUY-vA,592
+thorcast_api_client-0.1.2.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+thorcast_api_client-0.1.2.dist-info/RECORD,,

thorcast_api_client-0.1.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.1.1
+Root-Is-Purelib: true
+Tag: py3-none-any