Rich & Textual

Rich torna a saída do terminal legível - cores, tabelas, barras de progresso, tracebacks com realce de sintaxe. Textual é construído sobre Rich para criar interfaces de usuário de terminal (TUIs) completas com widgets, layouts e eventos assíncronos. Juntos, eles substituem a depuração print frágil e o boilerplate do curses.

Receita

from rich.console import Console
from rich.table import Table
 
console = Console()
table = Table(title="Status da Implantação")
table.add_column("Serviço")
table.add_column("Versão")
table.add_row("api", "2.1.0")
table.add_row("worker", "2.1.0")
console.print(table)

Quando usar isso:

• Ferramentas de CLI que os operadores executam diariamente (implantação, migração, correções de dados)
• Scripts de longa duração que precisam de feedback de progresso
• Dashboards internos sem orçamento para interface web
• Saída de erro bonita durante o desenvolvimento local

Exemplo de Trabalho

from __future__ import annotations
 
import time
from dataclasses import dataclass
 
from rich.console import Console
from rich.progress import Progress, SpinnerColumn, TextColumn, BarColumn, TaskProgressColumn
 
 
@dataclass
class Job:
    name: str
    rows: int
 
 
def process_jobs(jobs: list[Job]) -> None:
    console = Console(stderr=True)
    with Progress(
        SpinnerColumn(),
        TextColumn("[bold blue]{task.description}"),
        BarColumn(),
        TaskProgressColumn(),
        console=console,
    ) as progress:
        task_id = progress.add_task("Processando", total=sum(j.rows for j in jobs))
        for job in jobs:
            progress.update(task_id, description=job.name)
            for _ in range(job.rows):
                time.sleep(0.01)
                progress.advance(task_id)
    console.print("[green]Concluído[/green]")
 
 
if __name__ == "__main__":
    process_jobs([Job("users", 50), Job("orders", 30)])

O que isso demonstra:

• Console(stderr=True) mantém o stdout livre para piping
• Progress compõe colunas para spinner, rótulo, barra e porcentagem
• A descrição da tarefa é atualizada por nome de trabalho
• Marcação de cor ([green]) sem códigos de escape manuais

Mergulho Profundo

Como Funciona

• Console - Detecta a largura do terminal, suporte a cores e renderização de emojis; degrada graciosamente em logs de CI.
• Marcação - Tags no estilo [bold red]erro[/]; console.print(obj) imprime de forma bonita dataclasses e dicionários.
• Exibição ao vivo - rich.live.Live atualiza tabelas ou logs no local sem piscar.
• Textual - Framework TUI orientado a eventos; aplicativos herdam de App, definem compose() para widgets, lidam com on_button_pressed etc.

Rich vs Textual

Notas de Python

# Instala tracebacks Rich globalmente em um ponto de entrada de CLI
from rich.traceback import install
install(show_locals=True)
 
# Esqueleto mínimo de aplicativo Textual
from textual.app import App, ComposeResult
from textual.widgets import Header, Footer, Static
 
class HelloApp(App):
    def compose(self) -> ComposeResult:
        yield Header()
        yield Static("Olá do Textual")
        yield Footer()
 
if __name__ == "__main__":
    HelloApp().run()

Armadilhas

• Imprimir tabelas no stdout em CLIs com pipe - Interrompe jq ou grep downstream. Correção: Console(file=sys.stderr) para saída humana.
• Assumir cor em CI - Alguns runners removem ANSI. Correção: Console(force_terminal=True) apenas quando necessário; teste em modo simples.
• Textual sem disciplina assíncrona - time.sleep bloqueante em manipuladores congela a UI. Correção: await asyncio.sleep ou run_worker.
• Tabelas enormes em terminais estreitos - As colunas são truncadas de forma confusa. Correção: table.add_column(..., overflow="fold") ou exportar CSV.
• Rich em código de biblioteca incondicionalmente - Força Rich como uma dependência rígida para os consumidores. Correção: saída bonita opcional por trás de uma flag --verbose.
• Duplicação de manipulador de log - LoggingHandler do Rich mais um manipulador stdlib duplica linhas. Correção: configure uma árvore de manipuladores.

Alternativas

FAQs

Relacionados

• Noções Básicas de Ferramentas CLI - pontos de entrada argparse/typer
• Noções Básicas de Erros e Logging - padrões de log estruturado
• Configuração do pytest - testando ferramentas CLI
• Produtividade do Shell - fluxo de trabalho do terminal

Versões da Stack: Esta página foi escrita para Python 3.14.0 (estável 3.14, manutenção 3.13), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+, e uv 0.6+.