Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A simple progress bar for long running tasks (Tkinter based)

Project Description

This provides a very simple progress bar for long running tasks.

The design is somewhat similar to EasyGUI, allowing simple scripts to be GUI-fied without being refactored into callbacks and an event loop. It can naturally be used as an addition to the tools in EasyGUI. The interface can’t be quite as simple, but hopefully it’s only a little more complex.

progress_meter is based on this code by Michael Lange.

The high-level interface looks like this:

from progress_meter import withprogress

@withprogress(300, color="green")
def demo(foo, bar=None):
    for i in range(300):
        # Do one (or a few) steps of processing, then...
        yield i


You can use exceptions to see if the user cancelled the process before it completed:

except UserCancelled:

There’s also a lower-level interface in which you instantiate the window directly:

from progress_meter import MeterWindow

def _demostep(meter, value):
    if value < 1.0:
        value = value + 0.005
        meter.after(50, lambda: _demostep(meter, value))
        meter.set(value, 'Demo successfully finished')

def demo():
    root = MeterWindow(className='meter demo')
    root.meter.set(0.0, 'Starting demo...')
    root.after(1000, lambda: _demostep(root.meter, 0.0))

To use the progress bar alone in a more complete GUI, you can use the Meter class from this module (which subclasses tkinter.Frame).

Release History

Release History

This version
History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
progress_meter-1.0.tar.gz (4.3 kB) Copy SHA256 Checksum SHA256 Source Jan 17, 2012 (5.1 kB) Copy SHA256 Checksum SHA256 Source Jan 17, 2012

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting