Struct IndexStatProbe 

pub struct IndexStatProbe { /* private fields */ }

Stage-0 index stat data that can prove a worktree path clean without re-reading and re-hashing it.

This is the public carrier for sley’s racy-git shortcut. Callers that already parsed .git/index can build a probe from the matching IndexEntry and the index file’s mtime, then pass it to worktree_entry_state or worktree_entry_state_by_git_path. The probe is trusted only when its path, mode, and object id match the expected entry and the cached stat is not racily clean; otherwise the helper falls back to the same content hashing path used by short_status_with_options.

Implementations

impl IndexStatProbe

pub fn from_index_entry( entry: IndexEntry, index_mtime: Option<(u64, u64)>, ) -> Self

Build a probe from a parsed stage-0 index entry and the index file’s mtime split as (seconds, nanoseconds).

pub fn from_index_entry_and_index_path( entry: IndexEntry, index_path: impl AsRef<Path>, ) -> Self

Build a probe from a parsed index entry and the path of the index file on disk, using that file’s mtime as the racy-clean reference timestamp.

pub fn from_repository_index( git_dir: impl AsRef<Path>, format: ObjectFormat, git_path: &[u8], ) -> Result<Option<Self>>

Read this repository’s index and return a probe for git_path when a stage-0 entry exists.

For repeated lookups prefer IndexStatProbeCache::from_repository_index and IndexStatProbeCache::probe_for_git_path. This one-shot helper keeps a small process-local cache for back-to-back calls against an unchanged index, but the explicit cache makes ownership and invalidation clearer for high-volume embedders.

pub fn entry(&self) -> &IndexEntry

The parsed index entry this probe was built from.

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

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

Trait Implementations

impl Clone for IndexStatProbe

fn clone(&self) -> IndexStatProbe

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IndexStatProbe

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

Formats the value using the given formatter.

impl Eq for IndexStatProbe

impl PartialEq for IndexStatProbe

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