114 lines
4.3 KiB
Python
114 lines
4.3 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()
|
||
|
||
|
||
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")
|