Skip to content
A GUI tool for running Python test suites.
Branch: master
Clone or download
Latest commit 830fc1a May 8, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
cricket Make a developer pre-release of cricket. Jul 7, 2018
docs Started adding release notes for the next release. Jun 24, 2018
sample Added a pytest executor/discoverer. Jun 23, 2018
tests Merge branch 'master' into pytest Jun 24, 2018
.gitignore Merge branch 'master' into pytest Jun 24, 2018
AUTHORS Fixed #20 -- Corrected path to Django executor, masked by pyc caching. Jul 31, 2013 Corrected link in Mar 10, 2016
LICENSE Cleanup of setup and docs. Jun 15, 2013
README.rst Fix beekeeper link May 7, 2019
requirements_dev.txt Make tests compatible with older version of python using unittest2 Jul 9, 2013
setup.cfg Tweaked the setuptools configuration. Aug 3, 2018 Tweaked the setuptools configuration. Aug 3, 2018



Cricket is part of the BeeWare suite. The project website is

Cricket is a graphical tool that helps you run your test suites.

Normal test runners dump all output to the console, and provide very little detail while the suite is running. As a result:

  • You can't start looking at failures until the test suite has completed running,
  • It isn't a very accessible format for identifying patterns in test failures,
  • It can be hard (or cumbersome) to re-run any tests that have failed.

Why the name cricket? Test Cricket is the most prestigious version of the game of cricket. Games last for up to 5 days... just like running some test suites. The usual approach for making cricket watchable is a generous dose of beer; in programming, Ballmer Peak limits come into effect, so something else is required...


At present, Cricket has support for:

  • unittest test suites; and
  • pytest test suites; and
  • Django 1.6+ project test suites

To use Cricket, install it with pip:

$ pip install cricket

Then, to run your unittest suite:

$ cricket-unittest

Or, in a pytest project:

$ cricket-pytest

Or, in a Django project:

$ cricket-django

cricket-django will also work in Django's own tests directory -- i.e., you can use cricket-django to run Django's own test suite (for Django 1.6 or later).

Running cricket will display a GUI window. Hit "Run all", and watch your test suite execute. A progress bar is displayed in the bottom right hand corner of the window, along with an estimate of time remaining.

While the suite is running, you can click on test names to see the output of that test. The icon in the tree, and the summary panel on the right, will display the status of the test, as well as any output or error text.


Documentation for cricket can be found on Read The Docs.


Cricket is part of the BeeWare suite. You can talk to the community through:

We foster a welcoming and respectful community as described in our BeeWare Community Code of Conduct.


Icons for Cricket come from Icons8, and are used under the terms of a CC BY-ND 3.0 license.


If you experience problems with cricket, log them on GitHub. If you want to contribute code, please fork the code and submit a pull request.

You can’t perform that action at this time.