tool.py

"""Data model representing the result of checking a single development tool."""

from dataclasses import dataclass
from enum import Enum
from typing import Optional


class ToolStatus(Enum):
    """Possible states a checked tool can be in."""

    INSTALLED = "Installed"
    NOT_INSTALLED = "Not Installed"
    VERSION_UNAVAILABLE = "Installed but version unavailable"


@dataclass
class ToolResult:
    """Holds the outcome of checking a single tool on the system."""

    name: str
    status: ToolStatus
    version: Optional[str] = None
    path: Optional[str] = None
    error: Optional[str] = None

    def to_dict(self) -> dict:
        """Convert this result into a plain dictionary suitable for JSON/CSV export."""
        return {
            "tool": self.name,
            "installed": self.status != ToolStatus.NOT_INSTALLED,
            "status": self.status.value,
            "version": self.version if self.version else "-",
            "path": self.path if self.path else "-",
            "error": self.error if self.error else "",
        }