CleanCut

green: Run Python Unit Tests with Clear, Parallel Output

Green is a Python test runner for unittest projects, with colorized, hierarchical results and parallel execution. It suits developers who want clearer test feedback and automatic test discovery without changing their unittest test classes.

View on GitHub Compare
Stars
804
Forks
75
Stars, last 30 days
+0

Our take

Health score

27/100

How it is scored
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.

Selected snapshot

Stars

804

Forks

74

Change 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 coverage module.
  • Support for doctests declared in test modules.
  • Shell completion for Bash and Zsh.
  • Integration options for Django and setup.py workflows.

Use Cases

  • Python developers using unittest who 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 unittest classes 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.