En este artículo, aprenderemos sobre una poderosa biblioteca para Python llamada Rich .

Rich es una biblioteca de Python para escribir texto enriquecido (con color y estilo) en la terminal. Le permite mostrar contenido avanzado, como tablas, marcado y código resaltado por sintaxis.

Entonces, ¿por qué es esto útil? Bueno, si no estás usando una herramienta como Rich, la salida de tu código en la terminal puede ser un poco aburrida y difícil de entender. Si desea hacerlo más claro y bonito, probablemente quiera usar Rich, y ha venido al lugar correcto para aprender cómo hacerlo.

Cómo instalar Rich

Puede instalar Rich con pip como:

pip install Rich

Para saber lo que puede hacer todo Rich, puedes escribir el siguiente comando en la terminal:

python -m rich

Ahora puedes ver que podemos hacer muchas cosas con Rich. Probemos algunos de ellos para ver cómo funcionan.

Cómo imprimir valores enriquecidos en Python

Rich tiene la capacidad de resaltar la salida según el tipo de datos. Importaremos la printfunción alternativa de la biblioteca Rich que toma los mismos argumentos que el print.

Para evitar confusiones con la función print integrada, importaremos printdesde la bibliotecarich como rprint.

from rich import print as rprint

nums_list = [1, 2, 3, 4]rprint(nums_list)

nums_tuple = (1, 2, 3, 4)rprint(nums_tuple)

nums_dict = {'nums_list': nums_list, 'nums_tuple': nums_tuple}rprint(nums_dict)

bool_list = [True, False]rprint(bool_list)

Producción:

¿Ves cómo los diferentes tipos de datos se resaltan con diferentes colores? Esto puede ayudarnos mucho durante la depuración.

Cómo realizar una inspección enriquecida en Python

Si usa la help función incorporada para ver la documentación de una biblioteca, verá un resultado aburrido.

import rich

print(help(rich))

Producción:

Rich tiene una [**inspect()**](https://rich.readthedocs.io/en/stable/reference/init.html#rich.inspect)función que puede generar un informe sobre cualquier objeto de Python. Es una fantástica ayuda para la depuración y un buen ejemplo de la salida que Rich puede generar.

from rich import inspectimport rich

inspect(rich)

Producción:

Cómo diseñar tu consola con Rich

Para un control completo sobre el formato de la terminal, Rich ofrece una Clase[**Console**](https://rich.readthedocs.io/en/stable/reference/console.html#rich.console.Console).

Escribamos una función para fusionar los diccionarios de Python .

from rich.console import Console

console = Console()

def merge_dict(dict_one, dict_two):    merged_dict = dict_one | dict_two    console.log(merged_dict, log_locals=True)

merge_dict({'id': 1}, {'name': 'Ashutosh'})

Producción:

En el ejemplo anterior, hemos utilizado el [**log**](https://rich.readthedocs.io/en/stable/console.html#logging) método que ofrece las mismas capacidades que la impresión, pero agrega algunas funciones útiles para depurar una aplicación en ejecución.

Hay varios otros métodos como [print](https://rich.readthedocs.io/en/stable/console.html#printing), [print_json](https://rich.readthedocs.io/en/stable/console.html#printing-json), [out](https://rich.readthedocs.io/en/stable/console.html#low-level-output), [rule](https://rich.readthedocs.io/en/stable/console.html#rules), etc. Obtenga más información sobre ellos aquí .

Cómo usar Tree en Rich

Rich tiene una clase[**Tree**](https://rich.readthedocs.io/en/stable/reference/tree.html#rich.tree.Tree) que puede generar una vista de árbol en la terminal. Una vista de árbol es una excelente manera de presentar el contenido de un sistema de archivos o cualquier otro dato jerárquico. Cada rama del árbol puede tener una etiqueta que puede ser texto o cualquier otro renderizado enriquecido.

Veamos un ejemplo creando un árbol genealógico:

from rich.tree import Treefrom rich import print as rprint

tree = Tree("Family Tree")tree.add("Mom")tree.add("Dad")tree.add("Brother").add("Wife")tree.add("[red]Sister").add("[green]Husband").add("[blue]Son")

rprint(tree)

Producción:

Una vez que creamos una instancia de la **Tree**clase, podemos usar el **add()**método para agregarle ramas. Para crear un árbol complejo, solo usa el **add()**método para agregarle más ramas. Observe la rama Hermano y Hermana en el ejemplo anterior.

En la documentación oficial, tenemos un archivo tree.py que genera la estructura del archivo usando Tree. La salida se ve así:

Cómo mostrar una barra de progreso usando Rich

Rich puede mostrar información continuamente actualizada sobre el estado de las tareas de ejecución prolongada, copias de archivos, etc. También puede personalizar esta información. De forma predeterminada, proporciona una descripción de la ‘tarea’, una barra de progreso, el porcentaje completado y el tiempo restante anticipado.

Se admiten múltiples tareas con una rica pantalla de progreso, cada una con una barra y estadísticas de progreso. Puede usar esto para realizar un seguimiento de varios trabajos en los que se está trabajando en procesos o subprocesos.

Primero probemos el método progress.track para crear la barra de progreso.

from rich.progress import trackfrom time import sleep

def process_data():    sleep(0.02)

for _ in track(range(100), description='[green]Processing data'):    process_data()

Producción:

Si queremos registrar la hora en que se termina de ejecutar una tarea en particular, podemos usarla en su lugarconsole.status.

from rich.console import Consolefrom time import sleep

console = Console()

data = [1, 2, 3, 4, 5]with console.status("[bold green]Fetching data...") as status:    while data:        num = data.pop(0)        sleep(1)        console.log(f"[green]Finish fetching data[/green] {num}")

    console.log(f'[bold][red]Done!')

Puede trabajar directamente con la clase Progreso si necesita varias tareas en la pantalla o desea personalizar las columnas en la pantalla de progreso. Después de haber creado un objeto de Progreso, use ( add_task()) para agregar tareas y ( update_progress()) para actualizar el progreso.

La clase Progress está diseñada para usarse como un administrador de contexto, iniciando y deteniendo automáticamente la visualización del progreso.

import time

from rich.progress import Progress

with Progress() as progress:

    task1 = progress.add_task("[red]Downloading...", total=100)    task2 = progress.add_task("[green]Processing...", total=100)    task3 = progress.add_task("[cyan]Installing...", total=100)

    while not progress.finished:        progress.update(task1, advance=0.9)        progress.update(task2, advance=0.6)        progress.update(task3, advance=0.3)        time.sleep(0.02)

Producción:

Cómo mostrar columnas enriquecidas en Python

Rich puede representar texto u otros elementos de Rich en columnas ordenadas con la clase[**Columns**](https://rich.readthedocs.io/en/stable/reference/columns.html#rich.columns.Columns). Para usar, construya una instancia de Columns con una iteración de renderizables e imprímala en la Consola.

import jsonfrom urllib.request import urlopen

from rich.console import Consolefrom rich.columns import Columnsfrom rich.panel import Panel

def get_content(user):    """Extract text from user dict."""    country = user["location"]["country"]    name = f"{user['name']['first']} {user['name']['last']}"    return f"[b]{name}[/b]\n[yellow]{country}"

console = Console()

users = json.loads(urlopen("https://randomuser.me/api/?results=30").read())["results"]user_renderables = [Panel(get_content(user), expand=True) for user in users]console.print(Columns(user_renderables))

Producción:

Cómo mostrar tablas enriquecidas en Python

La clase de Rich [**Table**](https://rich.readthedocs.io/en/stable/reference/table.html#rich.table.Table)ofrece una variedad de formas de representar datos tabulares en la terminal. Esta clase tiene métodos **add_column()**para **add_row()**agregar columnas y filas respectivamente a la instancia de la tabla creada a partir de la Clase**Table**.

Vamos a crear una tabla para nuestra lista de tareas pendientes. Esta tabla tendrá tres columnas: S.No. , Tarea y Estado .

from rich.console import Consolefrom rich.table import Table

table = Table(title="Todo List")

table.add_column("S. No.", style="cyan", no_wrap=True)table.add_column("Task", style="magenta")table.add_column("Status", justify="right", style="green")

table.add_row("1", "Buy Milk", "✅")table.add_row("2", "Buy Bread", "✅")table.add_row("3", "Buy Jam", "❌")

console = Console()console.print(table)

Producción:

Terminando

En este tutorial, aprendimos a usar Rich para embellecer la terminal. Hay muchas otras funciones compatibles con Rich. Obtenga más información sobre ellos en la documentación oficial .