{"name":"Green: A Clean, Colorful, and Fast Python Test Runner","description":"Green is an innovative Python test runner designed for clarity, speed, and visual appeal. It provides a clean, colorful, and fast way to execute `unittest` based tests, enhancing the developer experience with detailed, aligned output and parallel execution.","github":"https://github.com/CleanCut/green","url":"https://osrepos.com/repo/cleancut-green","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/cleancut-green","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/cleancut-green.md","json":"https://osrepos.com/repo/cleancut-green.json","topics":["green","python","test-automation","test-driven-development","test-runner","testing","unittest","Python Testing"],"keywords":["green","python","test-automation","test-driven-development","test-runner","testing","unittest","Python Testing"],"stars":null,"summary":"Green is an innovative Python test runner designed for clarity, speed, and visual appeal. It provides a clean, colorful, and fast way to execute `unittest` based tests, enhancing the developer experience with detailed, aligned output and parallel execution.","content":"## Introduction\n\nGreen is a modern, feature-rich Python test runner that brings a fresh perspective to `unittest` execution. Developed by CleanCut, Green emphasizes clean, colorful, and fast test results, making the test-driven development cycle more intuitive and enjoyable. It supports parallel test execution, offers multiple verbosity levels, and integrates with popular tools like `coverage` and Django.\n\n## Installation\n\nTo get started with Green, simply install it using pip:\n\nbash\npip3 install green\n\n\nTo upgrade an existing installation:\n\nbash\npip3 install --upgrade green\n\n\n## Examples\n\nOnce installed, running your tests with Green is straightforward. Here are a few common ways to use it:\n\n**Run from inside your code directory:**\nbash\ngreen\n\n\n**Run from outside your code directory, specifying the target:**\nbash\ngreen code_directory\n\n\n**Run a specific test file:**\nbash\ngreen test_stuff.py\n\n\n**Run a specific test within a package:**\nbash\ngreen package.test.test_module.TestClass.test_function\n\n\nFor more options and detailed usage, you can always run `green --help` or refer to the [complete command-line options](https://github.com/CleanCut/green/blob/main/cli-options.txt){target=\"_blank\"}.\n\n## Why Use Green\n\nGreen stands out with a compelling set of features designed to improve your testing workflow:\n\n*   **Clean and Colorful Output**: Say goodbye to gray, cluttered terminal output. Green provides vertically aligned, low-redundancy results with vibrant colors, making it easy to spot successes and failures.\n*   **Fast Execution**: Tests run in independent processes, utilizing multiple processors by default for significantly faster execution times.\n*   **Powerful and Traditional**: It leverages the standard `unittest` classes and methods while offering multi-target auto-discovery.\n*   **Descriptive Verbosity**: Choose from various verbosity levels, from simple dots to full docstring output, to get the right amount of detail.\n*   **Convenient Integrations**: Includes Bash and ZSH completion for options and test targets, built-in `coverage` integration, and support for `setup.py` commands and Django.\n*   **Modern and Portable**: Supports Python 3.8+ and PyPy, and is compatible with macOS, Linux, BSDs, and Windows.\n\nGreen's origin story highlights a journey to create a test runner that prioritizes developer experience, addressing shortcomings found in other tools regarding output clarity, Python 3 compatibility, and maintainability. It was born from a desire for a truly \"Red/Green/Refactor\" experience, emphasizing the visual feedback crucial for TDD.\n\n## Links\n\nExplore Green further through these resources:\n\n*   **GitHub Repository**: [CleanCut/green](https://github.com/CleanCut/green){target=\"_blank\"}\n*   **Discussions**: [Open a discussion](https://github.com/CleanCut/green/discussions){target=\"_blank\"}\n*   **Issue Tracker**: [Submit an issue](https://github.com/CleanCut/green/issues/new){target=\"_blank\"}\n*   **Pull Requests**: [Submit a pull request](https://help.github.com/articles/creating-a-pull-request-from-a-fork/){target=\"_blank\"}\n*   **Training Course**: [Python Testing with Green on Udemy](https://www.udemy.com/python-testing-with-green/?couponCode=GREEN_GITHUB){target=\"_blank\"}","metrics":{"detailViews":0,"githubClicks":0},"dates":{"published":null,"modified":"2026-08-04T15:29:35.000Z"}}