termpulse 0.1.0

Native terminal progress indicators via OSC 9;4 — with smart detection, graceful fallback, throttling, and stall detection.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

//! Output backends for progress indicators.
//!
//! Termpulse uses a three-tier fallback strategy:
//!
//! 1. **OSC** — native terminal progress via OSC 9;4 sequences
//! 2. **ASCII** — visual `[=====>   ] 50%` progress bar on stderr
//! 3. **Silent** — no output (for pipes, files, CI)

pub mod ascii;
pub mod osc;
pub mod silent;
pub mod tmux;

use crate::ProgressState;

/// Trait for progress output backends.
///
/// All backends implement this trait, allowing the controller to be
/// backend-agnostic.
pub trait Backend: Send {
    /// Emit a progress update.
    fn emit(&mut self, state: ProgressState, percent: Option<u8>, label: &str);

    /// Clear/remove the progress indicator.
    fn clear(&mut self);

    /// Returns the backend name for diagnostics.
    fn name(&self) -> &'static str;
}