Struct IndexStatProbeCache 

pub struct IndexStatProbeCache { /* private fields */ }

Reusable stage-0 index stat probes for many worktree paths.

Prefer this over repeated IndexStatProbe::from_repository_index calls when an embedder needs to verify many paths. It parses .git/index once, records the index file mtime used for racy-git checks, and serves cheap per-path probes from memory.

Implementations

impl IndexStatProbeCache

pub fn from_index(index: &Index, index_mtime: Option<(u64, u64)>) -> Self

Build a reusable probe cache from an already parsed index and index-file mtime.

pub fn from_repository_index( git_dir: impl AsRef<Path>, format: ObjectFormat, ) -> Result<Self>

Read this repository’s index once and build reusable stat probes.

A missing index returns an empty cache, matching the one-shot helper’s Ok(None) result for every path.

pub fn probe_for_git_path(&self, git_path: &[u8]) -> Option<IndexStatProbe>

Return a per-path probe for a stage-0 entry, if present.

pub fn contains_git_path(&self, git_path: &[u8]) -> bool

Whether this cache has a stage-0 entry for git_path.

pub fn len(&self) -> usize

Number of stage-0 entries in the cache.

pub fn is_empty(&self) -> bool

Whether the cache has no stage-0 entries.

pub fn index_mtime(&self) -> Option<(u64, u64)>

The index file mtime used as the racy-clean reference timestamp.

Trait Implementations

impl Clone for IndexStatProbeCache

fn clone(&self) -> IndexStatProbeCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IndexStatProbeCache

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

Formats the value using the given formatter.

impl Default for IndexStatProbeCache

fn default() -> IndexStatProbeCache

Returns the “default value” for a type.

impl Eq for IndexStatProbeCache

impl PartialEq for IndexStatProbeCache

fn eq(&self, other: &IndexStatProbeCache) -> 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 IndexStatProbeCache