Skip to content

Instantly share code, notes, and snippets.

Embed
What would you like to do?
Python command line progress bar in less than 10 lines of code.
# The MIT License (MIT)
# Copyright (c) 2016 Vladimir Ignatev
#
# Permission is hereby granted, free of charge, to any person obtaining
# a copy of this software and associated documentation files (the "Software"),
# to deal in the Software without restriction, including without limitation
# the rights to use, copy, modify, merge, publish, distribute, sublicense,
# and/or sell copies of the Software, and to permit persons to whom the Software
# is furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included
# in all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
# INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
# PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
# FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
# OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE
# OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
import sys
def progress(count, total, status=''):
bar_len = 60
filled_len = int(round(bar_len * count / float(total)))
percents = round(100.0 * count / float(total), 1)
bar = '=' * filled_len + '-' * (bar_len - filled_len)
sys.stdout.write('[%s] %s%s ...%s\r' % (bar, percents, '%', status))
sys.stdout.flush() # As suggested by Rom Ruben (see: http://stackoverflow.com/questions/3173320/text-progress-bar-in-the-console/27871113#comment50529068_27871113)
@Niraj288
Copy link

Niraj288 commented Apr 25, 2018

Thanks

@davincif
Copy link

davincif commented May 6, 2018

ProgressBar
I've made a slight improvement that really came in handy in my case. Now I can add multiply loading bars.
Also there a tiny bug, if the size of the previous bar is greater than the next, there'll the trash characters printed after your bar, I solved that.

@jolespin
Copy link

jolespin commented May 9, 2018

Can't this to work in a jupyter notebook.

@joachimesque
Copy link

joachimesque commented Jun 23, 2018

If your status has variable length, you might want to insert the character for “erase to end of line” just before the first write, line 30: sys.stdout.write("\033[K")

@a8888951
Copy link

a8888951 commented Jul 2, 2018

very good! I take it. thanks

@pablosolar
Copy link

pablosolar commented Jul 4, 2018

Hello,
I can check that if the long job tries to print something, the progress bar breaks and starts to print in a new line. Is it possible to fix it???

@berensn
Copy link

berensn commented Nov 8, 2018

@gkiryaziev, @xsponse in the while loop that @vladignatyev used for demonstration, change the comparison operator to <= from < and it will show 100%

@rohangiriraj
Copy link

rohangiriraj commented Dec 12, 2018

Thanks for the progress bar. Will be using it on my own projects from now on!

@mikroskeem
Copy link

mikroskeem commented Jan 20, 2019

epic, many thanks.

@arbabnazar
Copy link

arbabnazar commented Mar 23, 2019

excellent

@teknopaul
Copy link

teknopaul commented Aug 9, 2019

If you put the percentage at the end of the line in windows you get visual feedback in the task bar.

echo -ne '\r [---] 10%'
sleep 1
echo -ne '\r [---] 20%'
sleep 1
echo -ne '\r [---] 30%'
sleep 1

@talltalltaylor
Copy link

talltalltaylor commented Dec 12, 2019

awesome, works like a charm

@MarcDirven
Copy link

MarcDirven commented Jan 10, 2020

I made a small improvement because I couldn't get it working, it wasn't printing anything cause of the \r character:

def progres(count, total, status='', bar_len=60):
    filled_len = int(round(bar_len * count / float(total)))

    percents = round(100.0 * count / float(total), 1)
    bar = '=' * filled_len + '-' * (bar_len - filled_len)

    fmt = '[%s] %s%s ...%s' % (bar, percents, '%', status)
    print('\b' * len(fmt), end='')  # clears the line
    sys.stdout.write(fmt)
    sys.stdout.flush()

@vladignatyev
Copy link
Author

vladignatyev commented Jan 10, 2020

@MarcDirven thank you, for your contribution! Could you please tell more about your setup? What OS and terminal you use to reproduce the problem?

@vladignatyev
Copy link
Author

vladignatyev commented Jan 10, 2020

By the way, 28th of December, 2020 will be the celebration of 5-years progress.py snippet. :D

@threewordphrase
Copy link

threewordphrase commented Jan 25, 2020

Genius, I love it!

@chrisgoodwins
Copy link

chrisgoodwins commented Feb 26, 2020

@vladignatyev Great snippet of code!! I will use this many times over.
As far as getting the progress bar to reach and display 100% -- I found that it works if you either start the counter value at 1, or increment the counter in the loop before calling the progress function (rather than incrementing after the function)

@cikal
Copy link

cikal commented May 9, 2020

simple and nice, thank you @vladignatyev for this snippet..

@lschoessow
Copy link

lschoessow commented Jul 17, 2020

Just download a module, this is BASIC

@MarcDirven
Copy link

MarcDirven commented Jul 21, 2020

@MarcDirven thank you, for your contribution! Could you please tell more about your setup? What OS and terminal you use to reproduce the problem?

Hi sorry for the late reply, I didn't quite see my notifications. I was using PyCharm at the time and I believe it was Python 3.7. I was using Windows and was just using the terminal that comes with PyCharm.

@Minotorious
Copy link

Minotorious commented Sep 12, 2020

Hey there, thanks for the awesome quick and simple progress bar :)

Made a quick improvement updating it to use the new style python string formatter as well as added a little colour effect for a more visual cue of the current progress. (https://gist.github.com/Minotorious/b5da8ee00301b9e9fcf3d71b92bd5973)

The equivalent new line in your code would be:
sys.stdout.write('[{0}] {1}% {2}\r'.format(bar, percents, status))

@andrewissac
Copy link

andrewissac commented Dec 7, 2020

Hey @vladignatyev !

Thanks for that very simple progress bar.
I've had some real fun adding some nonsense-rainbow color waves to the progress bar. Just uncomment the code in the lower region for a quick demo.

https://github.com/andrewissac/pyProgressbar/blob/main/progressbar.py

Cheers and stay healthy! :)

@dpriskorn
Copy link

dpriskorn commented Dec 19, 2020

Very nice!

@joesolly
Copy link

joesolly commented Jul 21, 2021

I created a fork that allows you to wrap your iterator for item in progress(items, total=len(items), status_func=generate_status):
https://gist.github.com/joesolly/666b16e2870346441588d9cbf42dcae1

@vladignatyev
Copy link
Author

vladignatyev commented Jul 21, 2021

@eldemir
Copy link

eldemir commented Oct 16, 2021

Very nice!

@Yourun-proger
Copy link

Yourun-proger commented Apr 20, 2022

@vladignatyev, thank you! Very useful and minimalistic code snippet. I was inspired by it and made a "progress spinner":

import sys

def progress_spinner(status, cur_pos):
    pos = ["|", "/", "-", "\\"]
    sys.stdout.write("%s: %s, [%s%s]\r" % (status, pos[cur_pos%4], cur_pos, '%'))
    sys.stdout.flush()

It can be used like this:

import time 

for i in range(101):
    progress_spinner('Build project', i)
    time.sleep(0.5)

@dpriskorn
Copy link

dpriskorn commented May 20, 2022

I have used console.status() from Rich instead of this one.

@Yourun-proger
Copy link

Yourun-proger commented May 20, 2022

@dpriskorn, cool "spinner", thanks! I posted "my" spinner with the same motivation as the author of the original gist: to provide an understandable simple short solution that can be implemented into the project without unnecessary dependencies.

@dpriskorn
Copy link

dpriskorn commented May 20, 2022

👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment