Struct ProgressHandle 

pub struct ProgressHandle { /* private fields */ }

Cheap, cloneable handle for writing progress from the Lua bridge.

Wraps the shared SessionStatus to expose only progress-related writes. Passed to bridge::register_progress().

Call site and threading

Called exclusively from the Lua OS thread via alc.progress(). Acquires std::sync::Mutex<SessionStatus> for a few microseconds (single field assignment). See SessionStatus doc for full locking design.

Poison policy

Silently skips on poison. Progress is observational (consumed by alc_status) — a missed update degrades monitoring but does not affect execution correctness. If you observe stale progress in alc_status while the session is active, mutex poison from an earlier OOM panic is a possible cause.

Implementations

impl ProgressHandle

pub fn set(&self, step: u64, total: u64, message: Option<String>)

Set the current progress. Called from alc.progress(step, total, msg?).

Silently skips on mutex poison (see ProgressHandle doc for rationale).

Trait Implementations

impl Clone for ProgressHandle

fn clone(&self) -> ProgressHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.