Enum CheckStatus 

pub enum CheckStatus {
    Passed,
    Failed,
    Running,
    Errored,
}

What an automated check found about a commit (D49).

Four states and not two. Each one implies a different action, which is the only reason a state earns a variant. “Not finished” is a real answer and the one a caller most needs to distinguish, because the action it implies – wait – differs from both pass and fail. Collapsing it into failure makes every in-flight check look like a broken build; collapsing it into success is worse.

Errored is the durable half of D18’s central claim: a provider fault is not a statement about the commit. choir-queue already refuses to evict a change on one, but until this variant existed the fault could be recorded nowhere, so a re-run was the only way anyone downstream learned it had happened.

Variants

Passed

The check ran and was satisfied.

Failed

The check ran and was not satisfied.

Running

The check has started and has not reported an outcome.

Errored

The check could not be run, so it says nothing about the commit.

A VM that failed to boot, a runner that vanished, a job over its deadline. The distinction from CheckStatus::Failed is not cosmetic: Failed is evidence about the commit and blocks it on its merits, while Errored is evidence about us, and the action it implies is a re-run rather than a rewrite.

Implementations

impl CheckStatus

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

The wire spelling, which is also what the CLI accepts.

pub fn parse(raw: &str) -> Option<Self>

Parses the CLI spelling, or None for anything else.

Deliberately not a FromStr impl taking arbitrary case: a check reported as "PASSED" by a runner that upcased its output should be refused loudly rather than accepted into a signed op, because the op is what a later audit reads.

Trait Implementations

impl Clone for CheckStatus

fn clone(&self) -> CheckStatus

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CheckStatus

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CheckStatus

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for CheckStatus

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for CheckStatus

impl Eq for CheckStatus

impl StructuralPartialEq for CheckStatus