pytest-testmon is a pytest plugin designed to optimize test execution by automatically selecting and running only the tests affected by recent code changes. The plugin addresses a common pain point in continuous integration and development workflows where running the entire test suite after every change is time-consuming and inefficient. By intelligently determining which tests are impacted by specific code modifications, testmon enables developers to get faster feedback during development and reduces CI pipeline execution time.
The core functionality revolves around building and maintaining a dependency database that tracks relationships between source code and tests. When a developer makes changes to their codebase, testmon analyzes those changes against the stored dependency information to identify which tests need to be executed. This approach works in dynamically typed languages like Python by analyzing code dependencies and test coverage data. The plugin integrates seamlessly with pytest-watch, allowing it to function as a continuous test runner that automatically re-executes affected tests whenever code changes are detected.
Getting started with testmon is straightforward. Users install the plugin via pip and then run pytest with the --testmon flag to build the initial dependency database stored in a .testmondata file. On subsequent runs after code modifications, the same flag causes pytest to execute only the tests affected by those changes. The project maintains comprehensive documentation at testmon.org, including detailed explanations of how the plugin determines affected tests in dynamic languages and various configuration options for different use cases.
The repository shows active maintenance and community engagement, with the primary maintainer tarpas accounting for 63 tracked events in issue and pull request activity. Additional contributors including christianbundy and marcaube have also participated in the project's development. However, the project exhibits relatively high response latency for issues and pull requests, with a median response time of 502.7 hours and a mean of 3993.8 hours across 26 tracked items, suggesting that while the project is maintained, responsiveness to community inquiries could be improved.
The project's scope extends beyond individual developer workflows. The maintainers actively seek to integrate testmon into open source projects through a formal call for participation, offering to prepare pull requests and set up CI integration with no initial risk. This initiative allows projects to collect data on testmon's reliability and performance benefits before fully adopting the test selection functionality. The plugin is classified across multiple relevant domains including pytest integration, test selection, incremental testing, affected test detection, code coverage analysis, test optimization, continuous integration, and Python testing specifically.
The repository's connection to major projects like Microsoft's VSCode and TypeScript, as well as the Rust language project, indicates that testmon operates within an ecosystem of tools used by significant open source initiatives. This positioning suggests the plugin addresses real needs in professional development environments where test execution time directly impacts developer productivity and CI efficiency.
