"""Помощники 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")