Struct ExternalDependency 

pub struct ExternalDependency {
    pub path: PathBuf,
    pub fingerprint: Option<Fingerprint>,
}

One external file a lowering depended on: an #image / #figure raster or a #bibliography source.

fingerprint is None when the path was not a readable regular file at lowering time, so a file that later appears is as much a change as one that is edited.

Examples

use std::path::Path;

use mos_eval::ExternalDependency;

let dep = ExternalDependency::observe(Path::new("/nonexistent/x.png"));
assert_eq!(dep.fingerprint, None);
assert!(dep.is_current());

Fields

path: PathBuf

The resolved filesystem path that was read.

fingerprint: Option<Fingerprint>

The file’s Fingerprint, or None when it could not be read.

Implementations

impl ExternalDependency

pub fn observe(path: impl Into<PathBuf>) -> Self

Record path with the fingerprint it has right now.

pub fn is_current(&self) -> bool

Whether the file on disk still matches the recorded fingerprint.

A stat settles the common cases: a file whose size, modification time, and FileIdentity are unchanged is current, and a file that appeared or vanished is not. The bytes are re-read and hashed only when the stat differs or the fingerprint is racy, so a touch that leaves the contents alone still counts as current, while a same-size rewrite that restores the old mtime is caught by the inode identity on Unix and by the racy window everywhere.

Trait Implementations

impl Clone for ExternalDependency

fn clone(&self) -> ExternalDependency

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExternalDependency

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

Formats the value using the given formatter.

impl Eq for ExternalDependency

impl PartialEq for ExternalDependency

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