Draw progress bars with room for colors and display rates and ETAs in your console applications. ETA library is its own class so it may be used in other non-console applications. ETAs calculated with simple linear regression.

This library supports both defined and undefined progress bars. Undefined progress bars are those that do not have a "total size". Similar to when wget downloads a file with an unknown file size. Due to this, undefined progress bars have no percent and no ETA. Defined progress bars are the usual progress bars with percentages and ETAs.

• Python 2.6, 2.7, PyPy, PyPy3, 3.3, and 3.4 supported on Linux and OS X.
• Python 2.7, 3.3, and 3.4 supported on Windows (both 32 and 64 bit versions of Python).

Tested on Windows XP and Windows 10 technical preview.

Install:

pip install etaprogress

Source code for examples: example.py, example_colors.py, and example_wget.py

If all you need is a progress bar with an ETA, you only have to import a class in the etaprogress.progress module. To get the progress bar itself just cast to string or print the instance.

import time
from etaprogress.progress import ProgressBar
total = 5
bar = ProgressBar(total, max_width=40)
for i in range(total + 1):
    bar.numerator = i
    print bar
    time.sleep(1)

0% (0/5) [               ] eta --:-- -

20% (1/5) [### ] eta 00:05 40% (2/5) [###### ] eta 00:04 | 60% (3/5) [######### ] eta 00:03 / 80% (4/5) [############ ] eta 00:02 -

100% (5/5) [###############] eta 00:00

Of course that's not a very good progress bar animation. Here's a better one with print_function:

from __future__ import print_function
import sys
import time
from etaprogress.progress import ProgressBar
total = 5
bar = ProgressBar(total, max_width=40)
for i in range(total + 1):
    bar.numerator = i
    print(bar, end='\r')
    sys.stdout.flush()
    time.sleep(1)
print()

100% (5/5) [###############] eta 00:00 \

Colors are supported using colorclass. Take a look at example_colors.py on how to implement colorful progress bars. You may have to subclass one of the ProgressBar classes (or even BaseProgressBar) to add colors to every nook and cranny of a progress bar.

There are five different progress bar classes with visual differences:

• ProgressBar -- a simple progress bar.
• ProgressBarBits -- similar to ProgressBar but converts numbers to bits, kilobits, etc.
• ProgressBarBytes -- similar to ProgressBar but converts numbers to bytes, kibibytes (kilobytes), etc.
• ProgressBarWget -- a progress bar that looks like the one in the GNU wget application.
• ProgressBarYum -- a progress bar that looks like the one in CentOS/RHEL 7 yum utility.

This project adheres to Semantic Versioning.

Fixed

• Broken setup.py file.

Added

• Windows support.

• Initial release.