Fast-Rich¶

High-performance Rust port of Python's Rich library

Beautiful terminal formatting for Rust applications

What is Fast-Rich?¶

Fast-Rich brings the power of Python's popular Rich library to Rust, enabling you to create beautiful, colorful terminal output with minimal effort.

Fast-Rich Hero

See it in Action¶

Below is a demonstration of all library features running in sequence, including tables, panels, progress bars, and live displays:

Fast-Rich Examples

Alpha Status

This project is currently in Alpha. APIs may change and some features may be incomplete.

✨ Features¶

:material-palette:{ .lg .middle } Rich Text & Styles

Bold, italic, underline, colors (8/256/RGB), and markup syntax
```
console.print("[bold red]Error:[/] failed");
```
:material-table:{ .lg .middle } Tables

Unicode borders, auto-sizing columns, custom styles
```
table.add_column("Name");
table.add_row_strs(&["Alice"]);
```
:material-progress-check:{ .lg .middle } Progress Bars

Multi-task progress, spinners, ETA, customizable columns
```
let task = progress.add_task("Loading", Some(100));
progress.advance(task, 10);
```
:material-refresh:{ .lg .middle } Live Display

Flicker-free auto-updating content for dashboards
```
live.update(panel);
live.refresh()?;
```
:material-code-tags:{ .lg .middle } Syntax Highlighting

Code highlighting with multiple themes via syntect
```
let syntax = Syntax::new(code, "rust");
console.print_renderable(&syntax);
```
:material-language-markdown:{ .lg .middle } Markdown

Render Markdown directly in the terminal
```
let md = Markdown::new("# Hello");
console.print_renderable(&md);
```
:material-file-tree:{ .lg .middle } Tree Views

Hierarchical data visualization with customizable guides
```
let mut tree = Tree::new(Text::plain("Root"));
tree.add("Child");
```
:material-view-dashboard:{ .lg .middle } Layouts

Split screens and complex terminal layouts
```
layout.split_row(vec![left, right]);
```

Quick Start¶

Add fast-rich to your Cargo.toml:

[dependencies]
fast-rich = "0.2.0"

Then create beautiful terminal output:

use fast_rich::prelude::*;

fn main() {
    let console = Console::new();

    // Styled text with markup
    console.print("[bold red]Hello[/] [blue]World[/]!");

    // Create a table
    let mut table = Table::new();
    table.add_column("Feature");
    table.add_column("Status");
    table.add_row_strs(&["Rich Text", "✅ Ready"]);
    table.add_row_strs(&["Tables", "✅ Ready"]);

    console.print_renderable(&table);
}

Output:

Hello World!
╭─────────────┬──────────╮
│ Feature     │ Status   │
├─────────────┼──────────┤
│ Rich Text   │ ✅ Ready │
│ Tables      │ ✅ Ready │
╰─────────────┴──────────╯

Feature Comparison¶

Feature	Python Rich	Fast-Rich
Rich Text & Styles	✅	✅
Tables	✅	✅
Progress Bars	✅	✅
Live Display	✅	✅
Syntax Highlighting	✅	✅
Markdown	✅	✅
Tree Views	✅	✅
Layouts	✅	✅
Tracebacks	✅	✅
Logging Handler	✅	✅

Next Steps¶

:material-rocket-launch:{ .lg .middle } Getting Started

Installation and first steps
:material-book-open-variant:{ .lg .middle } Guides

Detailed feature documentation
:material-code-braces:{ .lg .middle } Examples

Runnable example programs
:material-api:{ .lg .middle } API Reference

Full API documentation