willmcgugan/rich
Rich
Rich is a Python terminal formatting library and user interface framework. It provides tools for rendering rich text, colors, and complex layouts within a terminal environment, including specialized formatters for markdown and source code syntax highlighting.
The library distinguishes itself through high-level UI components such as tables with unicode borders, hierarchical tree views for nested data structures, and a system for building structured terminal user interfaces. It also includes a debugging visualizer for pretty-printing complex data and formatting error tracebacks.
The capability surface covers data visualization via progress bars and activity spinners, as well as observability tools for object inspection and terminal log formatting. Layout management is handled through columnar content arrangement and emoji support.
Features
- Terminal Formatting Libraries - Renders rich text, colors, and complex layouts within a Python terminal environment.
- Console Rendering Engines - Implements a rendering engine that maps state and layouts to terminal output buffers for flicker-free updates.
- Terminal Output Stylers - Applies colors, word-wrapping, and ANSI escape sequences to organize and style terminal output.
- Terminal UI Frameworks - Ships a full component-based framework for building tables, progress bars, and tree views in the terminal.
- ANSI Escape Sequence Renderers - Provides the core engine that generates raw ANSI escape sequences for terminal text coloring and movement.
- Terminal User Interfaces - Provides a comprehensive framework for building and styling interactive text-based interfaces within a terminal environment.
- Text Formatting - Renders rich text and diverse formatting styles to improve the presentation of information in the terminal.
- UI Components - Provides high-level UI components like tables, progress bars, and trees for building structured terminal interfaces.
- Terminal Renderers - Translates markdown syntax into styled sequences of text objects for formatted console output.
- Markdown Renderers - Converts markdown text into formatted terminal output with specialized styles for headings and lists.
- Terminal Renderers - Converts markdown text into formatted terminal output with styles for headings and lists.
- Data Pretty Printers - Formats and highlights nested data structures for human-readable terminal output.
- Terminal Tables - Creates tables with unicode borders and automatic column resizing to fit the terminal width.
- Data Structure Visualizers - Pretty-prints complex data structures and formats error tracebacks to improve readability during debugging.
- Debugging and Inspection Tools - Enhances the debugging process with formatted tracebacks, pretty-printing of complex objects, and state inspection.
- Task Progress Indicators - Maintains counters and timestamps to calculate real-time completion percentages and estimated time remaining.
- Terminal Syntax Highlighters - Applies color themes and language-specific highlighting to source code output in terminal environments.
- Data Visualization Components - Provides a suite of components for representing structured data and progress through tables, bars, and spinners.
- Terminal User Interface Tooling - Offers a framework for building professional CLI tools with syntax highlighting and formatted logs.
- Hierarchical Tree Visualizers - Renders hierarchical tree views with guiding lines to represent nested data structures or file systems.
- Exception Formatting - Transforms raw error tracebacks into readable, highlighted reports to simplify the debugging process.
- Tree Visualizers - Renders nested data structures as hierarchical trees with indentation and guiding lines.
- Visual Progress Indicators - Rich library capability to display flicker-free progress bars with percentage completion and estimated time remaining metrics.
- Columnar Layouts - Organizes text into columns of equal or optimal width for directory listings and structured data.
- Progress Bars - Provides visual linear indicators to track the completion status of long-running tasks.
- Indeterminate Indicators - Implements spinner animations and custom messages to indicate background work during indeterminate tasks.
- Syntax Highlighting - Applies language-specific color coding to source code to improve readability within the console.
- Terminal UI Tools - Library for rich text and beautiful formatting in terminals.
- TUI Libraries - Formatting and rich text library for Python.
