Struct PageLimits 

pub struct PageLimits {
    pub limit: Option<usize>,
    pub budget: usize,
}

How many items to collect, and how hard to work for them.

Fields

limit: Option<usize>

Stop once this many items are held. None means everything.

budget: usize

Maximum number of HTTP requests, counting the first.

Separate from limit, and not a substitute for it: limit is what the user asked for, this is the guard against a mistyped query walking a large instance. Exhausting it marks the result truncated rather than failing, so a partial answer is still labelled honestly.

Implementations

impl PageLimits

pub const DEFAULT_BUDGET: usize = 50

pub fn new(limit: Option<usize>) -> Self

pub fn from_cli_limit(limit: usize) -> Self

Build limits from a CLI --limit, where 0 means everything.

The commands advertise --limit 0 for “all”. Passing it straight through as Some(0) made items.len() >= 0 true on the first page, so the result was truncated to nothing and the warning cheerfully advised using the flag that had just emptied it.

pub fn with_budget(self, budget: usize) -> Self

Trait Implementations

impl Clone for PageLimits

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PageLimits

impl Debug for PageLimits

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

Formats the value using the given formatter.