forked from mtusi2026/mtusi2026lab6
146 lines
5.4 KiB
Python
146 lines
5.4 KiB
Python
import errno
|
|
|
|
from collections.abc import Mapping
|
|
|
|
from PIL import Image, UnidentifiedImageError
|
|
|
|
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", "Внутренняя ошибка сервера")
|
|
|
|
|
|
IMAGE_WORKER_ERRORS = (
|
|
ApiError,
|
|
Image.DecompressionBombError,
|
|
Image.DecompressionBombWarning,
|
|
MemoryError,
|
|
UnidentifiedImageError,
|
|
OSError,
|
|
ValueError,
|
|
SyntaxError,
|
|
)
|
|
|
|
|
|
def image_worker_error_code(error: Exception) -> int:
|
|
code = 2
|
|
resource_error = isinstance(
|
|
error,
|
|
(Image.DecompressionBombError, Image.DecompressionBombWarning, MemoryError),
|
|
)
|
|
declared_limit = isinstance(error, ApiError) and error.status_code == 413
|
|
if resource_error or declared_limit:
|
|
code = 3
|
|
return code
|
|
|
|
|
|
def image_validation_error(code: int) -> ApiError:
|
|
error = unsupported_media_type("Повреждённое изображение или несовпадение MIME")
|
|
if code == 3 or code < 0:
|
|
error = payload_too_large("Превышен лимит пикселей или ресурсов изображения")
|
|
return error
|
|
|
|
|
|
class ProcessingError(Exception):
|
|
"""Постоянная ошибка pipeline с безопасным машинным кодом."""
|
|
|
|
def __init__(self, code: str) -> None:
|
|
super().__init__(code)
|
|
self.code = code
|
|
|
|
|
|
class JobOperationError(Exception):
|
|
"""Безопасный код отказа операторской команды."""
|
|
|
|
def __init__(self, code: str):
|
|
self.code = code
|
|
super().__init__(code)
|
|
|
|
|
|
def pipeline_worker_error_code(error: Exception) -> int:
|
|
"""Отделить ошибки файловой системы от ошибки декодирования изображения."""
|
|
if isinstance(error, OSError) and error.errno is not None:
|
|
if error.errno in {errno.EACCES, errno.EPERM, errno.EROFS, errno.ENOENT}:
|
|
return 5
|
|
return 4
|
|
return image_worker_error_code(error)
|