Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Test runner for py.test with web GUI

Project description


Test runner for py.test test framework with web GUI

Live Demo

Getting Started

pukinje is a browser application intended to run on a spare monitor. It shows results of automated tests in realtime. Currently, the only supported test framework is py.test.

To use purkinje:

Create a virtual environment for purkinje and activate it:

mkvirtualenv purkinje
workon purkinje

Install purkinje:

pip install purkinje

Launch it:


Open it in a browser:

google-chrome http://localhost:5000/

Prepare your Python/py.test project for reporting to purkinje. In your project’s virtualenv, install the py.test plugin for purkinje:

pip install pytest-purkinje

Run your tests. The results should be visible in the browser:


Alternatively, you may run purkinje_runner in your project directory. It will automatically detect changes the the sources and execute py.test:


Known Limitations

  • Security: There is no access restriction; use only on the local machine

    • Anyone can use the web application
    • Anyone can send test results to the purkinje server

    Thus, the server is running on localhost and not accessible from other machines.

  • Only a single test suite

    If you run multiple purkinje-enabled test suites simultaneously, test results will get mixed up. This might change in a future version.

Build Status

Branch Status
dev travis-dev
master travis-master

Coverage: coveralls

System Requirements

  • Currently, only Python 2.7.x is supported because of gevent. In the future, if gevent should support Python 3, purkinje should also support it. Alternatively, gevent might get replaced e.g. by guv.
  • tested on Ubuntu 14.04
  • needs a modern browser that supports WebSockets

Supported Python versions

  • Currently, only 2.7.x is supported. Python 3 support is blocked by the following packages:

    cssmin gevent (which is blocking gevent-websocket) inotifyx (which is blocking gevent_inotifyx)



  • Dec 11, 2014: Start of Development

Project details

Download files

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

Files for purkinje, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size purkinje-0.1.0.tar.gz (15.5 MB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page