feat: enable_snapshot_plan

Author: jooola

hcloud/storage_boxes/client.py

@@ -536,3 +536,25 @@ def disable_snapshot_plan(
             url=f"{self._base_url}/{storage_box.id}/actions/disable_snapshot_plan",
         )
         return BoundAction(self._parent.actions, response["action"])
+
+    def enable_snapshot_plan(
+        self,
+        storage_box: StorageBox | BoundStorageBox,
+        snapshot_plan: StorageBoxSnapshotPlan,
+    ) -> BoundAction:
+        """
+        Enable the snapshot plan a Storage Box.
+
+        See https://docs.hetzner.cloud/reference/cloud#TODO
+
+        :param storage_box: Storage Box to update.
+        :param snapshot_plan: Snapshot Plan to enable.
+        """
+        data: dict[str, Any] = snapshot_plan.to_payload()
+
+        response = self._client.request(
+            method="POST",
+            url=f"{self._base_url}/{storage_box.id}/actions/enable_snapshot_plan",
+            json=data,
+        )
+        return BoundAction(self._parent.actions, response["action"])

hcloud/storage_boxes/domain.py

@@ -157,27 +157,41 @@ class StorageBoxSnapshotPlan(BaseDomain):
 
     __api_properties__ = (
         "max_snapshots",
-        "minute",
         "hour",
+        "minute",
         "day_of_week",
         "day_of_month",
     )
     __slots__ = __api_properties__
 
     def __init__(
         self,
-        max_snapshots: int | None = None,
-        minute: int | None = None,
-        hour: int | None = None,
+        max_snapshots: int,
+        hour: int,
+        minute: int,
         day_of_week: int | None = None,
         day_of_month: int | None = None,
     ):
         self.max_snapshots = max_snapshots
-        self.minute = minute
         self.hour = hour
+        self.minute = minute
         self.day_of_week = day_of_week
         self.day_of_month = day_of_month
 
+    def to_payload(self) -> dict[str, Any]:
+        """
+        Generates the request payload from this domain object.
+        """
+        payload: dict[str, Any] = {
+            "max_snapshots": self.max_snapshots,
+            "hour": self.hour,
+            "minute": self.minute,
+            "day_of_week": self.day_of_week,  # API default is null
+            "day_of_month": self.day_of_month,  # API default is null
+        }
+
+        return payload
+
 
 class CreateStorageBoxResponse(BaseDomain):
     """

tests/unit/storage_boxes/test_client.py

@@ -14,6 +14,7 @@
     BoundStorageBox,
     StorageBox,
     StorageBoxesClient,
+    StorageBoxSnapshotPlan,
 )
 from hcloud.storage_boxes.domain import StorageBoxAccessSettings, StorageBoxSnapshot
 
@@ -438,3 +439,35 @@ def test_disable_snapshot_plan(
         )
 
         assert_bound_action1(action, resource_client._parent.actions)
+
+    def test_enable_snapshot_plan(
+        self,
+        request_mock: mock.MagicMock,
+        resource_client: StorageBoxesClient,
+        action_response,
+    ):
+        request_mock.return_value = action_response
+
+        action = resource_client.enable_snapshot_plan(
+            StorageBox(id=42),
+            StorageBoxSnapshotPlan(
+                max_snapshots=10,
+                hour=3,
+                minute=30,
+                day_of_week=None,
+            ),
+        )
+
+        request_mock.assert_called_with(
+            method="POST",
+            url="/storage_boxes/42/actions/enable_snapshot_plan",
+            json={
+                "max_snapshots": 10,
+                "hour": 3,
+                "minute": 30,
+                "day_of_week": None,
+                "day_of_month": None,
+            },
+        )
+
+        assert_bound_action1(action, resource_client._parent.actions)