Copy the committed lab 1 sources as-is: src/, student-tests/, bench/, Dockerfile, docker-compose.yml, pyproject.toml, uv.lock, .python-version, config_example.toml, AGENTS.md, CLAUDE.md, .claude/, openspec/, .graphifyignore and KNOWN_ISSUES.md. Lab 1 evidence stays in the lab 1 repository. Merge the new skeleton files with own sections: Makefile (lab 2 targets plus own run, docker, bench and common targets), .gitignore, .dockerignore and .env.example. Rename the image to mtusi-messenger:lab2 and point AGENTS.md at lab 2. The application is still the in-memory lab 1 implementation. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
228 lines
6.5 KiB
Python
228 lines
6.5 KiB
Python
"""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
|