coolipy.resources.security

 1"""Security (private keys) resource clients (sync + async)."""
 2
 3from __future__ import annotations
 4
 5from typing import Any
 6
 7from coolipy._base import AsyncResourceBase, ResourceBase
 8from coolipy._response import CoolipyAPIResponse
 9from coolipy.models.common import MessageResponse, UUIDResponse
10from coolipy.models.security import (
11    PrivateKeyCreateModel,
12    PrivateKeyModel,
13    PrivateKeyUpdateModel,
14)
15
16PrivateKeyList = list[PrivateKeyModel]
17
18
19def _dump(model: Any) -> dict[str, Any]:
20    return model.model_dump(mode="json", exclude_none=True)
21
22
23class Security(ResourceBase):
24    """Synchronous client for Coolify private keys."""
25
26    def list(self) -> CoolipyAPIResponse[PrivateKeyList]:
27        """List all private keys."""
28        return self._get("/security/keys", response_model=list[PrivateKeyModel])
29
30    def get(self, uuid: str) -> CoolipyAPIResponse[PrivateKeyModel]:
31        """Get a private key by UUID."""
32        return self._get(f"/security/keys/{uuid}", response_model=PrivateKeyModel)
33
34    def create(self, model: PrivateKeyCreateModel) -> CoolipyAPIResponse[UUIDResponse]:
35        """Create a private key."""
36        return self._post("/security/keys", json=_dump(model), response_model=UUIDResponse)
37
38    def update(self, uuid: str, model: PrivateKeyUpdateModel) -> CoolipyAPIResponse[UUIDResponse]:
39        """Update a private key by UUID."""
40        return self._patch(f"/security/keys/{uuid}", json=_dump(model), response_model=UUIDResponse)
41
42    def delete(self, uuid: str) -> CoolipyAPIResponse[MessageResponse]:
43        """Delete a private key by UUID."""
44        return self._delete(f"/security/keys/{uuid}", response_model=MessageResponse)
45
46
47class AsyncSecurity(AsyncResourceBase):
48    """Asynchronous client for Coolify private keys."""
49
50    async def list(self) -> CoolipyAPIResponse[PrivateKeyList]:
51        """List all private keys."""
52        return await self._get("/security/keys", response_model=list[PrivateKeyModel])
53
54    async def get(self, uuid: str) -> CoolipyAPIResponse[PrivateKeyModel]:
55        """Get a private key by UUID."""
56        return await self._get(f"/security/keys/{uuid}", response_model=PrivateKeyModel)
57
58    async def create(self, model: PrivateKeyCreateModel) -> CoolipyAPIResponse[UUIDResponse]:
59        """Create a private key."""
60        return await self._post("/security/keys", json=_dump(model), response_model=UUIDResponse)
61
62    async def update(
63        self, uuid: str, model: PrivateKeyUpdateModel
64    ) -> CoolipyAPIResponse[UUIDResponse]:
65        """Update a private key by UUID."""
66        return await self._patch(
67            f"/security/keys/{uuid}", json=_dump(model), response_model=UUIDResponse
68        )
69
70    async def delete(self, uuid: str) -> CoolipyAPIResponse[MessageResponse]:
71        """Delete a private key by UUID."""
72        return await self._delete(f"/security/keys/{uuid}", response_model=MessageResponse)