Files
mtusi2026lab4-fork/app/validation.py
daniil_sobolev 747ca222e5 Implement lab4 attachments on RustFS for grade 4.
Carry over lab3 HA stack and add private S3 storage, Attachment API, orphan compensation/reaper, own tests, and evidence for smoke/persistence/failover.
2026-11-12 20:41:02 +03:00

129 lines
4.4 KiB
Python
Raw Permalink 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.
"""Проверки входных данных по контракту 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