#spinner #terminal #loader #spin #command-line-tool #cli

spinoff

Simple to use Rust library for displaying spinners in the terminal

13 releases (7 breaking)

0.8.0 Aug 4, 2023
0.7.0 Jan 29, 2023
0.6.0 Jan 2, 2023
0.5.4 Sep 11, 2022
0.5.3 Jul 31, 2022

#90 in Command-line interface

Download history 1440/week @ 2024-08-10 1127/week @ 2024-08-17 1376/week @ 2024-08-24 1767/week @ 2024-08-31 1441/week @ 2024-09-07 1144/week @ 2024-09-14 1315/week @ 2024-09-21 2265/week @ 2024-09-28 3966/week @ 2024-10-05 3183/week @ 2024-10-12 3784/week @ 2024-10-19 3302/week @ 2024-10-26 2422/week @ 2024-11-02 2620/week @ 2024-11-09 2771/week @ 2024-11-16 4033/week @ 2024-11-23

12,150 downloads per month
Used in 30 crates

MIT license

49KB
728 lines

spinoff

an easy to use, robust library for displaying spinners in the terminal

Version Downloads Docs License Actions

πŸ”¨ Install

Add as a dependency to your Cargo.toml:

[dependencies]
spinoff = "0.8.0"

⚑ Usage

use spinoff::{Spinner, spinners, Color};
use std::thread::sleep;
use std::time::Duration;

let mut spinner = Spinner::new(spinners::Dots, "Loading...", Color::Blue); 
sleep(Duration::from_secs(3));
spinner.success("Done!");

Update a spinner

use spinoff::{Spinner, spinners, Color};
use std::thread::sleep;
use std::time::Duration;

let mut spinner = Spinner::new(spinners::Aesthetic, "Loading...", Color::Red); 
sleep(Duration::from_secs(3));
spinner.update(Spinners::Dots2, "Retrying...", None);
sleep(Duration::from_secs(3));
spinner.stop()

Specify an output stream

use spinoff::{Spinner, spinners, Color, Streams};
use std::thread::sleep;
use std::time::Duration;

let mut spinner = Spinner::new_with_stream(spinners::Line, "Loading...", Color::Yellow, Streams::Stderr);
sleep(Duration::from_secs(3));
spinner.stop_and_persist("πŸ“œ", "Task done.");

πŸ’« Spinners

spinoff includes over 80+ spinner variants out of the box. All spinner variants are treated as features that can be enabled or disabled. By default, all of them are enabled for ease of use. To disable/enable variants, you will have to edit your cargo.toml file:

[dependencies]
spinoff = { version = "0.8.0", features = ["dots", "arc", "line"] }

Any suggestions for new spinner variants are welcome.

Creating your own spinner

You can create your own spinner using the spinner! macro:

use spinoff::*;
use std::thread::sleep;
use std::time::Duration;

let frames = spinner!([">", ">>", ">>>"], 100);
let mut sp = Spinner::new(frames, "Hello World!", None);
sleep(Duration::from_millis(800));
sp.stop();

❗Note for Windows Users

For colors to work properly, you need to add a few extra lines to your code:

use colored::control
control::enable_virtual_terminal(true).unwrap();

πŸ“– Documentation

βš™ Examples

cargo run --example simple
cargo run --example stream
cargo run --example stop_and_persist

Other examples can be found in the documentation.

🚧 Contributing

Any contributions to this crate are highly appreciated. If you have any ideas/suggestions/bug fixes, please open an issue or a pull request. If you like the project, star this project on GitHub.

πŸ“‘ License

This crate is licensed under the MIT license.

Dependencies

~0–10MB
~43K SLoC