Exceptions¶

class OxideHTTPError(Exception):
    """Base class for all HTTP errors."""

    def __init__(
        self,
        message: str,
        *,
        original: Exception | None = None,
        details: Mapping[str, object] | None = None,
    ) -> None:
        super().__init__(message)
        self.original = original
        self.details = details

class OxideRequestError(OxideHTTPError):
    """Error while processing an HTTP request."""

class OxideTimeoutError(OxideHTTPError, TimeoutError):
    """Request timed out."""

class OxideNetworkError(OxideHTTPError):
    """Network-level failure."""

class OxideRedirectError(OxideRequestError):
    """Too many redirects."""

class OxideDecodeError(OxideRequestError):
    """Failed to decode the response."""

class OxideJSONDecodeError(OxideDecodeError, ValueError):
    """Failed to decode a response as JSON."""

class OxideClientClosedError(OxideRequestError):
    """Client was closed while a request was being processed."""

class OxideBuilderError(OxideHTTPError, ValueError):
    """Failed to construct a request."""