data.pagination

Pagination primitives for chirp.data.

Offset-based pagination that composes withQuery. One method call replaces the manual count-query + offset-math + total-pages-calc pattern.

Usage::

from chirp.data import Query, PageResult

result: PageResult[Todo] = await (
    Query(Todo, "todos")
    .where("done = ?", False)
    .order_by("id DESC")
    .paginate(db, page=2, per_page=20)
)

result.items        # list[Todo] — rows for this page
result.total_pages  # 5
result.has_next     # True
result.page_range() # [1, 2, 3, 4]

Free-threading safety:

• Frozen dataclass — immutable after creation
• No shared mutable state