Skip to main content

A multi-progressbar implementation to complement multiprocessing.Process

Project description

The progrock.MultiProgress class is used in conjunction with the methods exposed at the module level such as progrock.increment to create a full-screen experience allowing the user to track the progress of individual processes as they perform their work.

Version Downloads License

Installation

progrock may be installed via the Python package index with the tool of your choice. I prefer pip:

pip install progrock

Documentation

https://progrock.readthedocs.org

Requirements

There are no requirements outside of the Python standard library.

Screenshot

The following image shows the example code listing in action:

http://i.imgur.com/wi9MAdp.png

Example

The following example will create a process for each CPU core on the system that it is run on, displaying the MultiProgress screen. The child processes will iterate 100 times, updating their progress bar and then sleeping up to 1 second.

import progrock
import random

def example_runner(ipc_queue):
    # Update the processes status in its progress box
    progrock.set_status(ipc_queue, 'Running')

    # Increment the progress bar, sleeping up to one second per iteration
    for iteration in range(1, 101):
        progrock.increment(ipc_queue)
        time.sleep(random.random())

processes = []

# Create the MultiProgress instance
with progrock.MultiProgress('Example') as progress:

    # Spawn a process per CPU and append it to the list of processes
    for proc_num in range(0, multiprocessing.cpu_count()):
        processes.append(progress.new_process(example_runner))

    # Wait for the processes to run
    while any([p.is_alive() for p in processes]):
        time.sleep(1)

Version History

Available at https://progrock.readthedocs.org

Project details


Download files

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

Source Distribution

progrock-0.2.0.tar.gz (3.2 kB view details)

Uploaded Source

Built Distribution

progrock-0.2.0-cp27-none-macosx_10_10_intel.whl (5.5 kB view details)

Uploaded CPython 2.7 macOS 10.10+ intel

File details

Details for the file progrock-0.2.0.tar.gz.

File metadata

  • Download URL: progrock-0.2.0.tar.gz
  • Upload date:
  • Size: 3.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for progrock-0.2.0.tar.gz
Algorithm Hash digest
SHA256 3e53341b98d43627b16bb52c9e485a79ee2ff747272f57633cf202bcf81ccb8f
MD5 e4793c7ff6bd15b49c97ebe4d33e6c70
BLAKE2b-256 55b7a445e894bf3fe7502784b18e62e425121748cc0b1408cd2f9bf09811cfca

See more details on using hashes here.

File details

Details for the file progrock-0.2.0-cp27-none-macosx_10_10_intel.whl.

File metadata

File hashes

Hashes for progrock-0.2.0-cp27-none-macosx_10_10_intel.whl
Algorithm Hash digest
SHA256 474650c0aea6c983a12a0a2955d4efa38963a61d28ea5ae9e845c73b51e6b114
MD5 755b854199153db06f21a6fd0cb08d19
BLAKE2b-256 39117f146744e09414e947c33a81af97a805e56111e0ebe189583b249be6669a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page