103 lines
3.9 KiB
Python
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")
|