comfy-table

comfy-table is a Rust library focused on producing beautiful, readable terminal tables with minimal setup. It handles dynamic content arrangement based on available terminal width, ANSI styling (colors, bold, blinking), a set of built-in presets and modifiers (like UTF8 rounded corners), and fine-grained control over borders, padding, and per-cell or per-column alignment.

The project describes itself as functionally “finished” — it covers the planned feature set, has extensive test coverage, and is now in a feature freeze while its author looks for a new maintainer, with only bug fixes and dependency bumps continuing. It deliberately avoids scope creep (no nested tables, no cell spanning, no CSV conversion) to stay minimalistic and reliable, and disallows unsafe code in its own codebase (aside from one unavoidable terminal-size ioctl call in a dependency, guardable via force_no_tty).

What You Get

• Dynamic content arrangement that wraps table content to a given or detected terminal width
• ANSI styling support (colors, bold, blinking, backgrounds) via the Cell API
• Built-in style presets (e.g. UTF8_FULL) and modifiers (e.g. UTF8_ROUND_CORNERS) for quick styling
• Per-column and per-cell alignment and constraint controls
• Cross-platform terminal width detection (Linux, macOS, Windows) with a documented unsafe-free codebase

Common Use Cases

• Rendering structured CLI output (lists, reports, diagnostics) as readable terminal tables
• Building admin/inspection CLI tools that need styled, auto-wrapping tabular output
• Displaying colored, attribute-styled data in terminal dashboards or REPLs
• Replacing hand-rolled ASCII table formatting in Rust command-line tools

Under The Hood

Architecture: comfy-table centers on a Table struct that owns a header row and a set of data rows built from Cell values; content arrangement is computed dynamically (ContentArrangement::Dynamic) against either an explicitly set width or the terminal’s detected column count, with column-level constraints and alignment settings applied during that layout pass before rendering to a bordered string. Styling presets (UTF8_FULL) and modifiers (UTF8_ROUND_CORNERS) are applied as a separate step on top of the base table structure, keeping layout logic and visual styling as distinct concerns.

Tech Stack: Nearly pure Rust (99.7% of tracked bytes) with feature flags controlling optional functionality — tty (enabled by default) for terminal detection and ANSI styling via crossterm, custom_styling for raw ANSI passthrough (at a documented 30-50% performance cost), and reexport_crossterm for sharing crossterm’s own Color/Attribute types. The project explicitly documents and isolates its one unavoidable unsafe call (a terminal-size ioctl in a dependency), disallowing unsafe code in its own source.

Code Quality: The tests/ directory contains 20 test files with visual-comparison style tests for nearly every table feature, plus a benches/ directory using criterion for performance benchmarking (documented benchmark numbers — ~30μs to ~470μs for typical tables — are published directly in the README), and CI badges (GitHub Actions, codecov) confirm active test-and-coverage enforcement. With 25 contributors and 625 total commits across 39 tagged releases, the project has a long, well-documented maintenance history, though the author has explicitly announced a feature freeze while seeking a new maintainer.

API Design: The core API is a fluent builder pattern (Table::new().set_header(...).add_row(...)) that renders via Display/println!("{table}"), requiring only a handful of lines for a basic table, with styling, presets, and constraints layered on as additional chained calls only when needed — the README explicitly documents its own scope boundaries (no nested tables, no cell spanning) to keep this simplicity intact.