Esteja você instalando um software, carregando uma página ou fazendo uma transação, isso sempre acalma sua mente sempre que você vê aquela pequena barra de progresso que fornece uma estimativa de quanto tempo o processo levaria para ser concluído ou renderizado. Se você tem uma barra de progresso simples em seu script ou código, ela parece muito agradável e fornece um feedback adequado ao usuário sempre que ele executa o código. Você pode usar a biblioteca externa do Python tqdm , para criar barras de progresso simples e sem complicações que você pode adicionar ao seu código e torná-lo mais animado!

Instalação

Abra seu prompt de comando ou terminal e digite:

pip install tqdm

Se você estiver usando Python3, digite:

pip3 install tqdm

Este comando instalaria com sucesso a biblioteca em seu computador e agora está pronto para uso.

Uso

O uso tqdmé muito simples, você só precisa adicionar seu código tqdm()depois de importar a biblioteca em seu código. Você precisa ter certeza de que o código colocado entre a função tqdm() deve ser iterável ou não funcionaria de todo.



Vejamos o seguinte exemplo que o ajudará a entender melhor:

Exemplo:

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

Resultado:

python-tqdm

Agora que sabemos como implementar o tqdm, vamos dar uma olhada em alguns dos parâmetros importantes que ele oferece e como pode ser usado para ajustar a barra de progresso.

  • desc:
  • Você pode usar este parâmetro para especificar a descrição de sua barra de progresso da seguinte maneira:

    Sintaxe:

tqdm (self, iterable, desc = “Texto que você deseja”)

Exemplo:



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

Resultado:
python-tqdm

  • total: é usado para especificar o número total de iterações esperadas, caso ainda não tenha sido especificado ou precise de modificação.

    Sintaxe:

    tqdm (auto, iterável, total = 500)

    Exemplo:

    filter_none

    editar
    fechar

    play_arrow

    link
    brilho_4
    código

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

    Resultado:

    python-tqdm

  • desabilitar: Este parâmetro pode ser usado se você quiser desabilitar completamente a barra de progresso.

    Sintaxe:

    tqdm (self, iterable, disable = True)

    Exemplo:

    filter_none

    editar
    fechar

    play_arrow

    link
    brilho_4
    código

    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")
    chevron_right
    
    
    filter_none
    
    

    Resultado:



    python-tqdm

  • ncols: Este parâmetro é usado para especificar toda a largura da mensagem de saída. Se não for especificado, ele permanece dinâmico para o tamanho da janela. Isso pode ser corrigido por meio do ncolsparâmetro.

    Sintaxe:

    tqdm (self, iterable, ncols = 100)

    Exemplo:

    filter_none

    editar
    fechar

    play_arrow

    link
    brilho_4
    código

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

    Resultado:

    python-tqdm

  • mininterval: Você pode alterar facilmente a atualização mínima da exibição do progresso usando esta opção. O padrão é 0,1 segundos.

    Sintaxe:

    tqdm (self, iterable, mininterval = 3)

    Exemplo:

    filter_none

    editar
    fechar

    play_arrow

    link
    brilho_4
    código

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

    Resultado:



    python-tqdm

  • ascii: Você pode usar caracteres ASCII para preencher a barra de progresso de acordo com sua preferência.

    Sintaxe:

    tqdm (self, iterable, ascii = “123456789 $”, desc = ”Texto que você deseja”)

    Exemplo:

    filter_none

    editar
    fechar

    play_arrow

    link
    brilho_4
    código

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

    Resultado:

  • unidade: A unidade de tempo padrão é “it” e pode ser alterada usando este parâmetro para sua unidade preferida.

    Sintaxe:

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

    Exemplo:



    filter_none

    editar
    fechar

    play_arrow

    link
    brilho_4
    código

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

    Resultado:
    python-tqdm

  • inicial
    O valor inicial da barra de progresso começa em 0. Se você deseja mudar isso, você pode usar este parâmetro para inicializar a barra de progresso a partir do valor que você deseja
    Sintaxe:
    tqdm (auto, iterável, inicial = 50)

    Exemplo:

    filter_none

    editar
    fechar

    play_arrow

    link
    brilho_4
    código

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

    Resultado:

    python-tqdm

    O contador começaria em 50 e a barra de progresso desapareceria depois que o contador final fosse alcançado. O loop ainda será executado até que a iteração seja concluída.

    Atenção geek! Fortaleça suas bases com a Python Programming Foundation Course e aprenda o básico.

    Para começar, os preparativos para a entrevista Aprimore seus conceitos de Estruturas de Dados com o Curso Python DS .

    Minhas anotações pessoais arrow_drop_up