Problem
Pagination currently lives only in the ORM. There is no request-aware paginator at the framework level and no standard JSON shape or view presentation for paginated results.
Proposal
Framework-level paginators that build on the ORM's .paginate():
- A simple paginator and a length-aware paginator.
- Read
page / per_page from the current request automatically.
- Expose
links and meta (current page, last page, total, per page).
- Serialize to a consistent JSON envelope (
data / meta / links).
- Render through reusable view partials / helpers for server-rendered pages.
Scope
Paginator classes, request integration, JSON contract, view partials/helpers.
Definition of Done
Problem
Pagination currently lives only in the ORM. There is no request-aware paginator at the framework level and no standard JSON shape or view presentation for paginated results.
Proposal
Framework-level paginators that build on the ORM's
.paginate():page/per_pagefrom the current request automatically.linksandmeta(current page, last page, total, per page).data/meta/links).Scope
Paginator classes, request integration, JSON contract, view partials/helpers.
Definition of Done
pytestcovers pagination math, request parsing, and JSON shape (suite green).