Struct RunnerInventory 

pub struct RunnerInventory { /* private fields */ }

Every runner GitHub reports for one target, across every page.

Implementations

impl RunnerInventory

pub fn new(target: ScaleTarget, runners: Vec<Runner>) -> Self

A complete inventory read in one page. The constructor test doubles and callers use; the gateway builds them through RunnerInventory::paged.

pub fn paged( target: ScaleTarget, runners: Vec<Runner>, reported_total: Option<u64>, pages: usize, truncated: bool, ) -> Self

An inventory that took pages requests to read.

pub fn target(&self) -> &ScaleTarget

pub fn runners(&self) -> &[Runner]

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn busy_count(&self) -> usize

Runners GitHub reports as executing a job.

This is not the in-progress workflow count. See ActivityCount::total; the two are different aggregates and g2 renders them separately.

pub fn online_count(&self) -> usize

pub fn reported_total(&self) -> Option<u64>

GitHub’s own total_count, when it sent one.

pub fn pages(&self) -> usize

How many requests reading this inventory took.

pub fn truncated(&self) -> bool

true when the MAX_PAGES ceiling stopped the walk, so this is a prefix of the inventory rather than the inventory.

pub fn missing(&self) -> Option<u64>

How many runners GitHub said exist that this walk did not collect.

The whole reason pagination is mandatory, made checkable: a caller that wants to refuse to render an incomplete inventory can, and one that renders it anyway can say so. checked_sub rather than a > test and a subtraction, because collecting more than GitHub reported is reachable: a rel="next" that points back at the page it arrived on is answered by the MAX_PAGES ceiling, and by then the same page has been collected a hundred times against a total_count of one. The eager then_some this replaced panicked with a subtraction overflow on exactly that path — in a debug build, from inside the agent’s reconciliation loop.

Trait Implementations

impl Clone for RunnerInventory

fn clone(&self) -> RunnerInventory

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunnerInventory

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

Formats the value using the given formatter.

impl Eq for RunnerInventory

impl PartialEq for RunnerInventory

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RunnerInventory