228

When using the tqdm progress bar: can I add a message to the same line as the progress bar in a loop?

I tried using the "tqdm.write" option, but it adds a new line on every write. I would like each iteration to show a short message next to the bar, that will disappear in the next iteration. Is this possible?

8 Answers 8

414

The example shown in Usage of tqdm works well for me.

pbar = tqdm(["a", "b", "c", "d"])
for char in pbar:
    pbar.set_description("Processing %s" % char)

Or alternatively, starting Python 3.8 which supports the walrus operator :=:

for char in (pbar := tqdm(["a", "b", "c", "d"])):
    pbar.set_description(f"Processing {char}")
8
  • 40
    Must be marked as correct answer. It is much easier and cleaner than @gabarous's
    – QtRoS
    Apr 18, 2018 at 12:02
  • 1
    This works, yet it may seem as if the semantics of set_description are for a description of the entire loop, whereas the example and/or original question imply status update semantics.
    – matanster
    May 3, 2019 at 9:44
  • 1
    My messages are pretty long and printing them in the same line with the pbar changes the pbar length every time and does not seem so sexy... So how could I print the message in the line below or above the progress bar?
    – Behnam
    Jul 3, 2019 at 9:12
  • 4
    @Benham use tqdm.write
    – jayelm
    Jan 9, 2020 at 1:05
  • 3
    @QtRoS This is essentially the same answer, except for one major missing step: pbar.refresh(). Indeed, the set_description() method is not meant to be used in an updating loop, it's a way to dynamically set the bar's description after it's already created. refresh() ensures the new description will be shown asap, and not wait for the next iteration which may take a while depending on your application. Also this answer is missing the import statements.
    – gaborous
    Dec 23, 2020 at 2:17
151

You can change the description to show a small message before the progress bar, like this:

from tqdm import trange
from time import sleep
t = trange(100, desc='Bar desc', leave=True)
for i in t:
    t.set_description("Bar desc (file %i)" % i)
    t.refresh() # to show immediately the update
    sleep(0.01)

/EDIT: in the latest releases of tqdm, you can use t.set_description("text", refresh=True) (which is the default) and remove t.refresh() (thanks to Daniel for the tip).

2
  • 4
    What is the leave=True argument doing? Sep 11, 2019 at 17:01
  • 3
    @EduardoPignatelli it leaves the progress bar printed after reaching completion. Otherwise, tqdm cleans up the progress bar from the console output (or any sys.stdout in general if it supports a way of cleaning).
    – gaborous
    Sep 13, 2019 at 11:14
138

Other answers focus on dynamic description, but for a static description you can add a desc argument into the tqdm function.

from tqdm import tqdm

x = [5]*1000
for _ in tqdm(x, desc="Example"):
    pass
 
Example: 100%|██████████████████████████████████| 1000/1000 [00:00<00:00, 1838800.53it/s]
5
  • 4
    @Mark What if desc is dynamic and only derived within each iteration?
    – jtlz2
    Jun 30, 2021 at 8:34
  • That is what the set_description approach many of the other answers are suggesting is for. This answer is for the static case.
    – WolfLink
    Nov 30, 2022 at 8:42
  • dynamically deriving desc works as of python 3.8.13. just use it like this: for i in tqdm(range(100), desc=f'Processing {i}'): pass Dec 10, 2022 at 3:25
  • @NasheedYasin: that can't possibly work, because the i in the f-string is bound before the loop is entered.
    – Eric
    Feb 20 at 1:03
  • @Eric thanks for pointing it out. It won't indeed work. Should I delete my previous comment as it may mislead? Feb 21 at 2:43
91

You can use set_postfix to add values directly to the bar.

Example:

from tqdm import tqdm
pbar = tqdm(["a", "b", "c", "d"])
num_vowels = 0
for ichar in pbar:
    if ichar in ['a','e','i','o','u']:
        num_vowels += 1
    pbar.set_postfix({'num_vowels': num_vowels})

The postfix dictionary is integrated into the progress bar:

100%|███████████| 4/4 [00:11<00:00,  2.93s/it, num_vowels=1]

Instead of a dictionary, you can use set_postfix_str to just add a string to the end of the progress bar.

1
7

I personally find it much cleaner to use the with statement:

from tqdm import tqdm

with tqdm(['a','b','c']) as t:
  for c in t:
    t.set_description(f'{c}')
2
  • 1
    True, but it adds another level of indentation, which might be undesirable if you're doing a lot inside the loop. In such a case, I'd rather create t = tqdm(['a','b','c']) first and then perform the loop.
    – cbrnr
    Jun 10, 2021 at 6:24
  • 1
    Or for c in (t := tqdm(my_list)):
    – Tim MB
    Jan 4 at 20:00
6

Although all the answers here are correct, tqdm also provides a set_postfix_str method. The advantage over set_postfix is that you can pass your own formatted string in place of key value pairs. Also set_postfix sorts the key value pairs alphabetically. Here is an MWE.

from tqdm import tqdm
import numpy as np

loop_obj = tqdm(np.arange(10))

for i in loop_obj:
    loop_obj.set_description(f"Count: {i}")  # Adds text before progessbar
    loop_obj.set_postfix_str(f"Next count: {i+1}")  # Adds text after progressbar
3

I personally use .set_description() and a progression_bar assignment statement before the for loop:

from tqdm import tqdm

progression_bar = tqdm(["An", "iterable", "object"])
for element in (progression_bar):
    progression_bar.set_description("Processing « %s »" % str(element))
0

When using the tqdm progress bar in Python, there are different ways to define it, either by using the with statement or by assigning the progress bar to a variable with tqdm() function. In some cases, you may want to update the progress bar inside the loop without adding an extra indentation layer.

To achieve this, you can use the set_postfix() method to update the progress bar with the latest information. To avoid adding an extra indentation layer, you can define the progress bar outside of the loop and use it inside the loop. For example, you can use the enumerate() function to iterate over a list while keeping track of the index, and then pass this to the progress bar like this:

from tqdm import tqdm

object_list = ["a", "b", "c"]

pbar = tqdm(enumerate(object_list), descr="...")
for i, obj in pbar:
    ...
    pbar.set_postfix("foo")
    ...
    pbar.set_postfix("bar")

In this way, you define the tqdm progress bar before the loop, and then you can use the set_postfix() method to update the progress bar inside the loop without adding an extra indentation layer. By using the enumerate() function, you also have access to the current index, which you can pass to the set_postfix() method to display it in the progress bar.

This approach provides the flexibility to update the progress bar inside the loop while keeping the code clean and readable. This answer is based on the comments from @cbrnr and @tim-mb.

Your Answer

Reminder: Answers generated by Artificial Intelligence tools are not allowed on Stack Overflow. Learn more

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.