kurtlawrence / how-u-doin

Progress reporting abstraction for Rust

how-u-doin

Progress reporting abstraction for Rust

howudoin intends to make producing and consuming progress reports simple and ergonomic. Importantly, it separates the progress producers from the consumer, allowing progress reports to be generated from disparate sections in a system.

// initialise a consumer loop
howudoin::init(howudoin::consumers::Noop::default());

let rpt = howudoin::new().label("Progress").set_len(10);

for _ in 0..10 {
    rpt.inc(); // increment the progress
    // check for cancellation
    if rpt.cancelled() {
        break;
    }
}

rpt.finish(); // finalise progress

// fetch the tree of progress
let progress = howudoin::fetch();

Features:

• Lightweight
• Unobtrusive interface
• Nestable reports
• Automatic timers
• Message accumulation
• Cancellation

Take a look at the examples for example consumers.

• API Docs

Example terminal consumer

Support

Please help support this project by sponsoring 💗

how-u-doin's Issues

Colour is determined based on stdout, but progress bar goes to stderr

When I redirect stdout to a file, but keep stderr going to a terminal, the progress bar stops being coloured.

I'd expect it to stay coloured if stderr is a terminal.

I can understand if this isn't something you can control, I've tried to do it before with other terminal libraries and it's tricky.