Struct Live 

pub struct Live(/* private fields */);

Where a running tool reports output as it comes, such as Shell’s lines. Cloning shares the sink.

use std::sync::{Arc, Mutex};
use rig_tools::Live;

let seen = Arc::new(Mutex::new(String::new()));
let live = Live::new({
    let seen = seen.clone();
    move |text| seen.lock().map(|mut seen| seen.push_str(text)).unwrap_or_default()
});
live.line("building\n");
assert_eq!(seen.lock().map(|seen| seen.clone()).ok().as_deref(), Some("building\n"));

Implementations

impl Live

pub fn new(report: impl Fn(&str) + Send + Sync + 'static) -> Self

A sink that hands each piece of output to report, on the thread the tool runs on: keep report quick.

pub fn line(&self, text: &str)

Reports text, the next piece of output: a line with its \n, or the end of the output without one.

Trait Implementations

impl Clone for Live

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Live

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

Formats the value using the given formatter.