Rich & Textual

Rich hace que la salida de la terminal sea legible: colores, tablas, barras de progreso, tracebacks con resaltado de sintaxis. Textual se basa en Rich para crear interfaces de usuario de terminal (TUI) completas con widgets, diseños y eventos asíncronos. Juntos reemplazan la depuración frágil con print y el código repetitivo de curses.

Receta

from rich.console import Console
from rich.table import Table
 
console = Console()
table = Table(title="Estado de Despliegue")
table.add_column("Servicio")
table.add_column("Versión")
table.add_row("api", "2.1.0")
table.add_row("worker", "2.1.0")
console.print(table)

Cuándo usar esto:

• Herramientas CLI que los operadores ejecutan a diario (despliegue, migración, correcciones de datos)
• Scripts de larga duración que necesitan retroalimentación de progreso
• Paneles internos sin presupuesto para una interfaz web
• Salida de errores bonita durante el desarrollo local

Ejemplo Funcional

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("Procesando", 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]Hecho[/green]")
 
 
if __name__ == "__main__":
    process_jobs([Job("usuarios", 50), Job("pedidos", 30)])

Lo que esto demuestra:

• Console(stderr=True) mantiene stdout libre para canalizaciones (piping)
• Progress compone columnas para el spinner, etiqueta, barra y porcentaje
• La descripción de la tarea se actualiza por nombre de trabajo
• Marcado de color ([green]) sin códigos de escape manuales

Inmersión Profunda

Cómo Funciona

• Console - Detecta el ancho de la terminal, el soporte de color y la representación de emojis; retrocede elegantemente en los registros de CI.
• Marcado - Etiquetas de estilo [bold red]error[/]; console.print(obj) imprime bonitamente dataclasses y diccionarios.
• Pantalla en vivo - rich.live.Live actualiza tablas o registros en el lugar sin parpadeos.
• Textual - Framework TUI basado en eventos; las aplicaciones heredan de App, definen compose() para widgets, manejan on_button_pressed, etc.

Rich vs Textual

Notas de Python

# Instala tracebacks de Rich globalmente en un punto de entrada CLI
from rich.traceback import install
install(show_locals=True)
 
# Esqueleto mínimo de aplicación 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("Hola desde Textual")
        yield Footer()
 
if __name__ == "__main__":
    HelloApp().run()

Trampas Comunes

• Imprimir tablas en stdout en CLIs canalizadas - Rompe jq o grep posteriores. Solución: Console(file=sys.stderr) para salida humana.
• Asumir color en CI - Algunos ejecutores eliminan ANSI. Solución: Console(force_terminal=True) solo cuando sea necesario; probar en modo plano.
• Textual sin disciplina asíncrona - Bloquear time.sleep en manejadores congela la interfaz de usuario. Solución: await asyncio.sleep o run_worker.
• Tablas enormes en terminales estrechas - Las columnas se truncan de forma confusa. Solución: table.add_column(..., overflow="fold") o exportar CSV.
• Rich en código de biblioteca incondicionalmente - Fuerza Rich como una dependencia dura para los consumidores. Solución: salida bonita opcional detrás de un indicador --verbose.
• Duplicación de manejadores de registro - LoggingHandler de Rich más un manejador stdlib duplica las líneas. Solución: configurar un árbol de manejadores.

Alternativas

Preguntas Frecuentes

Relacionado

• Conceptos Básicos de Herramientas CLI - puntos de entrada de argparse/typer
• Conceptos Básicos de Errores y Registro - patrones de registro estructurado
• Configuración de pytest - pruebas de herramientas CLI
• Productividad del Shell - flujo de trabajo de terminal

Versiones de Stack: Esta página fue escrita para Python 3.14.0 (estable 3.14, mantenimiento 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+, y uv 0.6+.