"""Спек `pagination`: `limit`, `next_cursor`, курсоры обоих списков.""" from collections.abc import Callable from dataclasses import dataclass from typing import Any import httpx import pytest from api_client import Actor, Api, order_key from contract import assert_error, assert_ok @dataclass(frozen=True) class Listing: """Постраничный список: запрос страницы и схема ответа.""" page: Callable[..., httpx.Response] schema: str @pytest.fixture(params=["messages", "chats"]) def listing( request: pytest.FixtureRequest, api: Api, alice: Actor, chat: dict[str, Any], ) -> Listing: """История чата или список чатов Алисы: правила `limit` общие.""" if request.param == "messages": return Listing( page=lambda **params: api.messages_page( alice, chat["id"], **params, ), schema="MessagePage", ) return Listing( page=lambda **params: api.chats_page(alice, **params), schema="ChatPage", ) def fill(api: Api, actor: Actor, chat_id: str, count: int) -> list[dict]: return [ api.send_message(actor, chat_id, f"page-{number}") for number in range(count) ] @pytest.mark.spec("pagination", "Ноль") def test_limit_zero(listing: Listing) -> None: assert_error(listing.page(limit=0), 400) @pytest.mark.spec("pagination", "Больше максимума и не число") def test_limit_out_of_range(listing: Listing) -> None: for limit in (101, -1, "abc", "1.5"): assert_error(listing.page(limit=limit), 400) # границы диапазона допустимы for limit in (1, 100): assert_ok(listing.page(limit=limit), 200, listing.schema) @pytest.mark.spec("pagination", "По умолчанию") def test_default_limit(api: Api, alice: Actor, chat: dict[str, Any]) -> None: fill(api, alice, chat["id"], 60) page = assert_ok( api.messages_page(alice, chat["id"]), 200, "MessagePage", ) assert len(page["items"]) == 50 assert page["next_cursor"] @pytest.mark.spec("pagination", "Последняя полная страница") def test_last_full_page(api: Api, alice: Actor, chat: dict[str, Any]) -> None: sent = fill(api, alice, chat["id"], 2) page = assert_ok( api.messages_page(alice, chat["id"], limit=2), 200, "MessagePage", ) assert page["items"] == sorted(sent, key=order_key) assert page["next_cursor"] is None @pytest.mark.spec("pagination", "Полный обход") def test_full_walk(api: Api, alice: Actor, chat: dict[str, Any]) -> None: sent = fill(api, alice, chat["id"], 7) pages = api.message_pages(alice, chat["id"], limits=(3, 2)) assert [len(page["items"]) for page in pages] == [3, 2, 2] items = [item for page in pages for item in page["items"]] assert items == sorted(sent, key=order_key) def test_chat_list_walk(api: Api, alice: Actor, bob: Actor) -> None: """Список чатов обходится так же, как история.""" created = [api.create_chat(alice, bob, title=f"c{n}") for n in range(5)] pages = api.chat_pages(bob, limits=(2,)) items = [item for page in pages for item in page["items"]] assert items == sorted(created, key=order_key) @pytest.mark.spec("pagination", "Курсор другого чата") def test_cursor_of_other_chat( api: Api, alice: Actor, bob: Actor, chat: dict[str, Any], ) -> None: other = api.create_chat(alice, bob, title="B") fill(api, alice, chat["id"], 2) fill(api, alice, other["id"], 2) first = assert_ok( api.messages_page(alice, chat["id"], limit=1), 200, "MessagePage", ) resp = api.messages_page( alice, other["id"], limit=1, cursor=first["next_cursor"], ) assert_error(resp, 400) def test_cursor_of_other_list( api: Api, alice: Actor, bob: Actor, chat: dict[str, Any], ) -> None: """Курсор списка чатов не подходит истории, и наоборот.""" api.create_chat(alice, bob) fill(api, alice, chat["id"], 2) chats_cursor = assert_ok( api.chats_page(alice, limit=1), 200, "ChatPage", )["next_cursor"] history_cursor = assert_ok( api.messages_page(alice, chat["id"], limit=1), 200, "MessagePage", )["next_cursor"] assert chats_cursor assert history_cursor assert_error( api.messages_page(alice, chat["id"], cursor=chats_cursor), 400, ) assert_error(api.chats_page(alice, cursor=history_cursor), 400) @pytest.mark.spec("pagination", "Повреждённый курсор") def test_garbage_cursor(listing: Listing) -> None: # eyJ4IjoxfQ — корректный base64 от {"x":1}, но не курсор сервиса for cursor in ("garbage", "eyJ4IjoxfQ", "!!!"): assert_error(listing.page(cursor=cursor), 400)