#chunk #page #database #pagination #web

paginate

A framework agnostic pagination crate, that is especially suited for databases, slices and collections. Paginate calculates the range of pages indexes, making it ideal for accessing slices, chunking data and querying databases.

13 stable releases

1.1.11 Apr 11, 2022
1.1.8 Jan 21, 2022
1.0.1 Mar 16, 2020

#120 in Data structures

Download history 1026/week @ 2023-06-07 615/week @ 2023-06-14 333/week @ 2023-06-21 860/week @ 2023-06-28 510/week @ 2023-07-05 134/week @ 2023-07-12 112/week @ 2023-07-19 267/week @ 2023-07-26 432/week @ 2023-08-02 217/week @ 2023-08-09 173/week @ 2023-08-16 252/week @ 2023-08-23 280/week @ 2023-08-30 488/week @ 2023-09-06 271/week @ 2023-09-13 262/week @ 2023-09-20

1,347 downloads per month

Apache-2.0

17KB
391 lines

A framework agnostic pagination crate, that is especially suited for databases, slices and collections. Paginate calculates the range of page indexes, making it ideal for accessing slices, chunking data and querying databases.

Project Status

crates.io CI Docs codecov book stars - paginate forks - paginate

Installation

Add the following line to your Cargo.toml file:

paginate = "^1"

Examples

To iterate over each page:

use paginate::Pages;

fn main() {
    let total_items = 100;
    let items_per_page = 5;
    let pages = Pages::new(total_items, items_per_page);
    println!("total pages: {}", pages.page_count());
    for page in pages.into_iter() {
        println!("offset: {}, total: {}, start: {}, end: {}", page.offset, page.length, page.start, page.end);
    }
}

To get the pagination of a specific offset:

use paginate::Pages;

fn main() {
    let total_items = 35;
    let items_per_page = 5;
    let pages = Pages::new(total_items, items_per_page);
    let page = pages.with_offset(3);
    println!("total pages: {}", pages.page_count());
    println!("offset: {}, total: {}, start: {}, end: {}", page.offset, page.length, page.start, page.end);
}

Getting help

Contribute

No runtime deps