"""HTTP-клиент набора: запросы к API и идентификация в одном месте.""" import uuid from collections.abc import Callable, Sequence from dataclasses import dataclass from datetime import datetime from typing import Any import httpx from contract import assert_ok API = "/api/v1" # защита от бесконечного обхода, если next_cursor никогда не станет null MAX_PAGES = 1000 def unique_username() -> str: """Имя под `^[a-z0-9_]{3,32}$`, уникальное для каждого вызова.""" return f"t_{uuid.uuid4().hex[:12]}" def order_key(item: dict[str, Any]) -> tuple[datetime, int]: """Порядок списков API: `(created_at, id)`, id сравнивается как UUID.""" created_at = datetime.fromisoformat(item["created_at"]) return created_at, uuid.UUID(item["id"]).int @dataclass(frozen=True) class Actor: """Зарегистрированный пользователь и то, как он себя называет.""" user: dict[str, Any] @classmethod def unregistered(cls) -> "Actor": """Пользователь, которого нет на сервере.""" return cls(user={"id": str(uuid.uuid4())}) @property def id(self) -> str: return self.user["id"] def headers(self) -> dict[str, str]: """Идентификация: лаба 1 — `X-User-Id`, с лабы 2 — Bearer.""" return {"X-User-Id": self.id} class Api: """Тонкая обёртка над `httpx.Client` с методами API мессенджера.""" def __init__(self, base_url: str, *, timeout: float = 5) -> None: self.client = httpx.Client(base_url=base_url, timeout=timeout) def close(self) -> None: self.client.close() def __enter__(self) -> "Api": return self def __exit__(self, *_: object) -> None: self.close() def request( self, method: str, path: str, *, actor: Actor | None = None, headers: dict[str, str] | None = None, **kwargs: Any, ) -> httpx.Response: merged = actor.headers() if actor is not None else {} merged.update(headers or {}) return self.client.request(method, path, headers=merged, **kwargs) def register( self, *, username: str | None = None, display_name: str = "Test user", ) -> Actor: resp = self.request( "POST", f"{API}/users", json={ "username": username or unique_username(), "display_name": display_name, }, ) return Actor(assert_ok(resp, 201, "User")) def create_chat( self, actor: Actor, *members: Actor, title: str = "Test chat", ) -> dict[str, Any]: """Чат, где `actor` — первый участник, за ним `members`.""" member_ids = [actor.id, *(member.id for member in members)] resp = self.request( "POST", f"{API}/chats", actor=actor, json={"title": title, "member_ids": member_ids}, ) return assert_ok(resp, 201, "Chat") def send_message( self, actor: Actor, chat_id: str, text: str, ) -> dict[str, Any]: resp = self.request( "POST", f"{API}/chats/{chat_id}/messages", actor=actor, json={"text": text}, ) return assert_ok(resp, 201, "Message") def messages_page( self, actor: Actor, chat_id: str, *, limit: int | str | None = None, cursor: str | None = None, ) -> httpx.Response: return self.request( "GET", f"{API}/chats/{chat_id}/messages", actor=actor, params=_page_params(limit, cursor), ) def chats_page( self, actor: Actor, *, limit: int | str | None = None, cursor: str | None = None, ) -> httpx.Response: return self.request( "GET", f"{API}/chats", actor=actor, params=_page_params(limit, cursor), ) def message_pages( self, actor: Actor, chat_id: str, *, limits: Sequence[int] = (100,), ) -> list[dict[str, Any]]: """Все страницы истории по `next_cursor`. Страница `i` берётся с `limits[i]`, дальше — с последним `limit`. """ def fetch(limit: int, cursor: str | None) -> httpx.Response: return self.messages_page( actor, chat_id, limit=limit, cursor=cursor, ) return walk_pages(fetch, limits=limits, schema="MessagePage") def chat_pages( self, actor: Actor, *, limits: Sequence[int] = (100,), ) -> list[dict[str, Any]]: def fetch(limit: int, cursor: str | None) -> httpx.Response: return self.chats_page(actor, limit=limit, cursor=cursor) return walk_pages(fetch, limits=limits, schema="ChatPage") def all_messages( self, actor: Actor, chat_id: str, *, limits: Sequence[int] = (100,), ) -> list[dict[str, Any]]: pages = self.message_pages(actor, chat_id, limits=limits) return [item for page in pages for item in page["items"]] def walk_pages( fetch: Callable[[int, str | None], httpx.Response], *, limits: Sequence[int], schema: str, ) -> list[dict[str, Any]]: """Обход списка по курсору до `next_cursor` null.""" pages: list[dict[str, Any]] = [] cursor: str | None = None for number in range(MAX_PAGES): limit = limits[min(number, len(limits) - 1)] page = assert_ok(fetch(limit, cursor), 200, schema) assert len(page["items"]) <= limit, ( f"page {number} has {len(page['items'])} items, limit {limit}" ) pages.append(page) cursor = page["next_cursor"] if cursor is None: return pages raise AssertionError(f"next_cursor is not null after {MAX_PAGES} pages") def _page_params( limit: int | str | None, cursor: str | None, ) -> dict[str, str]: params: dict[str, str] = {} if limit is not None: params["limit"] = str(limit) if cursor is not None: params["cursor"] = cursor return params