#progress-bar #status #progress #status-bar #terminal #cli #terminal-text

status-line

This crate allows you to display status & progress information in a terminal

3 unstable releases

0.2.0 Dec 13, 2021
0.1.1 Nov 25, 2021
0.1.0 Nov 24, 2021

#641 in Command-line interface

Download history 2695/week @ 2023-11-27 2729/week @ 2023-12-04 3110/week @ 2023-12-11 2897/week @ 2023-12-18 1194/week @ 2023-12-25 2032/week @ 2024-01-01 2447/week @ 2024-01-08 2377/week @ 2024-01-15 3094/week @ 2024-01-22 2229/week @ 2024-01-29 2151/week @ 2024-02-05 2724/week @ 2024-02-12 3033/week @ 2024-02-19 2620/week @ 2024-02-26 2358/week @ 2024-03-04 953/week @ 2024-03-11

9,131 downloads per month
Used in 2 crates

MIT license

11KB
111 lines

status-line

This crate allows you to display status & progress information in a terminal

Crates.io Documentation License: MIT

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