Enum Observed 

pub enum Observed {
    Nothing,
    Value(RefTarget),
    Unreadable(String),
}

The typed ref rejection, re-exported so a consumer of this crate reaches it without also naming the contract crate. RefRejection::of(&err) is the only sanctioned way to ask whether a ref write lost a race — never a message. What was actually there — including the case where something was there and could not be decoded.

Restored from gunnar-store’s deleted Error type, and the three-state is the point. The two call sites that produce it in the gix arm used to write from_gix_target(actual).ok(), which turned a reference that existed and could not be read into None — reported to the pushing client as “nothing was there”. A backend that reports no observed value for a rejection answers Observed::Nothing, which is “the honest answer rather than a dropped one”, and a backend that found bytes it could not parse answers Observed::Unreadable. Collapsing those two is the defect this enum exists to make impossible.

Variants

Nothing

The ref did not exist.

Value(RefTarget)

It existed and held this.

Unreadable(String)

It existed, and the backend could not decode what it held.

Implementations

impl Observed

pub fn absent() -> Observed

An expectation of “must not exist”, as an Observed.

pub fn oid(raw: &[u8]) -> Observed

An oid, as an Observed.

pub fn is_unreadable(&self) -> bool

Trait Implementations

impl Clone for Observed

fn clone(&self) -> Observed

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Observed

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

Formats the value using the given formatter.

impl Display for Observed

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

Formats the value using the given formatter.

impl Eq for Observed

impl PartialEq for Observed

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Observed