term-sparkline 📈

Adaptive high-definition (1px Retina) and Unicode-based inline sparklines for modern terminals.

Designed specifically for CLI tables, financial monitoring dashboards, and real-time metric trackers.

✨ Features

• Adaptive Terminal Detection: Automatically selects the best rendering protocol:
  • iTerm2 / WezTerm / Ghostty: Renders ultra-fine, anti-aliased 1-pixel inline graphics directly in a single text row.
  • Kitty: Uses Kitty graphics protocol.
  • Fallback / Standard Terminals: Gracefully degrades to smooth Unicode Braille vector curves (⡠⠤⠒⠊⠉) or classic Block bars ( ▂▃▅▇).
• Zero-Friction & Lightweight: Zero required dependencies (optional Pillow for inline images).
• Table Friendly: Easily embeds into Rich, Textual, tabulate, or raw terminal tables.
• CLI Utility: Ready to use as a standalone command-line tool.

📦 Installation

pip install term-sparkline[image]

(Without [image], it functions in pure-text Unicode Braille/Block mode with zero dependencies).

🚀 Quick Start

Python API

from term_sparkline import sparkline

prices = [10.2, 10.3, 10.1, 10.5, 10.8, 10.7, 11.2, 11.0, 11.5]

# Auto-detects terminal and renders inline sparkline
chart = sparkline(prices, length=12, color=(235, 87, 87))

print(f"600519 贵州茅台  1680.50  +2.15%  {chart}")

Integration with rich

from rich.table import Table
from rich.console import Console
from term_sparkline import sparkline

console = Console()
table = Table(title="Live Stock Watcher")

table.add_column("Symbol", justify="center")
table.add_column("Price", justify="right")
table.add_column("Change", justify="right")
table.add_column("Trend (Sparkline)", justify="left")

table.add_row("600519", "1680.50", "+2.15%", sparkline([10, 12, 11, 15, 18], color=(235, 87, 87)))
table.add_row("000001", "11.20", "-1.32%", sparkline([18, 16, 14, 12, 11], color=(46, 204, 113)))

console.print(table)

CLI Usage

# Pass numbers directly
sparkline 1 5 2 8 6 9 12 --red

# Or pipe from other tools
echo "10,12,11,15,18,22" | sparkline --green

📄 License

MIT