Enum BuildEvent 

pub enum BuildEvent {
    BuildStarted {
        total_stages: usize,
        total_instructions: usize,
    },
    StageStarted {
        index: usize,
        name: Option<String>,
        base_image: String,
    },
    InstructionStarted {
        stage: usize,
        index: usize,
        instruction: String,
    },
    Output {
        line: String,
        is_stderr: bool,
    },
    InstructionComplete {
        stage: usize,
        index: usize,
        cached: bool,
    },
    StageComplete {
        index: usize,
    },
    BuildComplete {
        image_id: String,
    },
    BuildFailed {
        error: String,
    },
    BuildPlan {
        stages: Vec<PlannedStage>,
    },
}

Build event for TUI updates

These events are sent from the build process to update the TUI state. The TUI processes these events asynchronously and updates the display.

Variants

BuildStarted

Build has started — sent once up-front, before any StageStarted.

Carries the total number of stages and instructions so that progress-bar denominators can be populated before any work begins. Backends that have the full instruction tree at entry (Dockerfile/ZImagefile) should emit this; if it is not emitted, the TUI falls back to counting stages/instructions as events arrive.

Fields

total_stages: usize

Total number of stages in this build.

total_instructions: usize

Total number of instructions across all stages.

StageStarted

Starting a new stage

Fields

index: usize

Stage index (0-based)

name: Option<String>

Optional stage name (from AS name)

base_image: String

Base image for this stage

InstructionStarted

Starting an instruction within a stage

Fields

stage: usize

Stage index

index: usize

Instruction index within the stage

instruction: String

Instruction text (e.g., “RUN npm ci”)

Output

Instruction output (streaming)

Fields

line: String

Output line content

is_stderr: bool

Whether this is stderr (true) or stdout (false)

InstructionComplete

Instruction completed

Fields

stage: usize

Stage index

index: usize

Instruction index

cached: bool

Whether this instruction was served from cache

StageComplete

Stage completed

Fields

index: usize

Stage index

BuildComplete

Build complete

Fields

image_id: String

Final image ID

BuildFailed

Build failed

Fields

error: String

Error message

BuildPlan

Pre-populates the instruction list up-front (from the parsed Dockerfile) so backends that can’t emit live per-instruction StageStarted/InstructionStarted events (the buildah sidecar) still show the full plan; instructions land as Pending and are advanced to Running/Complete as progress arrives.

Fields

stages: Vec<PlannedStage>

The full set of planned stages, in Dockerfile order.

Trait Implementations

impl Clone for BuildEvent

fn clone(&self) -> BuildEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BuildEvent

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

Formats the value using the given formatter.