Rattles Terminal Spinners

作者 reason-machines2384a003145a无许可证83 个星标收录于 2026年10月8日更新于 2026年10月8日仓库3个月前更新

Minimal terminal spinner library for Rust with preset collection and no-std support

仅含说明Software Development
AI 生成的概览

Rattles Rust 库参考：终端加载动画预设、自定义关键帧、no_std 与 ratatui 用法。

功能
本技能介绍用于终端加载动画的 Rattles Rust 库，涵盖安装方式、预设分类（箭头、ASCII、盲文、emoji）以及 Rattler 与 TickedRattler 接口。它说明如何按系统时钟、已用时长或索引获取帧，以及如何用 rattle! 宏定义自定义加载动画。还提供 ratatui、tokio 和 no_std 环境的集成示例与常见问题排查说明。
适用场景
适用于为 Rust 命令行应用添加动态加载指示器，包括 no_std 目标。也适合将加载动画集成到 ratatui 界面或定义自定义关键帧时使用。
运行要求
需要 Rust 工具链和 rattles crate（0.1 版本）；集成示例可选使用 ratatui 与 tokio crate。不附带脚本，仅为说明性内容。

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

toml
# Cargo.toml[dependencies]rattles = "0.1"  # with std (default)
# no_stdrattles = { version = "0.1", default-features = false }

Or via CLI:

sh
cargo add rattles
# no_std variantcargo 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)

rust
use std::{io::Write, time::Duration};use rattles::presets::prelude as presets;
fn main() {    let rattle = presets::dots();
    loop {        print!("\r{}", rattle.current_frame());        std::io::stdout().flush().unwrap();        std::thread::sleep(Duration::from_millis(80));    }}

current_frame() uses the system clock internally — no state needed.

Preset Categories

rust
use rattles::presets::{arrows, ascii, braille, emoji};use rattles::presets::prelude as presets; // re-exports all presets
// Arrowslet s = arrows::arrow();let s = arrows::arrow2();
// ASCIIlet s = ascii::line();let s = ascii::pipe();
// Braillelet s = braille::dots();let s = braille::dots2();
// Emojilet s = emoji::earth();let s = emoji::clock();
// Prelude exampleslet s = presets::waverows();let s = presets::dots();

Rattler API

rust
use rattles::presets::prelude as presets;use std::time::Duration;
let rattle = presets::dots();
// Get frame based on system clock (std only)let frame: &str = rattle.current_frame();
// Get frame at specific elapsed duration (std + no_std)let frame = rattle.frame_at(Duration::from_millis(500));
// Get frame by indexlet frame = rattle.frame(3);
// Change animation intervallet rattle = presets::dots().set_interval(Duration::from_millis(50));
// Reverse directionlet rattle = presets::waverows().reverse();
// Convert to tick-based (stateful)let mut ticked = presets::dots().into_ticked();

TickedRattler (Stateful / no_std-friendly)

rust
use rattles::presets::prelude as presets;
let mut rattle = presets::dots().into_ticked();
loop {    rattle.tick();    let frame = rattle.current_frame();    // render frame...}

TickedRattler must be stored (it holds state). Suitable for no_std contexts where the global clock is unavailable.

Index-Based Animation (no_std)

rust
use rattles::presets::prelude as presets;
let rattle = presets::dots();let mut i = 0usize;
loop {    let frame = rattle.frame(i);    i = i.wrapping_add(1);    // render frame...}

Time-Based Animation with External Clock (no_std)

rust
use rattles::presets::prelude as presets;use core::time::Duration;
let rattle = presets::dots();
// elapsed comes from your platform's timerlet elapsed: Duration = get_elapsed(); // your implementationlet frame = rattle.frame_at(elapsed);

Custom Spinners with rattle! Macro

rust
use rattles::rattle;
rattle!(    MySpinner,   // generated struct name    my_spinner,  // generated constructor function name    1,           // row count (width of spinner)    120,         // interval in milliseconds    ["⣾", "⣷", "⣯", "⣟", "⣻", "⣽"]  // keyframes);
// Use it like any presetlet s = my_spinner();println!("{}", s.current_frame());

Multi-row custom spinner:

rust
rattle!(    Wide,    wide_spinner,    3,   // 3 characters wide    80,    ["[   ]", "[=  ]", "[== ]", "[===]", "[ ==]", "[  =]"]);

Ratatui Integration

rust
// examples/ratatui.rs patternuse rattles::presets::prelude as presets;use ratatui::{    backend::CrosstermBackend,    widgets::Paragraph,    Terminal,};
fn ui(frame: &mut ratatui::Frame, rattle: &rattles::Rattler) {    let spinner_text = rattle.current_frame();    let paragraph = Paragraph::new(format!("{} Loading...", spinner_text));    frame.render_widget(paragraph, frame.size());}
fn main() -> std::io::Result<()> {    let rattle = presets::dots();
    // standard ratatui event loop    loop {        terminal.draw(|f| ui(f, &rattle))?;        std::thread::sleep(std::time::Duration::from_millis(16));
        // break on user input...    }    Ok(())}

Since Rattler is stateless, pass it by reference anywhere — no Arc<Mutex<>> needed.

no_std Setup

toml
[dependencies]rattles = { version = "0.1", default-features = false }
rust
#![no_std]use rattles::presets::prelude as presets;
// Option 1: tick-basedlet mut rattle = presets::dots().into_ticked();rattle.tick();let frame = rattle.current_frame();
// Option 2: index-basedlet rattle = presets::dots();let frame = rattle.frame(42);
// Option 3: duration-based (external clock)let rattle = presets::dots();let frame = rattle.frame_at(core::time::Duration::from_millis(840));

Common Patterns

Spinner with message

rust
use rattles::presets::prelude as presets;use std::{io::Write, time::Duration};
fn main() {    let rattle = presets::dots();    let message = "Fetching data...";
    loop {        print!("\r{} {}", rattle.current_frame(), message);        std::io::stdout().flush().unwrap();        std::thread::sleep(Duration::from_millis(80));    }}

Async-compatible (tokio)

rust
use rattles::presets::prelude as presets;use tokio::time::{sleep, Duration};
#[tokio::main]async fn main() {    let rattle = presets::dots();
    let spinner = tokio::spawn(async move {        loop {            print!("\r{}", rattle.current_frame());            std::io::stdout().flush().unwrap();            sleep(Duration::from_millis(80)).await;        }    });
    // do your async work    do_work().await;    spinner.abort();    println!("\rDone!     ");}

Collecting all frames

rust
let rattle = presets::dots();let frames: Vec<&str> = (0..rattle.frame_count())    .map(|i| rattle.frame(i))    .collect();

Troubleshooting

Spinner not animating (stuck on first frame)

  • Ensure you're flushing stdout: std::io::stdout().flush().unwrap()
  • Use \r to overwrite the line, not \n
  • The sleep interval should match or be shorter than the spinner's interval

current_frame() not available in no_std

  • Use frame_at(duration), frame(index), or into_ticked() instead
  • Disable default features: rattles = { version = "...", default-features = false }

Custom spinner not compiling

  • Keyframes must be string literals in the rattle! macro array
  • Row count must match the visual width of each keyframe string

Spinner looks garbled in terminal

  • Some braille/emoji frames require a terminal with Unicode support
  • Test with ASCII presets (ascii::line()) to verify basic functionality first

来源与署名

来源：reason-machines/trending-skills位于skills/rattles-terminal-spinners提交2384a00

许可证： 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架

更多来自 reason-machines/trending-skills 的技能

Yourvpndead Vpn Detection

reason-machines

介绍一款 Android 应用，用于检测 VPN 客户端并探测本机 SOCKS5 与 Clash API 端口是否泄露。

Security833个月前更新

X Mentor Skill Nuwa

reason-machines

提供 X（Twitter）内容策略指导：推文与长推写作、钩子点评、增长策略与账号诊断。

Marketing & Sales833个月前更新

Wildworld Dataset

reason-machines

介绍 WildWorld 动作条件 ARPG 世界建模数据集，并给出预期的加载、筛选与基准评测代码。

Data & Analytics833个月前更新

Understand Anything Knowledge Graph

reason-machines

为代码库构建可交互的知识图谱，并支持可视化探索、搜索和提问。

Software Development833个月前更新

Webphysics Avbd Engine

reason-machines

指导将实验性 WebGPU AVBD 刚体与软体物理引擎集成到浏览器项目中。

Software Development833个月前更新

Ui Ux Pro Max Skill

reason-machines

根据产品描述生成 UI/UX 设计系统，包括页面结构、风格、配色、字体搭配与检查清单。

Design & Creative833个月前更新

更多Software Development技能

Playground

anthropics

精选

构建自包含的交互式 HTML 演练场，包含控件、实时预览和可复制的提示词输出。

Software Development37K今天更新

M5 Onboard

anthropics

精选

通过 USB 检测 M5Stack ESP32 开发板，刷写 UIFlow 2.0 固件并安装 MicroPython 应用包。

Software Development37K今天更新

Cardputer Buddy

anthropics

精选

指导迭代 Cardputer-Adv 的 MicroPython 应用包：添加应用、通过 USB 串口推送文件、查看日志并运行 REPL 命令。

Software Development37K今天更新

Web Design Guidelines

vercel-labs

精选

依据从远程来源获取的 Web Interface Guidelines 审查 UI 代码，并以 file:line 形式报告问题。

Software Development32K5周前更新

Vercel React Native Skills

vercel-labs

精选

React Native 与 Expo 最佳实践规则，涵盖列表性能、动画、导航、UI 模式、状态与 monorepo 配置。

Software Development32K5周前更新

Vercel React Best Practices

vercel-labs

精选

Vercel 的 React 与 Next.js 性能指南，以 70 条规则的形式用于编写、审查和重构代码。

Software Development32K5周前更新