devnomads 0.3.1__tar.gz → 0.4.1__tar.gz

{devnomads-0.3.1 → devnomads-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devnomads
-Version: 0.3.1
+Version: 0.4.1
 Summary: Python client library for the DevNomads API (transport, DNS, ACME)
 Project-URL: Homepage, https://devnomads.nl
 Author-email: DevNomads <support@devnomads.nl>

{devnomads-0.3.1 → devnomads-0.4.1}/openapi.json

@@ -2926,6 +2926,146 @@
                 ]
             }
         },
+        "/services/servers/{serviceId}/snapshots": {
+            "get": {
+                "tags": [
+                    "Server"
+                ],
+                "summary": "Get list of server snapshots",
+                "description": "Get list of snapshots for a server service",
+                "operationId": "services.servers.snapshots.index",
+                "parameters": [
+                    {
+                        "name": "serviceId",
+                        "in": "path",
+                        "description": "Service ID",
+                        "required": true,
+                        "schema": {
+                            "type": "integer"
+                        }
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Success"
+                    }
+                },
+                "security": [
+                    {
+                        "bearerToken": []
+                    }
+                ]
+            },
+            "post": {
+                "tags": [
+                    "Server"
+                ],
+                "summary": "Create server snapshot",
+                "description": "Create a new snapshot for a server service",
+                "operationId": "services.servers.snapshots.create",
+                "parameters": [
+                    {
+                        "name": "serviceId",
+                        "in": "path",
+                        "description": "Service ID",
+                        "required": true,
+                        "schema": {
+                            "type": "integer"
+                        }
+                    }
+                ],
+                "responses": {
+                    "202": {
+                        "description": "Accepted"
+                    }
+                },
+                "security": [
+                    {
+                        "bearerToken": []
+                    }
+                ]
+            }
+        },
+        "/services/servers/{serviceId}/snapshots/{snapshotUuid}/restore": {
+            "get": {
+                "tags": [
+                    "Server"
+                ],
+                "summary": "Restore server snapshot",
+                "description": "Restore a snapshot for a server service",
+                "operationId": "services.servers.snapshots.restore",
+                "parameters": [
+                    {
+                        "name": "serviceId",
+                        "in": "path",
+                        "description": "Service ID",
+                        "required": true,
+                        "schema": {
+                            "type": "integer"
+                        }
+                    },
+                    {
+                        "name": "snapshotUuid",
+                        "in": "path",
+                        "description": "Snapshot UUID",
+                        "required": true,
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                ],
+                "responses": {
+                    "202": {
+                        "description": "Accepted"
+                    }
+                },
+                "security": [
+                    {
+                        "bearerToken": []
+                    }
+                ]
+            }
+        },
+        "/services/servers/{serviceId}/snapshots/{snapshotUuid}": {
+            "delete": {
+                "tags": [
+                    "Server"
+                ],
+                "summary": "Delete server snapshot",
+                "description": "Delete a snapshot for a server service",
+                "operationId": "services.servers.snapshots.delete",
+                "parameters": [
+                    {
+                        "name": "serviceId",
+                        "in": "path",
+                        "description": "Service ID",
+                        "required": true,
+                        "schema": {
+                            "type": "integer"
+                        }
+                    },
+                    {
+                        "name": "snapshotUuid",
+                        "in": "path",
+                        "description": "Snapshot UUID",
+                        "required": true,
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                ],
+                "responses": {
+                    "202": {
+                        "description": "Accepted"
+                    }
+                },
+                "security": [
+                    {
+                        "bearerToken": []
+                    }
+                ]
+            }
+        },
         "/services": {
             "get": {
                 "tags": [

{devnomads-0.3.1 → devnomads-0.4.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "devnomads"
-version = "0.3.1"
+version = "0.4.1"
 description = "Python client library for the DevNomads API (transport, DNS, ACME)"
 readme = "README.md"
 requires-python = ">=3.10"

{devnomads-0.3.1 → devnomads-0.4.1}/src/devnomads/api/_services.py

@@ -717,6 +717,43 @@ class ServersResource:
         path = f"/services/servers/{service_id}/state/{state}"
         return self._client.request("GET", path, params=params)
 
+    @property
+    def snapshots(self) -> ServersSnapshotsResource:
+        return ServersSnapshotsResource(self._client)
+
+
+class ServersSnapshotsResource:
+    """Generated resource accessor."""
+
+    def __init__(self, client: Client) -> None:
+        self._client = client
+
+    def create(
+        self, service_id: str, params: dict | None = None, body: Any = None
+    ) -> Any:
+        """Create server snapshot"""
+        path = f"/services/servers/{service_id}/snapshots"
+        return self._client.request("POST", path, params=params, json_body=body)
+
+    def delete(
+        self, service_id: str, snapshot_uuid: str, params: dict | None = None
+    ) -> Any:
+        """Delete server snapshot"""
+        path = f"/services/servers/{service_id}/snapshots/{snapshot_uuid}"
+        return self._client.request("DELETE", path, params=params)
+
+    def list(self, service_id: str, params: dict | None = None) -> Any:
+        """Get list of server snapshots"""
+        path = f"/services/servers/{service_id}/snapshots"
+        return self._client.request("GET", path, params=params)
+
+    def restore(
+        self, service_id: str, snapshot_uuid: str, params: dict | None = None
+    ) -> Any:
+        """Restore server snapshot"""
+        path = f"/services/servers/{service_id}/snapshots/{snapshot_uuid}/restore"
+        return self._client.request("GET", path, params=params)
+
 
 class SitesResource:
     """Generated resource accessor."""

{devnomads-0.3.1 → devnomads-0.4.1}/src/devnomads/api/client.py

@@ -124,12 +124,26 @@ class Client(ResourcesMixin):
                 status=status,
                 detail=_error_detail(response),
             )
+        if 300 <= status < 400:
+            location = response.headers.get("location", "")
+            raise ApiError(
+                f"API returned an unexpected HTTP {status} redirect"
+                + (f" to {location}" if location else "")
+                + " - the endpoint or credentials may be misrouted",
+                status=status,
+                detail=location,
+            )
         if status == 204 or not response.content:
             return None
         try:
             return _unwrap(response.json())
         except ValueError as exc:
-            raise ApiError(f"API returned invalid JSON: {exc}", status=status) from exc
+            snippet = response.text[:200].strip()
+            raise ApiError(
+                f"API returned invalid JSON (HTTP {status}): {exc}; "
+                f"body starts with: {snippet!r}",
+                status=status,
+            ) from exc
 
     def _send(
         self,