Struct Paginate 

pub struct Paginate {
    pub page: u64,
    pub per_page: u64,
}

Offset-based pagination extractor

Extracts pagination parameters from the query string. Supports ?page=1&per_page=20 (defaults: page=1, per_page=20, max=100).

Example

use rustapi_core::Paginate;

async fn list_users(paginate: Paginate) -> impl IntoResponse {
    let offset = paginate.offset();
    let limit = paginate.limit();
    // SELECT * FROM users LIMIT $limit OFFSET $offset
}

Fields

page: u64

Current page (1-indexed)

per_page: u64

Items per page (capped at MAX_PER_PAGE)

Implementations

impl Paginate

pub fn new(page: u64, per_page: u64) -> Self

Create a new Paginate with given page and per_page

pub fn offset(&self) -> u64

Calculate the SQL OFFSET value

pub fn limit(&self) -> u64

Get the LIMIT value (alias for per_page)

pub fn paginate<T>(self, items: Vec<T>, total: u64) -> Paginated<T>

Build a Paginated<T> response from this pagination and results

Trait Implementations

impl Clone for Paginate

fn clone(&self) -> Paginate

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Paginate

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Paginate

fn default() -> Self

Returns the “default value” for a type.

impl FromRequestParts for Paginate

fn from_request_parts(req: &Request) -> Result<Self>

Extract from request parts

impl Copy for Paginate