Struct Plan 

pub struct Plan { /* private fields */ }

Immutable, topologically-layered execution plan.

Layer n holds only actions whose dependencies are all in layers 0..n, so layers can be executed in order; actions within a single layer are independent and may run in parallel.

Implementations

impl Plan

pub fn layers(&self) -> &[Vec<ActionId>]

Topological layers, each layer’s actions independent of each other.

pub fn reasons(&self) -> &HashMap<ActionId, ChangeReason>

Map of stale action id → reason. Actions absent from the map are up-to-date.

pub fn stale(&self) -> impl Iterator<Item = &ActionId>

Iterator over the ids of all stale actions (any reason).

pub fn flat_topo(&self) -> impl Iterator<Item = &ActionId>

Iterator over all action ids in topological order, flattening layers.

pub async fn compute( actions: &[Box<dyn Action>], cache: &dyn Cache, ctx: &Ctx, ) -> Result<Self, PlanError>

Build a plan from a set of actions and a cache snapshot.

Errors

• PlanError::MissingDep when an action declares a dep on an unknown id.
• PlanError::Cycle when no topological order exists.
• PlanError::Build when Action::input_hash returns an error.

pub fn input_hash(&self, id: &ActionId) -> Option<Sha256>

Pre-computed input hash for id, captured during Self::compute. Returns None for ids not in the plan (caller error).

Trait Implementations

impl Clone for Plan

fn clone(&self) -> Plan

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Plan

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

Formats the value using the given formatter.