3 unstable releases
0.2.0 | Dec 13, 2021 |
---|---|
0.1.1 | Nov 25, 2021 |
0.1.0 | Nov 24, 2021 |
#547 in Command-line interface
14,785 downloads per month
Used in 2 crates
11KB
111 lines
status-line
This crate allows you to display status & progress information in a terminal
This crate handles the problem of displaying a small amount of textual information in a terminal, periodically refreshing it, and finally erasing it, similar to how progress bars are displayed.
A status line can be viewed as a generalization of a progress bar. Unlike progress bar drawing crates, this crate does not require that you render the status text as a progress bar. It does not enforce any particular data format or template, nor it doesn't help you with formatting.
The status line text may contain any information you wish, and may even be split
into multiple lines. You fully control the data model, as well as how the data gets printed
on the screen. The standard Display
trait is used to convert the data into printed text.
Status updates can be made with a very high frequency, up to tens of millions of updates
per second. StatusLine
decouples redrawing rate from the data update rate by using a
background thread to handle text printing with low frequency.
Example
use std::fmt::{Display, Formatter};
use std::sync::atomic::{AtomicU64, Ordering};
use status_line::StatusLine;
// Define the data model representing the status of your app.
// Make sure it is Send + Sync, so it can be read and written from different threads:
struct Progress(AtomicU64);
// Define how you want to display it:
impl Display for Progress {
fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
write!(f, "{}%", self.0.load(Ordering::Relaxed))
}
}
// StatusLine takes care of displaying the progress data:
let status = StatusLine::new(Progress(AtomicU64::new(0))); // shows 0%
status.0.fetch_add(1, Ordering::Relaxed); // shows 1%
status.0.fetch_add(1, Ordering::Relaxed); // shows 2%
drop(status) // hides the status line
Dependencies
~235KB