gilt

Rich terminal formatting for Rust -- a port of Python's rich library.

gilt brings beautiful terminal output to Rust with styles, tables, trees, syntax highlighting, progress bars, and more -- all rendered as ANSI escape sequences.

Quick Start

[dependencies]
gilt = "0.5"

use gilt::prelude::*;

fn main() {
    let mut console = Console::new();
    console.print_text("Hello, [bold magenta]gilt[/bold magenta]!");
}

v0.5.0 Highlights

• 7 derive macros -- #[derive(Table, Panel, Tree, Columns, Rule, Inspect, Renderable)]
• Sparkline -- inline Unicode bar charts (▁▂▃▄▅▆▇█)
• Canvas -- Braille dot-matrix drawing (lines, rects, circles)
• Diff -- LCS-based unified and side-by-side text diffs
• Figlet -- large ASCII art text with built-in 5×7 block font
• CsvTable -- CSV-to-Table with built-in parser and optional csv crate
• 73 examples covering all features

Features

Core Widgets

• Text -- Rich text with markup, styles, wrapping, alignment
• Table -- Unicode box-drawing tables with column alignment and row striping
• Panel -- Bordered content panels with titles
• Tree -- Hierarchical tree display with guide lines
• Columns -- Multi-column layout
• Layout -- Flexible split-pane layouts

Terminal Features

• Syntax -- Code highlighting via syntect (150+ languages)
• Markdown -- Terminal-rendered Markdown
• JSON -- Pretty-printed JSON with highlighting
• Progress -- Multi-bar progress display with ETA, speed, spinner
• Live -- Live-updating terminal display
• Status -- Spinner with status message

Rust-Native Extensions

• Gradients -- True-color RGB gradient text
• Sparkline -- Inline Unicode bar charts
• Canvas -- Braille dot-matrix drawing with line, rect, circle primitives
• Diff -- Unified and side-by-side text diffs with colored output
• Figlet -- Large ASCII art text rendering
• CsvTable -- CSV to rich Table conversion
• Stylize trait -- "hello".bold().red() method chaining
• Iterator progress -- iter.progress() adapter
• #[derive(Table, Panel, Tree, Columns, Rule, Inspect, Renderable)] -- Auto-generate widgets from structs
• Environment detection -- NO_COLOR, FORCE_COLOR, CLICOLOR support
• Inspect -- Debug any value with rich formatting
• Accessibility -- WCAG 2.1 contrast checking, REDUCE_MOTION detection
• Extended underlines -- Curly, dotted, dashed, double styles with color
• anstyle interop -- Bidirectional conversion with anstyle types

Integrations

• miette -- Diagnostic reporting with gilt styling
• eyre -- Error reporting with gilt styling
• tracing -- Log subscriber with colored output
• anstyle -- Convert between gilt and anstyle Color/Style types

Feature Gates

All four heavy dependencies are default-on. Disable them for minimal builds:

# Full (default) -- includes json, markdown, syntax, interactive
gilt = "0.5"

# Minimal -- no heavy deps
gilt = { version = "0.5", default-features = false }

# Pick what you need
gilt = { version = "0.5", default-features = false, features = ["json", "syntax"] }

Examples

# Showcase (runs all major widgets)
cargo run --example showcase --all-features

# Core widgets
cargo run --example table
cargo run --example panel
cargo run --example syntax
cargo run --example progress
cargo run --example markdown

# Rust-native features
cargo run --example gradient
cargo run --example inspect_demo
cargo run --example styled_string
cargo run --example sparkline

# Feature-gated examples
cargo run --example derive_table --features derive
cargo run --example derive_panel --features derive
cargo run --example derive_tree --features derive
cargo run --example derive_rule --features derive
cargo run --example derive_inspect --features derive
cargo run --example miette_demo --features miette
cargo run --example tracing_demo --features tracing

See the examples/ directory for all 73 examples.

Global Console

// Print with markup
gilt::print_text("Hello, [bold]world[/bold]!");

// Print JSON
gilt::print_json(r#"{"name": "gilt"}"#);

// Inspect any Debug value
gilt::inspect(&vec![1, 2, 3]);

Performance

gilt includes a criterion benchmark suite (64 benchmarks) covering text rendering, style application, table layout, segment operations, and more:

cargo bench

Minimum Supported Rust Version

gilt requires Rust 1.82.0 or later (for std::sync::LazyLock).

License

MIT