| """Machine-readable error taxonomy (section 14).""" |
| from __future__ import annotations |
|
|
| from enum import Enum |
| from typing import Any |
|
|
|
|
| class ErrorCode(str, Enum): |
| INVALID_INPUT = "INVALID_INPUT" |
| UNSUPPORTED_METHOD = "UNSUPPORTED_METHOD" |
| RESOURCE_LIMIT = "RESOURCE_LIMIT" |
| TIMEOUT = "TIMEOUT" |
| SOLVER_FAILURE = "SOLVER_FAILURE" |
| NON_CONVERGENCE = "NON_CONVERGENCE" |
| NUMERICAL_WARNING = "NUMERICAL_WARNING" |
| DATA_SOURCE_UNAVAILABLE = "DATA_SOURCE_UNAVAILABLE" |
| CHECKSUM_MISMATCH = "CHECKSUM_MISMATCH" |
| CANCELLED = "CANCELLED" |
| UNKNOWN = "UNKNOWN" |
|
|
|
|
| class MatterOSError(Exception): |
| """Base error carrying a taxonomy code and structured details.""" |
|
|
| def __init__(self, code: ErrorCode, message: str, **details: Any): |
| super().__init__(f"{code.value}: {message}") |
| self.code = code |
| self.message = message |
| self.details = details |
|
|
| def to_dict(self) -> dict[str, Any]: |
| return {"error": self.code.value, "message": self.message, "details": self.details} |
|
|
|
|
| def invalid(message: str, **details: Any) -> MatterOSError: |
| return MatterOSError(ErrorCode.INVALID_INPUT, message, **details) |
|
|
