Files
mtusi2026lab3/app/http_utils.py
T
2026-11-02 20:05:33 +03:00

114 lines
4.3 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""Помощники 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()
IDEMPOTENCY_KEY_RE = re.compile(r"[A-Za-z0-9._:-]{1,128}")
def parse_idempotency_key(request: Request) -> str:
"""Один обязательный ASCII Idempotency-Key длиной 1–128 символов."""
values = request.headers.getlist("idempotency-key")
if len(values) != 1 or not IDEMPOTENCY_KEY_RE.fullmatch(values[0]):
raise bad_request("Нужен корректный Idempotency-Key")
return values[0]
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")