wrolpi/controller/api/disks.py

"""
Disk management API endpoints for WROLPi Controller.
"""

from typing import Optional

from fastapi import APIRouter, HTTPException
from pydantic import BaseModel, Field

from controller.lib.config import is_docker_mode
from controller.lib.disks import (
    get_block_devices,
    get_mounts,
    mount_drive,
    unmount_drive,
)
from controller.lib.fstab import (
    add_fstab_entry,
    get_wrolpi_fstab_entries,
    remove_fstab_entry,
)
from controller.lib.smart import (
    get_all_smart_status,
    is_smart_available,
)

router = APIRouter(prefix="/api/disks", tags=["disks"])


class MountRequest(BaseModel):
    """Request model for mounting a drive."""
    device: str = Field(description="Device path (e.g., /dev/sda1)")
    mount_point: str = Field(description="Where to mount (must be under /media)")
    fstype: Optional[str] = Field(default=None, description="Filesystem type (auto-detected if not specified)")
    options: str = Field(default="defaults", description="Mount options")
    persist: bool = Field(default=False, description="Add to fstab for persistent mounting")


class UnmountRequest(BaseModel):
    """Request model for unmounting a drive."""
    mount_point: str = Field(description="Mount point to unmount")
    lazy: bool = Field(default=False, description="Use lazy unmount if busy")


class FstabRequest(BaseModel):
    """Request model for adding an fstab entry."""
    device: str = Field(description="Device path")
    mount_point: str = Field(description="Where to mount")
    fstype: str = Field(description="Filesystem type")
    options: str = Field(default="defaults,nofail,x-systemd.device-timeout=10s", description="Mount options")


def _check_native_mode():
    """Raise 501 if in Docker mode."""
    if is_docker_mode():
        raise HTTPException(
            status_code=501,
            detail="Disk management is not available in Docker mode. "
                   "Configure mounts on the host system."
        )


@router.get("")
async def list_disks():
    """List all detected disks/partitions."""
    _check_native_mode()

    devices = get_block_devices()
    return [
        {
            "name": d.name,
            "path": d.path,
            "size": d.size,
            "fstype": d.fstype,
            "mountpoint": d.mountpoint,
            "label": d.label,
            "uuid": d.uuid,
            "model": d.model,
        }
        for d in devices
    ]


@router.get("/mounts")
async def list_mounts():
    """List current mounts under /media."""
    _check_native_mode()
    return get_mounts()


@router.post("/mount")
async def disk_mount(request: MountRequest):
    """Mount a partition."""
    _check_native_mode()

    result = mount_drive(
        device=request.device,
        mount_point=request.mount_point,
        fstype=request.fstype,
        options=request.options,
    )

    if not result.get("success"):
        raise HTTPException(status_code=500, detail=result.get("error", "Mount failed"))

    # Add to fstab if requested
    if request.persist:
        fstab_result = add_fstab_entry(
            device=request.device,
            mount_point=request.mount_point,
            fstype=request.fstype or "auto",
        )
        result["fstab"] = fstab_result

    return result


@router.post("/unmount")
async def disk_unmount(request: UnmountRequest):
    """Unmount a partition."""
    _check_native_mode()

    result = unmount_drive(
        mount_point=request.mount_point,
        lazy=request.lazy,
    )

    if not result.get("success"):
        raise HTTPException(status_code=500, detail=result.get("error", "Unmount failed"))

    return result


@router.get("/fstab")
async def list_fstab():
    """Get WROLPi-related fstab entries."""
    _check_native_mode()
    return get_wrolpi_fstab_entries()


@router.post("/fstab")
async def add_fstab(request: FstabRequest):
    """Add an fstab entry for persistent mounting."""
    _check_native_mode()

    result = add_fstab_entry(
        device=request.device,
        mount_point=request.mount_point,
        fstype=request.fstype,
        options=request.options,
    )

    if not result.get("success"):
        raise HTTPException(status_code=500, detail=result.get("error", "Failed"))

    return result


@router.delete("/fstab/{mount_point:path}")
async def delete_fstab(mount_point: str):
    """Remove an fstab entry."""
    _check_native_mode()

    # URL decode the mount point
    mount_point = f"/{mount_point}"

    result = remove_fstab_entry(mount_point)

    if not result.get("success"):
        raise HTTPException(status_code=500, detail=result.get("error", "Failed"))

    return result


# --- SMART ---

@router.get("/smart")
async def list_smart():
    """Get SMART status for all drives."""
    _check_native_mode()

    if not is_smart_available():
        return {"available": False, "reason": "pySMART not installed or not supported"}

    return {
        "available": True,
        "drives": get_all_smart_status(),
    }