Crate yapb

source ·
Expand description

Yet Another Progress Bar

This library provides lightweight tools for rendering progress indicators and related information. Unlike most similar libraries, it performs no IO internally, instead providing Display implementations. Handling the details of any particular output device is left to the user.

Examples

The termion crate can be used to implement good behavior on an ANSI terminal:

extern crate yapb;
extern crate termion;
use std::{thread, time};
use std::io::{self, Write};
use yapb::{Bar, Progress};

fn main() {
  let mut bar = Bar::new();
  print!("{}", termion::cursor::Save);
  for i in 0..100 {
    bar.set(i as f32 / 100.0);
    let (width, _) = termion::terminal_size().unwrap();
    print!("{}{}[{:width$}]",
           termion::clear::AfterCursor, termion::cursor::Restore,
           bar, width = width as usize - 2);
    io::stdout().flush().unwrap();
    thread::sleep(time::Duration::from_millis(100));
  }
}

Modules

Helpers to display compact human-readable numbers

Structs

An unusually high-resolution progress bar using Unicode block elements
A spinner that cycles through 16 states by counting in binary using block elements
A spinner that cycles through 256 states by counting in binary using braille
Exponential moving average, useful for computing throughput
A spinner that cycles through many states with a snake made of 1-6 braille dots
A spinner that cycles through 4 states with a single spinning block element
A spinner that cycles through 8 states with a single spinning braille dot

Traits

Indicators that communicate a proportion of progress towards a known end point
Indicators that animate through some number of states to indicate activity with indefinite duration