exceptions.py

from collections.abc import Sequence
from typing import Any, Literal


class ValidationException(Exception):
    """
    Base exception for all validation errors
    """

    def __init__(self, errors: Sequence[Any]) -> None:
        self._errors = errors

    def errors(self) -> Sequence[Any]:
        return self._errors


class RequestValidationError(ValidationException):
    """
    Raised when the request body does not match the OpenAPI schema
    """

    def __init__(self, errors: Sequence[Any], *, body: Any = None) -> None:
        super().__init__(errors)
        self.body = body


class ResponseValidationError(ValidationException):
    """
    Raised when the response body does not match the OpenAPI schema
    """

    def __init__(self, errors: Sequence[Any], *, body: Any = None, source: Literal["route", "app"] = "app") -> None:
        super().__init__(errors)
        self.body = body
        self.source = source


class SerializationError(Exception):
    """
    Base exception for all encoding errors
    """


class SchemaValidationError(ValidationException):
    """
    Raised when the OpenAPI schema validation fails
    """


class OpenAPIMergeError(Exception):
    """Exception raised when there's a conflict during OpenAPI merge."""


class RequestUnsupportedContentType(NotImplementedError, ValidationException):
    """Exception raised when trying to read request body data, with unknown headers"""

    # REVIEW: This inheritance is for backwards compatibility.
    # Just inherit from ValidationException in Powertools V4
    def __init__(self, msg: str, errors: Sequence[Any]) -> None:
        NotImplementedError.__init__(self, msg)
        ValidationException.__init__(self, errors)