Rattles Terminal Spinners

Rattles Terminal Spinners

Skill by ara.so — Daily 2026 Skills collection.

Rattles is a minimal, zero-dependency Rust library for terminal spinners. It has no runtime or lifecycle — spinners are constructed directly in render loops with negligible cost. Supports no_std environments.

Installation

# Cargo.toml
[dependencies]
rattles = "0.1"  # with std (default)

# no_std
rattles = { version = "0.1", default-features = false }

Or via CLI:

cargo add rattles

# no_std variant
cargo add rattles --no-default-features

Core Concepts

• Rattler: a spinner definition (frames + interval). Stateless and cheap to construct.
• TickedRattler: stateful wrapper for tick-based driving (required in no_std).
• Presets: built-in spinners organized by category.
• rattle! macro: define custom spinners at compile time.

Basic Usage (std)

use std::{io::Write, time::Duration};
use rattles::presets::prelude as presets;

fn main() {
    let rattle = presets::dots();