pb
A Rust library for displaying customizable progress bars in terminal applications.
What is pb?
pbr is a Rust library for creating and managing progress bars in terminal applications. It helps developers visualize the progress of tasks like file downloads, data processing, or batch operations, improving user experience in command-line tools.
Rust developers building command-line applications or tools that require progress indication for long-running processes.
It offers a lightweight, cross-platform solution with features like multi-bar support and customizable formatting, making it a versatile choice over manual progress implementations.
Overview
Console progress bar for Rust
Use Cases
Best For
- Adding progress indicators to CLI tools in Rust
- Visualizing file copy or download progress
- Displaying multiple concurrent task progress
- Customizing terminal progress bar appearance
- Integrating progress feedback in batch processing scripts
- Building cross-platform command-line utilities with progress tracking
Not Ideal For
- Applications requiring graphical user interface (GUI) progress bars, such as desktop or web apps
- Projects that need non-blocking progress updates without using threads, like lightweight async tasks
- Environments where terminal access is restricted or unavailable, such as embedded systems or headless servers without console output
Pros & Cons
Pros
Consistently works on macOS, Linux, and Windows, as stated in the README, ensuring broad compatibility for CLI tools.
Allows custom bar characters and styles via methods like pb.format(), demonstrated in the simple example with custom symbols.
Supports multiple progress bars simultaneously through the MultiBar API, shown in the example with separate threads for concurrent tasks.
Broadcast writing integrates with file operations to show progress during copies, as seen in the file copying example using std::io.
Cons
Multi-bar support requires spawning threads, which can complicate error handling and increase resource usage, as evident in the MultiBar example.
Methods like mb.listen() block until all bars finish, forcing careful concurrency management and potentially hindering application responsiveness.
Lacks built-in support for estimated time remaining or transfer speed metrics, requiring manual implementation for such common needs.
Frequently Asked Questions
Related Projects
ratatui-org/ratatuiA Rust crate for cooking up terminal user interfaces (TUIs) 👨🍳🐀 https://ratatui.rs
clap-rsA full featured, fast Command Line Argument Parser for Rust
indicatifA command line progress reporting library for Rust
CursiveA Text User Interface library for the Rust programming language
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.