api/machines: split off config validation into separate endpoint

- This speeds up PUT /machines{name}/config as it doesn't do the expensive check anymore
- instead use PUT /machines/{name}/verify which allows a dry-run evaluation of a config which is passed without writing it to disk

pkgs/clan-cli/clan_cli/config/machine.py

@@ -64,16 +64,13 @@ def config_for_machine(machine_name: str) -> dict:
         return json.load(f)
 
 
-def set_config_for_machine(machine_name: str, config: dict) -> Optional[str]:
+def set_config_for_machine(machine_name: str, config: dict) -> None:
     # write the config to a json file located at {flake}/machines/{machine_name}/settings.json
     if not machine_folder(machine_name).exists():
         raise HTTPException(
             status_code=404,
             detail=f"Machine {machine_name} not found. Create the machine first`",
         )
-    error = verify_machine_config(machine_name, config)
-    if error is not None:
-        return error
     settings_path = machine_settings_file(machine_name)
     settings_path.parent.mkdir(parents=True, exist_ok=True)
     with open(settings_path, "w") as f:
@@ -82,7 +79,6 @@ def set_config_for_machine(machine_name: str, config: dict) -> Optional[str]:
 
     if repo_dir is not None:
         commit_file(settings_path, repo_dir)
-    return None
 
 
 def schema_for_machine(

pkgs/clan-cli/clan_cli/webui/routers/machines.py

@@ -2,7 +2,7 @@
 import logging
 from typing import Annotated
 
-from fastapi import APIRouter, Body, HTTPException
+from fastapi import APIRouter, Body
 
 from ...config.machine import (
     config_for_machine,
@@ -57,9 +57,7 @@ async def get_machine_config(name: str) -> ConfigResponse:
 async def set_machine_config(
     name: str, config: Annotated[dict, Body()]
 ) -> ConfigResponse:
-    error = set_config_for_machine(name, config)
-    if error is not None:
-        raise HTTPException(status_code=400, detail=error)
+    set_config_for_machine(name, config)
     return ConfigResponse(config=config)
 
 
@@ -78,7 +76,17 @@ async def set_machine_schema(
 
 
 @router.get("/api/machines/{name}/verify")
-async def put_verify_machine_config(name: str) -> VerifyMachineResponse:
+async def get_verify_machine_config(name: str) -> VerifyMachineResponse:
     error = verify_machine_config(name)
     success = error is None
     return VerifyMachineResponse(success=success, error=error)
+
+
+@router.put("/api/machines/{name}/verify")
+async def put_verify_machine_config(
+    name: str,
+    config: Annotated[dict, Body()],
+) -> VerifyMachineResponse:
+    error = verify_machine_config(name, config)
+    success = error is None
+    return VerifyMachineResponse(success=success, error=error)