Struct IndexHandle 

pub struct IndexHandle { /* private fields */ }

Shareable owner for serving readers while reconciliation applies short writes.

Implementations

impl IndexHandle

pub fn new(index: Index) -> Self

Wrap an owned index in the shared single-writer owner.

pub fn apply(&self, observation: &Observation) -> Result<ApplyOutcome>

Arbitrate and apply one observation under the single-writer lock.

pub fn root_path(&self) -> Result<PathBuf>

Absolute filesystem root, copied without retaining the read lock.

pub fn scope(&self) -> Result<ScanScope>

Semantic scan scope represented by the shared index.

pub fn freshness(&self) -> Result<Freshness>

Trust state for the whole index.

pub fn freshness_at(&self, path: &Path) -> Result<Freshness>

Trust state for one subtree.

pub fn clock(&self) -> Result<Clock>

Clock of the most recently committed delta.

pub fn len(&self) -> Result<u64>

Number of live entries, including the root.

pub fn is_empty(&self) -> Result<bool>

Whether the index contains only its root.

pub fn total(&self) -> Result<RollUp>

Owned roll-up totals for the whole tree.

pub fn rollup(&self, path: &Path) -> Result<Option<RollUp>>

Owned roll-up state for a relative directory path.

pub fn attrs(&self, path: &Path) -> Result<Option<Attrs>>

Owned metadata for a relative path.

pub fn kind(&self, path: &Path) -> Result<Option<EntryKind>>

Entry kind for a relative path.

pub fn path_state(&self, path: &Path) -> Result<PathState>

Current visible state for a relative path.

pub fn expectation(&self, path: &Path) -> Result<PathExpectation>

Conditional baseline for a producer operating on a shared index.

pub fn since(&self, clock: Clock) -> Result<Since>

Owned exact commits after clock.

pub fn children(&self, path: &Path) -> Result<Option<Vec<ChildSnapshot>>>

Direct children captured coherently at one read boundary.

On an index that did not observe control state each child’s ChildSnapshot::ignored and ChildSnapshot::partitions are None, the way Index::is_ignored refuses; the names, metadata, and roll-ups still answer.

pub fn snapshot(&self) -> Result<Index>

Capture one coherent owned index image, releasing the lock before callers do serialization, filesystem I/O, conversion, or other potentially blocking work.

Trait Implementations

impl Clone for IndexHandle

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 IndexHandle

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

Formats the value using the given formatter.