https://github.com/emersonford/tracing-indicatif

Tracing layer that automatically creates and manages progress bars for active spans.
https://github.com/emersonford/tracing-indicatif

indicatif progress-bar rust tracing

Last synced: about 2 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/emersonford/tracing-indicatif
• Owner: emersonford
• License: mit
• Created: 2023-02-04T06:11:09.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2025-01-18T19:15:51.000Z (5 months ago)
• Last Synced: 2025-04-14T23:19:11.006Z (3 months ago)
• Topics: indicatif, progress-bar, rust, tracing
• Language: Rust
• Homepage:
• Size: 15.1 MB
• Stars: 215
• Watchers: 4
• Forks: 9
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# tracing-indicatif

[![Documentation](https://docs.rs/tracing-indicatif/badge.svg)](https://docs.rs/tracing-indicatif/)

[![Crates.io](https://img.shields.io/crates/v/tracing-indicatif.svg)](https://crates.io/crates/tracing-indicatif)

A [tracing](https://docs.rs/tracing/latest/tracing/) layer that automatically creates and manages [indicatif](https://docs.rs/indicatif/latest/indicatif/index.html) 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](https://docs.rs/tracing/latest/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.

## Demo

See the [`examples`](https://github.com/emersonford/tracing-indicatif/tree/main/examples)

folder for demo code.

### [Default Configuration](https://github.com/emersonford/tracing-indicatif/blob/main/examples/basic.rs)

![demo using basic example](basic.gif)

### [Default Configuration with Child Spans](https://github.com/emersonford/tracing-indicatif/blob/main/examples/child_spans.rs)

![demo using child_spans example](child_spans.gif)

### [Progress Bar](https://github.com/emersonford/tracing-indicatif/blob/main/examples/progress_bar.rs)

![demo using progress_bar example](progress_bar.gif)

### [Build Console Like](https://github.com/emersonford/tracing-indicatif/blob/main/examples/build_console.rs)

A recreation of `buck2`'s [superconsole](https://github.com/facebookincubator/superconsole).

![demo using build_console example](build_console.gif)

## Features

* Customize progress bars using the same [`ProgressStyle`](https://docs.rs/indicatif/latest/indicatif/style/struct.ProgressStyle.html#method.template)

  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.