Files
mtusi2026lab2-fork/app/http_utils.py
T
2026-10-23 14:09:32 +03:00

103 lines
3.9 KiB
Python

"""Помощники HTTP: чтение JSON, проверка тела, разбор UUID, limit и cursor."""
import json
import re
from typing import Optional, Type, TypeVar
from fastapi import Request
from pydantic import BaseModel, ValidationError
from .cursor import Key, UUID_RE, decode_cursor
from .errors import ApiError
MAX_BODY_BYTES = 256 * 1024
DEFAULT_LIMIT = 50
MAX_LIMIT = 100
T = TypeVar("T", bound=BaseModel)
def bad_request(message: str) -> ApiError:
"""Ошибка 400 invalid_request."""
return ApiError(400, "invalid_request", message)
def _reject_constant(name: str):
"""Запретить NaN и Infinity в JSON."""
raise ValueError("недопустимое значение " + name)
async def read_json_object(request: Request) -> dict:
"""Прочитать тело запроса как JSON-объект."""
content_type = request.headers.get("content-type", "")
media_type, _, params = content_type.partition(";")
if media_type.strip().lower() != "application/json":
raise ApiError(
415, "unsupported_media_type", "Нужен Content-Type: application/json"
)
charset = re.search(r"charset\s*=\s*\"?([^\";\s]+)", params, re.IGNORECASE)
if charset and charset.group(1).lower() not in ("utf-8", "utf8"):
raise ApiError(
415, "unsupported_media_type", "Поддерживается только кодировка UTF-8"
)
declared = request.headers.get("content-length", "")
if declared.isdigit() and int(declared) > MAX_BODY_BYTES:
raise ApiError(413, "payload_too_large", "Тело запроса слишком большое")
chunks = []
size = 0
async for chunk in request.stream():
size += len(chunk)
if size > MAX_BODY_BYTES:
raise ApiError(413, "payload_too_large", "Тело запроса слишком большое")
chunks.append(chunk)
try:
data = json.loads(
b"".join(chunks).decode("utf-8"), parse_constant=_reject_constant
)
except (UnicodeDecodeError, ValueError, RecursionError):
raise bad_request("Тело запроса не является корректным JSON")
if not isinstance(data, dict):
raise bad_request("Тело запроса должно быть JSON-объектом")
return data
def validate_body(model: Type[T], data: dict) -> T:
"""Проверить словарь моделью Pydantic; ошибки -> 400."""
try:
return model.model_validate(data)
except ValidationError as exc:
problems = []
for err in exc.errors()[:3]:
field = ".".join(str(part) for part in err["loc"]) or "body"
problems.append("%s: %s" % (field, err["msg"].replace("Value error, ", "")))
raise bad_request("Неверные данные: " + "; ".join(problems))
def parse_uuid(value: str, what: str) -> str:
"""Проверить строку как UUID и вернуть её в нижнем регистре."""
if not UUID_RE.fullmatch(value):
raise bad_request("%s должен быть UUID" % what)
return value.lower()
def parse_limit(raw: Optional[str]) -> int:
"""Размер страницы: по умолчанию 50, допустимо 1-100."""
if raw is None:
return DEFAULT_LIMIT
if not re.fullmatch(r"[0-9]{1,6}", raw) or not 1 <= int(raw) <= MAX_LIMIT:
raise bad_request("limit должен быть целым числом от 1 до %d" % MAX_LIMIT)
return int(raw)
def parse_cursor(raw: Optional[str], scope: str) -> Optional[Key]:
"""Позиция из курсора или None; неверный курсор -> 400."""
if raw is None or raw == "":
return None
try:
return decode_cursor(raw, scope)
except ValueError:
raise bad_request("Некорректный cursor")