Our take
- Activity
- 19
- Community
- 47
- Issues
- 21
- Pull requests
- 20
+0 stars in the last 30 days
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
804Forks
74Change since Nov 16, 2026: 0 stars·0 forks
Overview
Green is a test runner built around Python’s standard unittest framework. It aims to make test results easier to scan with colorized, aligned output, while also supporting parallel execution and automatic discovery of test targets.
It is a fit for teams that already use unittest and want a dedicated command-line runner, rather than adopting a different testing framework. Green also integrates with coverage and Django, among other workflows. See the repository README for configuration and integration details.
Key Features
- Colorized terminal output when the terminal supports it, with test statuses aligned for quick scanning.
- Parallel test execution in independent processes, using one process per processor by default.
- Automatic test discovery and support for running multiple targets or an individual test.
- Multiple verbosity levels, including test docstrings in descriptive output modes.
- Built-in integration with the
coveragemodule. - Support for doctests declared in test modules.
- Shell completion for Bash and Zsh.
- Integration options for Django and
setup.pyworkflows.
Use Cases
- Python developers using
unittestwho want clearer pass, failure, error, and skip reporting. - Projects with discoverable test layouts that benefit from running a directory of tests without listing each test manually.
- Developers running larger test suites who want Green’s process-based parallel execution.
- Django projects looking for a test runner that can be configured through Django’s test-runner setting.
- Maintainers who want coverage reporting as part of their test-runner workflow.
Getting Started
Install Green with pip:
pip3 install green
Then run green from your project or pass a test directory or target. See the README for command-line options, configuration, and test-discovery guidance.
Considerations
- Green is designed for
unittestclasses and methods. Projects built around another testing framework should check compatibility with their existing tests before adopting it. - Parallel execution does not work well with
gevent, according to the project documentation. - The documented minimum supported Python version is 3.8. PyPy and Windows support are best-effort; macOS, Linux, and BSDs are listed as fully supported.
- Test discovery and imports depend on project layout and Python paths. The README provides troubleshooting guidance for common import issues.
Found this useful?
Share it with someone who would like green.