259

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

474

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}")
9
  • 41
    Must be marked as correct answer. It is much easier and cleaner than @gabarous's
    – QtRoS
    Commented 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.
    – matanox
    Commented 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
    Commented Jul 3, 2019 at 9:12
  • 4
    @Benham use tqdm.write
    – jayelm
    Commented Jan 9, 2020 at 1:05
  • 4
    @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
    Commented Dec 23, 2020 at 2:17
160

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
  • 5
    What is the leave=True argument doing? Commented 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
    Commented Sep 13, 2019 at 11:14
158

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
  • 5
    @Mark What if desc is dynamic and only derived within each iteration?
    – jtlz2
    Commented 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
    Commented 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 Commented Dec 10, 2022 at 3:25
  • 1
    @NasheedYasin: that can't possibly work, because the i in the f-string is bound before the loop is entered.
    – Eric
    Commented Feb 20, 2023 at 1:03
  • @Eric thanks for pointing it out. It won't indeed work. Should I delete my previous comment as it may mislead? Commented Feb 21, 2023 at 2:43
109

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
9

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
    Commented Jun 10, 2021 at 6:24
  • 1
    Or for c in (t := tqdm(my_list)):
    – Tim MB
    Commented Jan 4, 2023 at 20:00
9

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))
-1

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

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

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