forked from mtusi2026/mtusi2026lab4
Carry over lab3 HA stack and add private S3 storage, Attachment API, orphan compensation/reaper, own tests, and evidence for smoke/persistence/failover.
129 lines
4.4 KiB
Python
129 lines
4.4 KiB
Python
"""Проверки входных данных по контракту lab2."""
|
||
import re
|
||
import uuid
|
||
from typing import Any, Iterable, Optional, Set
|
||
|
||
from app.errors import invalid_request
|
||
|
||
USERNAME_RE = re.compile(r"^[a-z0-9_]{3,32}$")
|
||
IDEMPOTENCY_KEY_RE = re.compile(r"^[A-Za-z0-9._:-]{1,128}$")
|
||
|
||
|
||
def require_object(body: Any) -> dict:
|
||
if not isinstance(body, dict):
|
||
raise invalid_request("Тело запроса должно быть JSON-объектом")
|
||
return body
|
||
|
||
|
||
def reject_unknown(body: dict, allowed: Set[str]) -> None:
|
||
extra = set(body) - allowed
|
||
if extra:
|
||
raise invalid_request("Лишние поля в запросе")
|
||
|
||
|
||
def require_keys(body: dict, keys: Iterable[str]) -> None:
|
||
for key in keys:
|
||
if key not in body:
|
||
raise invalid_request(f"Поле {key} обязательно")
|
||
|
||
|
||
def parse_uuid(value: Any, field: str = "id") -> str:
|
||
if not isinstance(value, str):
|
||
raise invalid_request(f"Поле {field} должно быть UUID-строкой")
|
||
try:
|
||
return str(uuid.UUID(value))
|
||
except ValueError as exc:
|
||
raise invalid_request(f"Неверный UUID: {field}") from exc
|
||
|
||
|
||
def code_points(text: str) -> int:
|
||
return len(text)
|
||
|
||
|
||
def require_username(value: Any) -> str:
|
||
if not isinstance(value, str):
|
||
raise invalid_request("username должен быть строкой")
|
||
if not USERNAME_RE.fullmatch(value):
|
||
raise invalid_request("username: только [a-z0-9_] длиной 3–32")
|
||
return value
|
||
|
||
|
||
def require_display_name(value: Any) -> str:
|
||
if not isinstance(value, str):
|
||
raise invalid_request("display_name должен быть строкой")
|
||
if value.strip() == "":
|
||
raise invalid_request("display_name не может быть пустым")
|
||
n = code_points(value)
|
||
if n < 1 or n > 100:
|
||
raise invalid_request("display_name: 1–100 символов Unicode")
|
||
return value
|
||
|
||
|
||
def require_password(value: Any) -> str:
|
||
if not isinstance(value, str):
|
||
raise invalid_request("password должен быть строкой")
|
||
if value.strip() == "":
|
||
raise invalid_request("password не может быть пустым")
|
||
n = code_points(value)
|
||
if n < 12 or n > 128:
|
||
raise invalid_request("password: 12–128 символов Unicode")
|
||
return value
|
||
|
||
|
||
def require_title(value: Any) -> str:
|
||
if not isinstance(value, str):
|
||
raise invalid_request("title должен быть строкой")
|
||
if value.strip() == "":
|
||
raise invalid_request("title не может быть пустым")
|
||
n = code_points(value)
|
||
if n < 1 or n > 100:
|
||
raise invalid_request("title: 1–100 символов Unicode")
|
||
return value
|
||
|
||
|
||
def require_message_text(value: Any, *, allow_blank: bool = False) -> str:
|
||
if not isinstance(value, str):
|
||
raise invalid_request("text должен быть строкой")
|
||
if not allow_blank and value.strip() == "":
|
||
raise invalid_request("text не может быть пустым")
|
||
if code_points(value) > 4000:
|
||
raise invalid_request("text: максимум 4000 символов Unicode")
|
||
return value
|
||
|
||
|
||
def require_filename(value: Any) -> str:
|
||
if not isinstance(value, str):
|
||
raise invalid_request("filename должен быть строкой")
|
||
if value.strip() == "":
|
||
raise invalid_request("filename не может быть пустым")
|
||
n = code_points(value)
|
||
if n < 1 or n > 255:
|
||
raise invalid_request("filename: 1–255 символов Unicode")
|
||
for ch in value:
|
||
o = ord(ch)
|
||
if ch in "/\\" or o == 0 or o < 32:
|
||
raise invalid_request("filename содержит недопустимые символы")
|
||
return value
|
||
|
||
|
||
|
||
def parse_limit(raw: Optional[str], default: int = 50) -> int:
|
||
if raw is None or raw == "":
|
||
return default
|
||
try:
|
||
value = int(raw)
|
||
except ValueError as exc:
|
||
raise invalid_request("limit должен быть целым числом") from exc
|
||
if value < 1 or value > 100:
|
||
raise invalid_request("limit должен быть от 1 до 100")
|
||
return value
|
||
|
||
|
||
def require_idempotency_key(value: Any) -> str:
|
||
if not isinstance(value, str) or not value:
|
||
raise invalid_request("Idempotency-Key обязателен")
|
||
if not IDEMPOTENCY_KEY_RE.fullmatch(value):
|
||
raise invalid_request("Idempotency-Key: ASCII [A-Za-z0-9._:-]{1,128}")
|
||
return value
|
||
|