Enum Seen 

pub enum Seen {
    Marker {
        line: String,
        after: Duration,
    },
    StillRunning {
        tail: String,
        waited: Duration,
    },
    Exited {
        code: Option<i32>,
        tail: String,
        after: Duration,
    },
}

What was actually observed while waiting on a running instance — the return of exe::ExeBoot::await_marker and of kvm::KvmBoot::await_serial_marker.

Note what is missing: there is no Ok/Fail, no “ready”. Every one of these outcomes can be the right answer depending on what the caller asked, and a type that guessed would be inventing the verdict the caller exists to make. It carries the evidence instead.

It lives at the crate root, not inside a backend, because it is the one stage-2 observation shape: a process’s captured stdout/stderr and a VM’s serial console are the same question (“did the named line appear before the deadline?”) asked of two different streams, and a per-backend copy would be two definitions of “seen” that drift.

Variants

Marker

The named marker appeared in the captured output. Carries the whole line it appeared on — the applied output, not the fact that a boolean flipped.

Fields

line: String

The full output line containing the marker.

after: Duration

How long after the wait started it appeared.

StillRunning

The deadline elapsed with the process still running and the marker not seen. This is not automatically a failure: for a server, still-running is the healthy state, and the caller may well have been waiting to confirm exactly that. Carries the tail of what was captured so the caller can say why.

Fields

tail: String

The last lines captured, so a report can quote real output.

waited: Duration

The budget that elapsed.

Exited

The process terminated before the marker appeared. For a server this is the real failure, and the exit status plus tail is the evidence.

Fields

code: Option<i32>

Exit code, or None if it was killed by a signal.

tail: String

The last lines captured.

after: Duration

How long it ran.

Implementations

impl Seen

pub fn saw_marker(&self) -> bool

Whether the named marker was observed — the one question with a single honest boolean answer.

pub fn detail(&self) -> String

A one-line, quotable summary carrying the applied output (the matched line, or the tail that was captured instead) — what a matrix cell’s detail should say so a red names what happened rather than that something did not.

Trait Implementations

impl Clone for Seen

fn clone(&self) -> Seen

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Seen

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

Formats the value using the given formatter.

impl Eq for Seen

impl PartialEq for Seen

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Seen