feat: reset password

Author: jooola

hcloud/storage_boxes/client.py

@@ -435,11 +435,38 @@ def change_type(
         :param storage_box: Storage Box to update.
         :param storage_box_type: Type of Storage Box to change to.
         """
-        data: dict[str, Any] = {"storage_box_type": storage_box_type.id_or_name}
+        data: dict[str, Any] = {
+            "storage_box_type": storage_box_type.id_or_name,
+        }
 
         response = self._client.request(
             method="POST",
             url=f"{self._base_url}/{storage_box.id}/actions/change_type",
             json=data,
         )
         return BoundAction(self._parent.actions, response["action"])
+
+    def reset_password(
+        self,
+        storage_box: StorageBox | BoundStorageBox,
+        *,
+        password: str,
+    ) -> BoundAction:
+        """
+        Reset the password of a Storage Box.
+
+        See https://docs.hetzner.cloud/reference/cloud#TODO
+
+        :param storage_box: Storage Box to update.
+        :param password: Password for the Storage Box.
+        """
+        data: dict[str, Any] = {
+            "password": password,
+        }
+
+        response = self._client.request(
+            method="POST",
+            url=f"{self._base_url}/{storage_box.id}/actions/reset_password",
+            json=data,
+        )
+        return BoundAction(self._parent.actions, response["action"])

tests/unit/storage_boxes/test_client.py

@@ -348,3 +348,24 @@ def test_change_type(
         )
 
         assert_bound_action1(action, resource_client._parent.actions)
+
+    def test_reset_password(
+        self,
+        request_mock: mock.MagicMock,
+        resource_client: StorageBoxesClient,
+        action_response,
+    ):
+        request_mock.return_value = action_response
+
+        action = resource_client.reset_password(
+            StorageBox(id=42),
+            password="password",
+        )
+
+        request_mock.assert_called_with(
+            method="POST",
+            url="/storage_boxes/42/actions/reset_password",
+            json={"password": "password"},
+        )
+
+        assert_bound_action1(action, resource_client._parent.actions)