Skip to main content

Travis status:

https://travis-ci.org/WoLpH/python-progressbar.png?branch=master

Coverage:

https://coveralls.io/repos/WoLpH/python-progressbar/badge.png?branch=master

Introduction

NOTE: This version has been completely rewritten and might not be 100% compatible with the old version. If you encounter any problems while using it please let me know: https://github.com/WoLpH/python-progressbar/issues

A text progress bar is typically used to display the progress of a long running operation, providing a visual cue that processing is underway.

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

  • Timer

  • ETA

  • AdaptiveETA

  • FileTransferSpeed

  • AdaptiveTransferSpeed

  • AnimatedMarker

  • Counter

  • Percentage

  • FormatLabel

  • SimpleProgress

  • Bar

  • ReverseBar

  • BouncingBar

  • RotatingMarker

  • DynamicMessage

The progressbar module is very easy to use, yet very powerful. It will also automatically enable features like auto-resizing when the system supports it.

Usage

There are many ways to use Python Progressbar, you can see a few basic examples here but there are many more in the examples file.

Wrapping an iterable

import time
import progressbar

bar = progressbar.ProgressBar()
for i in bar(range(100)):
    time.sleep(0.02)

Context wrapper

import time
import progressbar

with progressbar.ProgressBar(max_value=10) as bar:
    for i in range(10):
        time.sleep(0.1)
        bar.update(i)

Combining progressbars with print output

import time
import progressbar

bar = progressbar.ProgressBar(redirect_stdout=True)
for i in range(100):
    print 'Some text', i
    time.sleep(0.1)
    bar.update(i)

Progressbar with unknown length

import time
import progressbar

bar = progressbar.ProgressBar(max_value=progressbar.UnknownLength)
for i in range(20):
    time.sleep(0.1)
    bar.update(i)

Bar with custom widgets

import time
import progressbar

bar = progressbar.ProgressBar(widgets=[
    ' [', progressbar.Timer(), '] ',
    progressbar.Bar(),
    ' (', progressbar.ETA(), ') ',
])
for i in bar(range(20)):
    time.sleep(0.1)

Release files for progressbar2 3.10.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for progressbar2 3.10.1
File Size Uploaded
progressbar2-3.10.1.tar.gz 24.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for progressbar2 3.10.1
File Interpreter ABI Platform
progressbar2-3.10.1-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 44.9 kB

Release files / progressbar2-3.10.1.tar.gz

Download URL progressbar2-3.10.1.tar.gz
Size 24.1 kB
Tags Source
SHA-256 checksum
How to use checksums
0bf46fb3e41c1d64698c07f37a306524e3fecae21e9e526168c668b95fef3169
BLAKE2b-256 checksum
How to use checksums
1cdea2f5feaf4048c941070e06e5814cb2adad73cdf47778920cb6c762145f17
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / progressbar2-3.10.1-py2.py3-none-any.whl

Download URL progressbar2-3.10.1-py2.py3-none-any.whl
Size 20.8 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
9eecd7cdf4ba2db4bed85c1b591059e88912e00a2dc76ee820d6a9dc974460b4
BLAKE2b-256 checksum
How to use checksums
aa137fc75289f0f6a46d83913bfbe3db8003f0d56fd96a8564f6b334b830d461
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

4.6.0

2 release files

4.5.0

2 release files

4.4.3

2 release files

4.4.2

2 release files

4.4.1

2 release files

4.4.0

2 release files

4.3.2

2 release files

4.3.1

2 release files

4.3.0

2 release files

4.2.0

2 release files

4.1.1

2 release files

4.1.0

2 release files

4.0.0

2 release files

3.55.0

2 release files

3.54.0

2 release files

3.53.3

2 release files

3.52.1

2 release files

3.51.4

2 release files

3.51.1

2 release files

3.51.0

2 release files

3.50.1

2 release files

3.47.0

2 release files

3.46.1

2 release files

3.46.0

2 release files

3.45.1

2 release files

3.43.1

2 release files

3.42.0

2 release files

3.41.0

2 release files

3.39.3

2 release files

3.39.2

2 release files

3.39.0

2 release files

3.38.0

2 release files

3.37.1

2 release files

3.35.2

2 release files

3.35.1

2 release files

3.35.0

2 release files

3.34.3

2 release files

3.33.2

2 release files

3.33.1

2 release files

3.33.0

2 release files

3.32.1

2 release files

3.32.0

2 release files

3.31.1

2 release files

3.30.0

2 release files

3.20.2

2 release files

3.20.1

2 release files

3.18.1

2 release files

3.16.1

2 release files

3.16.0

2 release files

3.15.1

2 release files

3.15.0

2 release files

3.12.0

2 release files

3.11.0

2 release files

This release

3.10.1 This release

2 release files

3.10.0

1 release file

3.9.4

2 release files

3.9.3

2 release files

3.9.2

2 release files

3.9.1

2 release files

3.9.0

2 release files

3.8.1

2 release files

3.8.0

2 release files

3.7.0

2 release files

3.6.2

2 release files

3.6.1

1 release file

3.6.0

1 release file

3.5.2

1 release file

3.5.1

1 release file

3.5.0

1 release file

3.4.3

1 release file

3.4.2

1 release file

3.4.1

1 release file

3.4.0

1 release file

3.3.3

1 release file

3.3.2

1 release file

3.3.1

1 release file

3.3.0

1 release file

3.2.0

1 release file

3.1.0

1 release file

3.0.1

1 release file

2.7.3

1 release file

2.7.0

1 release file

2.6.9

1 release file

2.6.8

1 release file

2.6.7

1 release file

2.6.6

1 release file

2.6.5

1 release file

2.6.4

1 release file

2.6.3

1 release file

2.6.2

1 release file

2.6.1

1 release file

2.6.0

1 release file

2.5.0

1 release file

2.4.1

1 release file

2.4.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page