Struct InstructionProgress 

pub struct InstructionProgress { /* private fields */ }

Tracks build progress by parsing buildah commit markers out of the build’s log stream and reconstructing per-instruction TUI events.

Construct with InstructionProgress::new (a flattened (stage_idx, inst_idx, text) list) or the convenience InstructionProgress::from_planned_stages. Feed each log line through InstructionProgress::on_line; it returns the BuildEvents the caller should forward.

Implementations

impl InstructionProgress

pub fn new(planned: Vec<(usize, usize, String)>) -> Self

Build a progress tracker from a flattened, ordered list of planned instructions: (stage_idx, inst_idx, instruction_text). The list MUST be in Dockerfile order and exclude FROM lines (which get no commit marker).

pub fn from_planned_stages(stages: &[PlannedStage]) -> Self

Build a progress tracker from the planned stages, flattening each stage’s instructions into (stage_idx, inst_idx, text) in order.

pub fn current(&self) -> Option<(usize, usize)>

The current (stage, index) if the cursor still points at a planned instruction.

pub fn current_text(&self) -> &str

The current instruction’s text (empty string once exhausted).

pub fn start_first(&self) -> Vec<BuildEvent>

Emit the initial BuildEvent::InstructionStarted for the first planned instruction, if any. Call once after sending BuildPlan.

pub fn on_line(&mut self, line: &str, is_stderr: bool) -> Vec<BuildEvent>

Process a single log line.

Always returns a BuildEvent::Output mirroring the raw line. When the line is a buildah commit marker (--> ...), it additionally advances the cursor and appends the matching BuildEvent::InstructionComplete, an optional BuildEvent::StageComplete on a stage boundary, and the next BuildEvent::InstructionStarted.