Struct OnDiskSource 

pub struct OnDiskSource { /* private fields */ }

D.3.a (2026-05-29): on-disk file participant source.

snapshot re-reads the file at path and parses it into a fresh Rope. Used by :diff (no args) — “diff against the on-disk version of this file.” Cheap enough to do inside spawn_blocking per the DiffParticipantSource contract; D.3’s first consumer is single-file inline overlay so per-recompute file re-reads are acceptable. Future D.7 (:Gdiff) introduces a separate GitSource that reads through gix against a fixed ref.

On I/O error (missing path, permissions, mid-read crash) snapshot returns an empty rope. The session then recomputes the diff against empty baseline (all-Add hunks), which is the “everything is new” presentation — a noisy but defensible degradation that the user can resolve via :diffoff and a corrected path. We log the error at tracing::debug so the failure surfaces under RUST_LOG=lattice_host::diff::subsystem=debug without blocking the recompute path.

Implementations

impl OnDiskSource

pub fn new(path: PathBuf) -> Self

pub fn path(&self) -> &Path

Trait Implementations

impl Clone for OnDiskSource

fn clone(&self) -> OnDiskSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OnDiskSource

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

Formats the value using the given formatter.

impl DiffParticipantSource for OnDiskSource

fn snapshot(&self) -> Rope

Produce this participant’s rope. Called once per recompute; the implementor decides whether to clone a cached rope or rematerialise from a backing store.

fn buffer_id(&self) -> Option<BufferId>

D.8.d (2026-05-31): the buffer id this source is backed by, if any. Returns None for non-buffer sources (StaticSource, OnDiskSource, future GitSource); BufferSource overrides to return Some(buffer_id).