sindresorhus/ora
Ora
Ora is a terminal spinner library and Node.js CLI component used to integrate animated loading indicators and task-outcome symbols into JavaScript-based terminal applications. It functions as a progress visualizer that signals the status of command-line operations through animated sequences of characters.
The library provides promise-based spinner wrapping, allowing animations to start and resolve automatically based on the outcome of asynchronous tasks. It replaces active animations with specific success, failure, warning, or info symbols to communicate the final result of a process.
The tool manages terminal UI state by updating descriptive text and colors in real time. It also coordinates concurrent log output, enabling text to be printed to the terminal without breaking the active animation or leaving duplicate frames.
Features
- Terminal Progress Indicators - Provides dynamic, overwritable terminal updates and symbols to signal the progress and outcome of CLI operations.
- Node.js CLI Libraries - Acts as a specialized Node.js library for building interactive visual feedback into command-line applications.
- Asynchronous Task Visualization - Provides visual representations of progress and completion for non-blocking JavaScript asynchronous operations.
- Loading State Promises - Wraps asynchronous tasks to automatically display and resolve a loading animation based on promise outcomes.
- Progress Feedback Patterns - Provides visual indicators to inform users that a long-running terminal process is still executing.
- Spinners - Implements animated sequences of characters that act as visual indicators for ongoing background processes in the CLI.
- Promise-Linked - Automatically starts a spinner when a promise begins and resolves it based on the final promise outcome.
- Terminal Loading Animations - Renders animated terminal sequences to provide visual feedback during long-running command-line tasks.
- Task Outcome Indicators - Replaces the active animation sequence with a static character based on the final resolution state.
- Async Lifecycle Hooks - Ties the animation's start and stop states directly to the lifecycle of an asynchronous task.
- Task Progress Indicators - Visualizes the completion status of long-running tasks by replacing animations with result-specific symbols.
- Terminal Escape Sequences - Uses standard terminal escape sequences to manage cursor positioning and perform in-place line updates.
- Terminal Output Managers - Manages terminal output to allow concurrent logging and animation without breaking the interface structure.
- Animation Frame Timers - Implements a fixed-interval timer to cycle through animation frames in the terminal.
- State Redraw Loops - Redraws the terminal interface based on real-time state changes to update spinner frames and labels.
- Spinner State Controllers - Allows dynamic updates to the descriptive text and colors of the spinner during execution.
- Terminal Log Interceptors - Buffers output to ensure log lines are printed above the active spinner without corrupting the animation.
- TUI Output Coordination - Coordinates the printing of log messages to maintain an active animation without breaking the visual layout.
- UI State Management - Synchronizes the internal task state with real-time visual updates of text and colors in the terminal.
- CLI Frameworks - Elegant CLI loading spinners.
- Kommandozeilenschnittstellen - Elegant terminal spinner for loading states.
- Works with AVA - Listed in the “Works with AVA” section of the Awesome Ava awesome list.
