Skip to main content
Help us improve Python packaging – donate today!

Text progressbar library for python.

Project Description

Text progressbar library for python

This library provides a text mode progressbar. This is typically used to display the progress of a long running operation, providing a visual clue that processing is underway.

The ProgressBar class manages the progress, and the format of the line is given by a number of widgets. A widget is an object that may display diferently depending on the state of the progress. There are three types of widget:

  • a string, which always shows itself;
  • a ProgressBarWidget, which may return a diferent value every time it’s update method is called; and
  • a ProgressBarWidgetHFill, which is like ProgressBarWidget, except it expands to fill the remaining width of the line.

The progressbar module is very easy to use, yet very powerful. And automatically supports features like auto-resizing when available.


[NEW] Using the progress bar as an iterable:

progress = ProgressBar()
for i in progress(range(80)):

Customizing widgets:

widgets = ['Something: ', Percentage(), ' ', Bar(marker=RotatingMarker()),
           ' ', ETA(), ' ', FileTransferSpeed()]
pbar = ProgressBar(widgets=widgets, maxval=10000000).start()
for i in range(1000000):
  # do something

For more examples see:

Release history Release notifications

History Node


This version
History Node


History Node


History Node


Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page