pixbar 0.2.0

Sub-cell-precision two-value progress bar for narrow terminal widths (Unicode 1/8 block, no font patching required).
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
30
31
32
33
34
35
36
37
38
39
40
41
42
43

use crate::{render::{Cell, CellKind}, glyphs::glyph_for, Capability, Rgb, Theme};

/// Render a [`Cell`] sequence as an inline-styled HTML `<pre>` block.
///
/// Useful for embedding bars in README pages, visual regression fixtures,
/// or reports. Unlike [`crate::ansi::encode`], empty cells get an explicit
/// `theme.empty` background — HTML has no concept of "transparent so the
/// terminal shows through."
pub fn to_html(cells: &[Cell], theme: &Theme, cap: Capability) -> String {
    let mut s = String::new();
    s.push_str(r#"<pre style="font-family:'JetBrains Mono',monospace;font-size:18px;background:#0d1117;padding:8px;border-radius:6px;margin:0;display:inline-block;">"#);
    for c in cells {
        let g = glyph_for(c.kind, c.sub_fill, cap);
        let (fg, bg) = match c.kind {
            CellKind::Empty                                       => (theme.empty,     theme.empty),
            CellKind::PrimaryFull                                 => (theme.primary,   theme.empty),
            CellKind::SecondaryFull                               => (theme.secondary, theme.empty),
            CellKind::OverflowFull                                => (theme.overflow,  theme.empty),
            CellKind::PrimaryBoundary | CellKind::DegradedOverlap => (theme.primary,   theme.secondary),
            CellKind::SecondaryBoundary                           => (theme.secondary, theme.empty),
            CellKind::OverflowInnerBoundary                       => (theme.primary,   theme.overflow),
            CellKind::OverflowOuterBoundary                       => (theme.overflow,  theme.empty),
        };
        s.push_str(&format!(
            r#"<span style="color:{};background:{};">{}</span>"#,
            rgb_css(fg), rgb_css(bg), html_escape(g),
        ));
    }
    s.push_str("</pre>");
    s
}

fn rgb_css(c: Rgb) -> String { format!("rgb({},{},{})", c.0, c.1, c.2) }

fn html_escape(c: char) -> String {
    match c {
        ' '  => "&nbsp;".into(),
        '<'  => "&lt;".into(),
        '>'  => "&gt;".into(),
        '&'  => "&amp;".into(),
        c    => c.to_string(),
    }
}