Page

Paginated list result. Async clients use AsyncPage (same shape with async methods).

class Page(items: List[T], next_page_token: str | None, _fetch_page: Callable[[str], Page[T]])

Bases: Generic[T] A single page of results from a Modus list endpoint (sync). Iterating yields the current page only. Use auto_paging_iter() to walk every page, or get_next_page() to advance manually. For async clients, see AsyncPage.

has_next_page()

has_next_page() → bool

Return True if more pages are available.

get_next_page()

get_next_page() → Page[T]

Fetch and return the next page. Raises ValueError if no next page.

auto_paging_iter()

auto_paging_iter() → Iterator[T]

Iterate over all items across all pages, fetching lazily as needed. Warning: may make multiple API calls for large result sets.

AsyncPage

class AsyncPage(items: List[T], next_page_token: str | None, _fetch_page: Callable[[str], Awaitable[AsyncPage[T]]])

Bases: Generic[T] A single page of results from a Modus list endpoint (async).

has_next_page()

has_next_page() → bool

Return True if more pages are available.

get_next_page()

async get_next_page() → AsyncPage[T]

Fetch and return the next page. Raises ValueError if no next page.

auto_paging_iter()

async auto_paging_iter() → AsyncIterator[T]

Async-iterate over all items across all pages, fetching lazily as needed.

Usage:
- async for item in page.auto_paging_iter(): process(item)

Types

Errors

Getting Started

API Reference

Page

Page

has_next_page()

get_next_page()

auto_paging_iter()

AsyncPage

has_next_page()

get_next_page()

auto_paging_iter()

​Page

​has_next_page()

​get_next_page()

​auto_paging_iter()

​AsyncPage

​has_next_page()

​get_next_page()

​auto_paging_iter()

Page

has_next_page()

get_next_page()

auto_paging_iter()

AsyncPage

has_next_page()

get_next_page()

auto_paging_iter()