Python | Cómo hacer una barra de progreso de terminal usando tqdm

Ya sea que esté instalando software, cargando una página o realizando una transacción, siempre se tranquiliza cada vez que ve esa pequeña barra de progreso que le brinda una estimación de cuánto tiempo tardará el proceso en completarse o procesarse. Si tiene una barra de progreso simple en su secuencia de comandos o código, se ve muy agradable a la vista y brinda una respuesta adecuada al usuario cada vez que ejecuta el código. Puede usar la biblioteca externa de Python tqdm para crear barras de progreso simples y sin complicaciones que puede agregar a su código y hacer que se vea animado.
 

Instalación

Abra su símbolo del sistema o terminal y escriba: 
 

pip install tqdm

Si está utilizando Python3, escriba: 
 

pip3 install tqdm

Este comando instalaría con éxito la biblioteca en su computadora y ahora está lista para usar.
 

Uso

Usar tqdm es muy simple, solo necesita agregar su código entre tqdm() después de importar la biblioteca en su código. Debe asegurarse de que el código que coloca entre la función tqdm() debe ser iterable o no funcionará en absoluto.
Veamos el siguiente ejemplo que te ayudaría a entender mejor:
Ejemplo:
 

from tqdm import tqdm
 
 
for i in tqdm(range(int(9e6))):
    pass

Producción:
 

Ahora que sabemos cómo implementar tqdm, echemos un vistazo a algunos de los parámetros importantes que ofrece y cómo se puede utilizar para modificar la barra de progreso. 
 

• desc: Puede usar este parámetro para especificar la descripción de su barra de progreso de la siguiente manera:
  Sintaxis:

tqdm (self, iterable, desc= “Text You want”)

Ejemplo: 

from tqdm import tqdm
from time import sleep
 
 
for i in tqdm(range(0, 100), desc ="Text You Want"):
    sleep(.1)

Producción: 
 

• total: Esto se usa para especificar el número total de iteraciones esperadas si no se ha especificado ya o necesita modificación.
  Sintaxis: 

tqdm (self, iterable, total= 500)

Ejemplo:

from tqdm import tqdm
from time import sleep
 
 
for i in tqdm(range(0, 100), total = 500,
              desc ="Text You Want"):
    sleep(.1)

Producción:
 

• deshabilitar: este parámetro se puede usar si desea deshabilitar completamente la barra de progreso.
  Sintaxis:

tqdm (self, iterable, disable=True)

Ejemplo: 

from tqdm import tqdm
from time import sleep
 
 
for i in tqdm(range(0, 100), disable = True,
               desc ="Text You Want"):
    sleep(.1)
 
print("Iteration Successful")

Producción:
 

• ncols: este parámetro se utiliza para especificar el ancho total del mensaje de salida. Si no se especifica, permanece dinámico al tamaño de la ventana. Esto se puede arreglar a través del parámetro ncols.
  Sintaxis: 

tqdm (self, iterable, ncols= 100)

Ejemplo:

from tqdm import tqdm
from time import sleep
 
 
for i in tqdm(range(0, 100), ncols = 100,
               desc ="Text You Want"):
    sleep(.1)

Producción:

• mininterval: puede cambiar fácilmente la actualización de la pantalla de progreso mínimo usando esta opción. El valor predeterminado es 0,1 segundos.
  Sintaxis:

tqdm (self, iterable, mininterval=3)

Ejemplo:

from tqdm import tqdm
from time import sleep
 
 
for i in tqdm(range(0, 100), mininterval = 3,
              desc ="Text You Want"):
    sleep(.1)

Producción:
 

• ascii: puede usar caracteres ASCII para llenar la barra de progreso según su gusto. 
  Sintaxis:

tqdm (self, iterable, ascii= “123456789$”, desc=”Texto que desea”)

Ejemplo:

from tqdm import tqdm
from time import sleep
 
 
for i in tqdm(range(0, 100),
              ascii ="123456789$"):
    sleep(.1)

Producción:

• unidad: La unidad de tiempo predeterminada es «it» y se puede cambiar usando este parámetro a su unidad preferida.
  Sintaxis:

tqdm (self, iterable, unit= “ ticks”)

Ejemplo: 

from tqdm import tqdm
from time import sleep
 
 
for i in tqdm(range(0, 100), unit =" ticks",
              desc ="Text You Want"):
    sleep(.1)

Producción: 
 

• initial 
  El valor inicial de la barra de progreso comienza desde 0. Si desea cambiar esto, puede usar este parámetro para inicializar la barra de progreso desde el valor que desee. 
  Sintaxis:

tqdm (self, iterable, initial=50)

Ejemplo:

from tqdm import tqdm
from time import sleep
 
 
for i in tqdm(range(0, 100), initial = 50,
              desc ="Text You Want"):
    sleep(.1)

Producción:
 

El contador comenzaría desde 50 y la barra de progreso desaparecería después de llegar al contador final. El bucle aún se ejecutaría hasta que se complete la iteración.