KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

cricket

★ 226 Open GitHub ↗

A GUI tool for running Python test suites.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Cricket

[![Cricket](https://raw.githubusercontent.com/beeware/cricket/main/docs/en/images/cricket.png)](https://cricket.beeware.org)

[![Python Versions](https://img.shields.io/pypi/pyversions/cricket.svg)](https://pypi.python.org/pypi/cricket) [![PyPI Version](https://img.shields.io/pypi/v/cricket.svg)](https://pypi.python.org/pypi/cricket) [![Maturity](https://img.shields.io/pypi/status/cricket.svg)](https://pypi.python.org/pypi/cricket) [![BSD License](https://img.shields.io/pypi/l/cricket.svg)](https://github.com/beeware/cricket/blob/main/LICENSE) [![Discord server](https://img.shields.io/discord/836455665257021440?label=Discord%20Chat&logo=discord&style=plastic)](https://beeware.org/bee/chat/)

Cricket is part of the [BeeWare suite](https://beeware.org).

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](http://en.wikipedia.org/wiki/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](http://xkcd.com/323/) limits come into effect, so something else is required...

## Quickstart

Cricket can run any test suite that can be run run with `pytest`.

To use Cricket, install it with pip:

$ pip install cricket

Then, to run your unittest suite:

$ cricket

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

Documentation for Cricket can be found on [Read The Docs](https://cricket.beeware.org).

## Community

Cricket is part of the [BeeWare suite](https://beeware.org). You can talk to the community through:

- [@beeware@fosstodon.org on Mastodon](https://fosstodon.org/@beeware)
- [Discord](https://beeware.org/bee/chat/)

We foster a welcoming and respectful community as described in our [BeeWare Community Code of Conduct](https://beeware.org/community/behavior/).

## Contributing

If you experience problems with Cricket, [log them on GitHub](https://github.com/beeware/cricket/issues).

If you want to contribute, please [fork the project](https://github.com/beeware/cricket) and [submit a pull request](https://github.com/beeware/cricket/pulls).

## Acknowledgements

Icons for Cricket come from [Icons8](https://icons8.com), and are used under the terms of a [CC BY-ND 3.0](https://creativecommons.org/licenses/by-nd/3.0/) license.

cricket

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README