Enum ReadOutcome 

pub enum ReadOutcome {
    Found(ContentHash),
    Absent,
    Refused,
}

What a tracked read found.

Three states rather than an Option<ContentHash>, because a refusal is not an absence. A path refused for resolving out of the root through a symlink — node_modules/pkg as pnpm links it — was recorded as absent, and a validator checking absence reads root.join(path) and follows the link: the file is there, so the dependency reads as “appeared”, every importer of a store-linked package misses the cache on every run, and the validator has read bytes outside the project root to decide it. Recording the refusal as itself is what lets the validator reproduce the decision that was actually made.

Variants

Found(ContentHash)

The file was read, and hashed to this.

Absent

Nothing readable was there.

A recorded answer, not a missing record. See the module documentation.

Refused

It resolved outside the root through a symlink, so it was refused unread.

Still a dependency: the answer that rested on the refusal has to be reconsidered the day the path becomes a real in-root file.

Trait Implementations

impl Clone for ReadOutcome

fn clone(&self) -> ReadOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ReadOutcome

impl Debug for ReadOutcome

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

Formats the value using the given formatter.

impl Eq for ReadOutcome

impl Hash for ReadOutcome

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for ReadOutcome

fn cmp(&self, other: &ReadOutcome) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for ReadOutcome

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for ReadOutcome

fn partial_cmp(&self, other: &ReadOutcome) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for ReadOutcome