Enum PageSelection 

pub enum PageSelection {
    All,
    Ranges(Vec<(u32, u32)>),
}

Canonical page selection. Page selection enters config_sha256: a different range is a legitimately different canonical output.

Variants

All

All pages (canonical form: the string "all").

Ranges(Vec<(u32, u32)>)

Merged, sorted, 1-based inclusive ranges (canonical form: [[lo, hi], …]).

Implementations

impl PageSelection

pub fn parse(input: &str) -> Result<Self, PageSelectionError>

Parse --pages syntax: comma-separated 1-based pages or inclusive ranges, e.g. 1-5,9. Overlapping/adjacent ranges merge; order normalizes ascending.

Syntax and out-of-range failures are PageSelectionError — usage errors the CLI maps to exit code 2, deliberately distinct from the 10 stable parse-failure codes (those describe the document, not the invocation).

pub fn contains(&self, page: u32) -> bool

True when page (1-based) is selected.

pub fn max_page(&self) -> Option<u32>

Highest selected page, when bounded.

pub fn validate_against( &self, page_count: u32, ) -> Result<(), PageSelectionError>

Validate against the document’s page count: out-of-range selection is a stable error (page_limit_exceeded is about limits; out-of-range selection is usage — PRD §16 wants a stable error on out-of-range, mapped here to invalid usage error).

pub fn canonical_value(&self) -> Value

Canonical JSON form for the config hash (contract §7): "all" or [[lo, hi], …].

Trait Implementations

impl Clone for PageSelection

fn clone(&self) -> PageSelection

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PageSelection

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

Formats the value using the given formatter.

impl Default for PageSelection

fn default() -> PageSelection

Returns the “default value” for a type.

impl Eq for PageSelection

impl PartialEq for PageSelection

fn eq(&self, other: &PageSelection) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for PageSelection