Enum Landed 

pub enum Landed {
    Yes {
        evidence: LandingEvidence,
    },
    No,
    Unknown,
}

Whether the work reached the base, and — where it did — what says so.

The evidence travels inside the answer rather than beside it, so a yes with nothing behind it and a no naming a landing commit are both unrepresentable: only tiers 1 to 3 answer yes, and only the content comparison answers the other two.

Variants

Yes

It reached the base, and this is the record that says so.

Fields

evidence: LandingEvidence

Which tier decided it, and the commit that is the evidence.

No

Nothing records that it reached the base, and the base does not carry what it changed. The last tier — a comparison of content, not a record — so this is “there is work here and nothing says it landed” rather than a proof that it did not.

Unknown

Nothing records that it reached the base, and the base already carries everything it changed.

Undecidable from history, and deliberately not a no: it is what a branch that landed with no change request and not through this crate leaves behind, and it is also what somebody else making the same change leaves behind.

The default, and the only one that could be: a document written before there was a field to write said nothing about landing, and nothing is not “no”.

Implementations

impl Landed

pub fn is_landed(&self) -> bool

Whether this answer is a landing, which is the one thing every caller acts on.

pub fn tier(&self) -> &'static str

The tier that decided it, in the words a rendering names it by — which are prose rather than the kebab-case the answer serializes as, because the one place they are read is a sentence.

Trait Implementations

impl Clone for Landed

fn clone(&self) -> Landed

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Landed

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

Formats the value using the given formatter.

impl Default for Landed

fn default() -> Landed

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Landed

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Landed

impl PartialEq for Landed

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Landed

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Landed