from collections.abc import Mapping BASIC_CHALLENGE = 'Basic realm="messenger", charset="UTF-8"' BEARER_CHALLENGE = 'Bearer realm="messenger"' class ApiError(Exception): def __init__( self, status_code: int, code: str, message: str, headers: Mapping[str, str] | None = None, ) -> None: super().__init__(message) self.status_code = status_code self.code = code self.message = message self.headers = headers def invalid_request(message: str = "Неверный запрос") -> ApiError: """Создаёт ошибку некорректного или недопустимого запроса.""" return ApiError(400, "invalid_request", message) def unauthorized( message: str = "Нет действительной аутентификации", www_authenticate: str | None = None, ) -> ApiError: """Создаёт ошибку отсутствующей или недействительной аутентификации.""" headers = {"WWW-Authenticate": www_authenticate} if www_authenticate else None return ApiError(401, "unauthorized", message, headers) def unauthorized_basic(message: str = "Неверные учётные данные") -> ApiError: """401 для POST /auth/sessions (одинаковый для неверного username и пароля).""" return unauthorized(message, BASIC_CHALLENGE) def unauthorized_bearer(message: str = "Нет действительной сессии") -> ApiError: """401 для бизнес-endpoint: нет, истёк, отозван или неизвестен токен.""" return unauthorized(message, BEARER_CHALLENGE) def not_found(message: str = "Объект не найден") -> ApiError: """Создаёт ошибку, указывающую на отсутствие запрошенного ресурса.""" return ApiError(404, "not_found", message) def conflict(message: str = "Конфликт") -> ApiError: """Создаёт ошибку конфликта с текущим состоянием ресурса.""" return ApiError(409, "conflict", message) def payload_too_large(message: str = "Слишком большое тело запроса") -> ApiError: """Создаёт ошибку, указывающую на превышение допустимого размера запроса.""" return ApiError(413, "payload_too_large", message) def unsupported_media_type( message: str = "Требуется Content-Type: application/json", ) -> ApiError: """Создаёт ошибку неподдерживаемого формата или типа содержимого запроса.""" return ApiError(415, "unsupported_media_type", message) def rate_limited(retry_after: int = 1) -> ApiError: """Создаёт ошибку превышения допустимой частоты запросов.""" return ApiError( 429, "rate_limited", "Слишком много запросов", {"Retry-After": str(max(1, retry_after))}, ) def unavailable(message: str = "Сервис временно недоступен") -> ApiError: """Создаёт ошибку временной недоступности сервиса.""" return ApiError(503, "unavailable", message) def internal_error() -> ApiError: """Создаёт ошибку внутренней ошибки сервера.""" return ApiError(500, "internal_error", "Внутренняя ошибка сервера")