purkinje 0.1.1

Test runner for py.test with web GUI

purkinje

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:

purkinje

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:

py.test

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

purkinje_runner

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
master

Coverage:

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)

Development

• uses semantic versioning

• uses git-flow git workflow

• Download archive: branch *dev*

History

• Dec 11, 2014: Start of Development