Error handling

exoscale/api/exceptions.py

@@ -0,0 +1,28 @@
+# exceptions.py
+
+
+class ExoscaleAPIException(Exception):
+    """
+    Base exception for exoscale API errors.
+    Base for all other exception classes, it allows to catch all exoscale exceptions with a single except block.
+    """
+
+    pass
+
+
+class ExoscaleAPIClientException(ExoscaleAPIException):
+    """
+    For client-side errors (4xx).
+    Shows that the client sent a bad request.
+    """
+
+    pass
+
+
+class ExoscaleAPIServerException(ExoscaleAPIException):
+    """
+    For server-side errors (5xx).
+    Shows the server encountered an error while processing the request.
+    """
+
+    pass

exoscale/api/v2.py

@@ -27,6 +27,7 @@
 from pathlib import Path
 
 from exoscale_auth import ExoscaleV2Auth
+from .exceptions import ExoscaleAPIClientException, ExoscaleAPIServerException
 
 import requests
 
@@ -155,6 +156,17 @@ def _call_operation(self, operation_id, parameters=None, body=None):
         response = self.session.request(
             method=op["verb"].upper(), url=url, params=query_params, **json
         )
+
+        # Error handling
+        if response.status_code >= 400 and response.status_code < 500:
+            raise ExoscaleAPIClientException(
+                f"Client error {response.status_code}: {response.text}"
+            )
+        elif response.status_code >= 500:
+            raise ExoscaleAPIServerException(
+                f"Server error {response.status_code}: {response.text}"
+            )
+
         return response.json()