Struct ColumnUsage 

pub struct ColumnUsage {
    pub column: String,
    pub items: u32,
    pub estimate: Option<u32>,
    pub limit: Option<ColumnLimit>,
}

One column’s usage, and the limit it is measured against.

Fields

column: String

The column’s name, as the board declares it.

items: u32

How many issues the column holds.

estimate: Option<u32>

The estimate total in the limit’s unit.

None when the board states no estimate ceiling for the column (there is no unit to count in) or when at least one issue’s estimate could not be counted — the snapshot’s diagnostics say which issue, and ColumnUsage::state is then LimitState::Unknown.

limit: Option<ColumnLimit>

The enabled limit in force for the column, if any.

Implementations

impl ColumnUsage

pub fn max_items(&self) -> Option<u32>

The item ceiling, when the column has one.

pub fn max_estimate(&self) -> Option<u32>

The estimate ceiling, when the column has one.

pub fn unit(&self) -> Option<&str>

The unit the estimate ceiling counts in, when there is one.

pub fn policy(&self) -> Option<LimitPolicy>

The policy the column enforces, when it enforces one.

pub fn item_state(&self) -> LimitState

Where the column stands on its own item ceiling.

pub fn estimate_state(&self) -> LimitState

Where the column stands on its own estimate ceiling.

pub fn state(&self) -> LimitState

Where the column stands overall: the worse of its two ceilings.

pub fn prospective(&self, add_items: u32, add_estimate: u32) -> LimitState

The state the column would be in after add_items more cards and add_estimate more of its unit (T009).

This is the before/after shape a move is judged with: the caller passes what the move would add, and reads the answer without touching a file. A move that adds nothing reproduces state exactly.

pub fn cell(&self) -> String

The usage as one short cell: 4/5, or 4 when the column has no item ceiling, with the estimate ceiling beside it in its unit (12/20d) when the board states one. A trailing ! means something is over, or unknown.

It is deliberately the usage, not a verdict: the verdict is the policy layer’s, and a cell that said “block” would be a claim this module is not entitled to make.

Trait Implementations

impl Clone for ColumnUsage

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ColumnUsage

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

Formats the value using the given formatter.

impl Eq for ColumnUsage

impl PartialEq for ColumnUsage

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ColumnUsage