Enum ContentState 

pub enum ContentState {
    Unrecorded,
    Unverifiable,
    Intact,
    Drifted,
}

What a document’s recorded content checksum says about its bytes right now.

The three answers are not a scale, they are three different situations, and a caller deciding whether to stamp a timestamp has to tell them apart: Drifted is evidence an edit happened, Intact is evidence one did not, and the other two are the absence of evidence rather than either verdict — which is why they are not folded into one of the first two.

Variants

Unrecorded

The document records no content_hash — fixity is off, the document is a shape prov does not checksum (a combined document, whose hash could only cover its own parsed body), or it predates fixity. Nothing has drifted from nothing; a caller that wants to stamp anyway is making a claim of its own, not restating one.

Unverifiable

A recorded digest spelled in an algorithm this build cannot compute (a newer prov wrote it). Left alone rather than compared or overwritten.

Intact

The recorded digest still describes the bytes.

Drifted

The bytes no longer hash to what the document records. Whether that is an intended out-of-band edit or corruption is not this answer — see Finding::FixityMismatch, which surfaces the same fact as a question.

Trait Implementations

impl Clone for ContentState

fn clone(&self) -> ContentState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ContentState

impl Debug for ContentState

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

Formats the value using the given formatter.

impl Eq for ContentState

impl PartialEq for ContentState

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ContentState