Enum ReadProjection 

pub enum ReadProjection {
    Lookup {
        path: PathBuf,
    },
    RollUp {
        path: PathBuf,
    },
    Tree {
        path: PathBuf,
        depth: Bound,
        include_ignored: bool,
        page: PageRequest,
    },
    Flat {
        selection: EntrySelection,
        shape: RowShape,
        page: PageRequest,
    },
    Aggregate {
        selection: EntrySelection,
        count_cap: u64,
        max_work: u64,
    },
    Report(ReportRequest),
    Continue {
        continuation: ContinuationId,
        page: PageRequest,
    },
    Diagnostics,
}

One fdu-native projection requested under a coherent read boundary.

Variants

Lookup

Look up one relative path with three-valued, portable-safe absence.

Fields

path: PathBuf

Native path relative to the opened root.

RollUp

Return both maintained aggregate partitions for one directory.

Fields

path: PathBuf

Directory relative to the opened root.

Tree

Return one page of portable descendants, level by level to depth.

Fields

path: PathBuf

Directory relative to the opened root.

depth: Bound

How many levels below path the page descends.

Limit(1) is this directory’s own children. Rows arrive in breadth-first level order, so a page cut short by page withholds depth rather than breadth: the caller can always tell how wide each level it received was.

include_ignored: bool

Whether entries in the fixed ignored partition are traversed.

false prunes the excluded directory’s whole subtree, contributing neither it nor any descendant, rather than filtering its row and descending anyway.

page: PageRequest

Page output and work bounds.

Flat

Return one portable-path-ordered page under an fdu-native selection.

Fields

selection: EntrySelection

Additive portable-entry selection composing the existing query predicates.

shape: RowShape

Compact or full retained row shape.

page: PageRequest

Page output and work bounds.

Aggregate

Count portable entries under one selection, exactly or to an explicit cap.

Fields

selection: EntrySelection

Additive portable-entry selection composing the existing query predicates.

count_cap: u64

Maximum matches counted before returning a lower bound.

max_work: u64

Maximum portable index rows inspected.

Report(ReportRequest)

Evaluate the existing pure fdu query/report machinery at this read boundary.

Continue

Resume a tree or flat page from handle-local retained traversal state.

Fields

continuation: ContinuationId

Opaque continuation returned by a prior page.

page: PageRequest

Bounds for this page; query identity remains in the handle.

Diagnostics

Return fixed-size owner, scope, and retained-issue diagnostics.

Trait Implementations

impl Clone for ReadProjection

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReadProjection

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

Formats the value using the given formatter.