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

Versatile utility function to run external processes

Project Description

ProcRunner Documentation Status Updates

Versatile utility function to run external processes


  • runs an external process and waits for it to finish
  • does not deadlock, no matter the process stdout/stderr output behaviour
  • returns the exit code, stdout, stderr (separately), and the total process runtime as a dictionary
  • process can run in a custom environment, either as a modification of the current environment or in a new environment from scratch
  • stdin can be fed to the process, the returned dictionary contains information how much was read by the process
  • stdout and stderr is printed by default, can be disabled
  • stdout and stderr can be passed to any arbitrary function for live processing
  • optionally enforces a time limit on the process


This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.


0.4.0 (2018-04-23)

  • Python 2.7 support on Windows. Python3 not yet supported on Windows.


  • run_process() renamed to run()
  • Python3 compatibility fixes

0.2.0 (2018-03-12)

  • Procrunner is now Python3 3.3-3.6 compatible.

0.1.0 (2018-03-12)

  • First release on PyPI.

Release history Release notifications

This version
History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
procrunner-0.4.0-py2.py3-none-any.whl (6.4 kB) Copy SHA256 hash SHA256 Wheel py2.py3 Apr 23, 2018
procrunner-0.4.0.tar.gz (14.4 kB) Copy SHA256 hash SHA256 Source None Apr 23, 2018

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