Enum AttemptOutcome 

pub enum AttemptOutcome {
    CompletedJob,
    ExitedIdleWithoutWork,
    Failed {
        reason: FailureReason,
    },
    Orphaned,
}

What terminally happened to an attempt.

The state and the outcome are not two independent fields that a caller has to keep consistent: AttemptOutcome::terminal_state derives the state from the outcome, and RunnerAttempt::conclude is the only way to set either. A failed attempt whose outcome says it ran a job is therefore not a bug this code can have.

Variants

CompletedJob

The runner accepted its one job and the job ended. This says the runner finished, never that the workflow succeeded — GitHub remains the source of truth for workflow outcome (03-control-flows.md, flow 2, Failure).

ExitedIdleWithoutWork

The surplus case. The runner registered, no job arrived, and it exited on its idle timeout (flow 2.7). Normal, bounded, and not a failure.

Failed

The attempt failed.

Fields

reason: FailureReason

Orphaned

Supervision was lost: the process is gone and the attempt could not be reconciled with GitHub (e3, restart recovery).

Implementations

impl AttemptOutcome

pub fn failed(reason: FailureReason) -> Self

pub const fn terminal_state(&self) -> AttemptState

The one terminal state this outcome corresponds to.

pub const fn is_failure(&self) -> bool

True for the outcomes an operator should be told to look at.

g2 renders this differently from Self::is_idle_exit, and e1’s Definition of Done requires that a surplus attempt “is not reported as a failure”.

pub const fn is_idle_exit(&self) -> bool

True only for the surplus case.

pub const fn ran_a_job(&self) -> bool

True only when this runner actually took a job.

Trait Implementations

impl Clone for AttemptOutcome

fn clone(&self) -> AttemptOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AttemptOutcome

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AttemptOutcome

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for AttemptOutcome

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

Formats the value using the given formatter.

impl Eq for AttemptOutcome

impl PartialEq for AttemptOutcome

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for AttemptOutcome

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 AttemptOutcome