Enum PollOutcome 

pub enum PollOutcome {
    Ready(QueuedDemand),
    Failed(RefreshState),
}

One target’s demand poll, as a value this module can decide from.

The failure half is c3’s RefreshState rather than an InventoryError, for the reason c3 gives: InventoryError owns a reqwest::Error and a serde_json::Error, so it is neither Clone nor PartialEq and cannot be stored, compared, or rendered. Summarising at the gateway boundary — exactly once, in GatewayDemand — is what lets the whole schedule below be a pure function of values a test can construct.

RefreshState::Ready never appears in PollOutcome::Failed: RefreshState::from_error cannot produce it, and a demand poll returns a QueuedDemand rather than the runner inventory that variant carries.

Variants

Ready(QueuedDemand)

GitHub answered. The count may still be a floor — see QueuedDemand::is_complete.

Failed(RefreshState)

GitHub did not answer, or answered something this loop must slow down for.

Implementations

impl PollOutcome

pub const fn reading(&self) -> Option<&QueuedDemand>

The demand reading, when there is one.

pub const fn failure(&self) -> Option<&RefreshState>

The failure, when there is one.

pub fn is_offline(&self) -> bool

Whether GitHub could not be reached at all, as opposed to answering something unwelcome.

The whole of flow 3.3 turns on this distinction: an outage retains running runners and backs off, while a rejection is a configuration problem that waiting does not fix.

Trait Implementations

impl Clone for PollOutcome

fn clone(&self) -> PollOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PollOutcome

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

Formats the value using the given formatter.

impl Eq for PollOutcome

impl PartialEq for PollOutcome

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PollOutcome