Skip to main content

OnDiskFingerprint

Struct OnDiskFingerprint 

Source
pub struct OnDiskFingerprint {
    pub mtime: Option<SystemTime>,
    pub size: u64,
    pub content_hash: u64,
}
Expand description

The on-disk identity of a file-backed buffer at the moment the editor last synced with disk — a load, or its own :w.

Two comparison surfaces, deliberately distinct:

  • Self::same_content (content hash) is the authoritative “is this the same file we already have” test. A touch that bumps mtime without changing bytes must compare equal, so mtime/size are not part of it.
  • Self::stat_unchanged is the cheap (mtime, size) pre-gate the watcher uses to decide whether it even needs to read + hash the file.

Fields§

§mtime: Option<SystemTime>

Last-modified time from stat, or None on platforms / filesystems where it’s unavailable (then detection leans on content_hash alone).

§size: u64

Byte length from stat (0 when metadata is unavailable).

§content_hash: u64

Hash of the text the editor holds for this file — the precise check that survives mtime-only touches and identifies self-writes.

Implementations§

Source§

impl OnDiskFingerprint

Source

pub fn from_path_and_text(path: &Path, text: &str) -> Self

Build a fingerprint from path’s current metadata plus the text the editor holds for it. stat failure degrades to mtime = None / size = 0 rather than erroring — a missing stat must never break a load or a save (paramount: never panic on the hot path; recover + lean on the content hash).

Source

pub fn same_content(&self, other: &Self) -> bool

True when self and other denote the same on-disk content. Content hash is authoritative; mtime/size are ignored so a bare touch is correctly treated as “no change”.

Source

pub fn stat_unchanged(&self, path: &Path) -> bool

Cheap pre-gate: true when path’s current (mtime, size) still match this fingerprint, i.e. the file almost certainly hasn’t changed and the watcher can skip the read + hash entirely. A stat failure returns false (fall through to the authoritative read), as does a None stored mtime (we never had a baseline to gate on).

Trait Implementations§

Source§

impl Clone for OnDiskFingerprint

Source§

fn clone(&self) -> OnDiskFingerprint

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for OnDiskFingerprint

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Eq for OnDiskFingerprint

Source§

impl PartialEq for OnDiskFingerprint

Source§

fn eq(&self, other: &OnDiskFingerprint) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for OnDiskFingerprint

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.