Struct ProgressHandle 

pub struct ProgressHandle<'a> { /* private fields */ }

Ergonomic scoped handle: binds a ProgressToken to a ProgressSink so tool code can emit without repeating the token argument.

Construct one at the top of a long-running tool’s execute_with_progress and call ProgressHandle::update as work proceeds.

Implementations

impl<'a> ProgressHandle<'a>

pub fn new(sink: &'a dyn ProgressSink, total: Option<u64>) -> Self

Create a handle for a new operation on sink with an optional known total.

pub fn with_token( sink: &'a dyn ProgressSink, token: ProgressToken, total: Option<u64>, ) -> Self

Create a handle reusing an existing token (e.g. one supplied by the caller).

pub fn token(&self) -> ProgressToken

Token backing this handle.

pub fn update(&self, progress: u64, message: Option<&str>)

Emit a progress update.