#progress-bar #progress #tracing #tracing-layer #cli


Tracing layer that automatically creates and manages progress bars for active spans

11 releases

0.3.6 Dec 12, 2023
0.3.5 Aug 21, 2023
0.3.4 Apr 29, 2023
0.3.0 Feb 19, 2023
0.1.0 Feb 9, 2023

#88 in Command-line interface

Download history 851/week @ 2024-01-05 1586/week @ 2024-01-12 1166/week @ 2024-01-19 1140/week @ 2024-01-26 1166/week @ 2024-02-02 1209/week @ 2024-02-09 1991/week @ 2024-02-16 1510/week @ 2024-02-23 1893/week @ 2024-03-01 2570/week @ 2024-03-08 2026/week @ 2024-03-15 1889/week @ 2024-03-22 1616/week @ 2024-03-29 1742/week @ 2024-04-05 2011/week @ 2024-04-12 1535/week @ 2024-04-19

7,243 downloads per month
Used in 13 crates (12 directly)

MIT license

1.5K SLoC


Documentation Crates.io

A tracing layer that automatically creates and manages indicatif progress bars for active spans.

Progress bars are a great way to make your CLIs feel more responsive. However, adding and managing progress bars in your libraries can be invasive, unergonomic, and difficult to keep track of.

This library aims to make it easy to show progress bars for your CLI by tying progress bars to tracing spans. For CLIs/libraries already using tracing spans, this allow for a dead simple (3 line) code change to enable a smooth progress bar experience for your program. This eliminates having to have code in your libraries to manually manage progress bar instances.

This ends up working quite well as progress bars are fundamentally tracking the lifetime of some "span" (whether that "span" is defined explicitly or implicitly), so might as well make that relationship explicit.


See the examples folder for demo code.

Default Configuration

demo using basic example

Default Configuration with Child Spans

demo using child_spans example

Progress Bar

demo using progress_bar example

Build Console Like

A recreation of buck2's superconsole. demo using build_console example


  • Customize progress bars using the same ProgressStyle API as indicatif.
  • Supports displaying parent-child span relationship between progress bars.
  • Limit the number of progress bars visible on the terminal.
  • Prevents progress bars from clobbering tracing logs.


~94K SLoC