Registry / testing / pytest-incremental

pytest-incremental

library0.6.0pypiunverified

Pytest-incremental is a pytest plugin designed to accelerate test execution by identifying and running only the tests affected by recent code changes. It achieves this by analyzing project structure and file modifications between test runs, reordering test execution and de-selecting unaffected tests. The project is currently at version 0.6.0, but it is officially deprecated and no longer actively maintained.

testing

pip install pytest-incremental

INSTALL

IMPORT

SIG · PYTEST-INCREMENTAL

pytest-incremental

testingenv0.6.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

The plugin is activated via a command-line flag or `pytest.ini` configuration. No direct Python imports are typically made in test files for the plugin itself. You primarily interact with it through the `pytest` CLI.

import os # To use pytest-incremental, simply run pytest with the --inc flag. # Example command line usage: # pytest --inc # Alternatively, enable it by default in your pytest.ini: # [pytest] # addopts = --inc # To watch for changes in modules outside the current working directory: # pytest --inc --inc-path my_lib --inc-path ../py3rd-trunk/py3rd # To visualize detected dependencies (requires graphviz): # pytest --inc-graph-image

Debug

Known issues

breakingThe pytest-incremental project is officially DEPRECATED and no longer maintained. A replacement project, 'rut' (built on unittest directly), is being developed by the original author. Users should consider migrating or using alternative incremental test runners.

fix

Consider migrating to 'rut' or an alternative incremental testing tool like 'pytest-testmon'.

affects: All versions

gotchaPytest-incremental relies on AST analysis to detect dependencies. Dynamic aspects of Python, such as `importlib` usage, non-explicit imports, or extensive monkey-patching, may prevent it from accurately detecting all dependencies, leading to incomplete test runs or undetected changes.

fix

Minimize dynamic import patterns and monkey-patching where possible in modules with test dependencies. Manually specify watched paths using `--inc-path` if dependencies are in non-standard locations.

affects: All versions

gotchaProjects with cyclic dependencies will negatively affect the efficacy of pytest-incremental, as any change in a module within a cycle may lead to all modules in the cycle (and their dependents) being re-executed.

fix

Refactor your codebase to eliminate cyclic dependencies for better code maintainability and optimal performance with pytest-incremental.

affects: All versions

gotchaThe plugin was last officially tested with Python 3.6-3.9 and pytest 6.x. While it may still function with newer Python and pytest versions (e.g., pytest 8.3.3 with Python 3.10.12), compatibility is not guaranteed or officially supported due to the project's deprecated status.

fix

Test thoroughly with your specific Python/pytest versions. Be aware that unaddressed compatibility issues may arise.

affects: 0.6.0 and earlier with pytest > 6.x or Python > 3.9

Errors

Common errors & fixes

pytest: error: unrecognized arguments: --inc

The 'pytest-incremental' plugin is not installed in the current environment or pytest cannot locate it.

fix

Install the plugin: `pip install pytest-incremental`

Pytest is running all tests even when only a small change was made, or tests that should be skipped are still running.

Pytest-incremental is not correctly detecting dependencies due to factors like dynamic imports, monkey-patching, cyclic dependencies, or an incompatibility with your current pytest version.

fix

Review your codebase for dynamic import patterns or cyclic dependencies. Ensure your pytest and pytest-incremental versions are compatible. Consider enabling verbose output (`pytest --inc -v`) to understand what the plugin is doing. If issues persist, consider using the recommended replacement 'rut' or 'pytest-testmon'.

Upgrade

Version history

0.6.0latest on PyPI · released Apr 24, 2021

Audit

Dependencies

pytestrequiredRequired as a pytest plugin to function.

doitrequiredUsed internally by the plugin for dependency tracking and result caching.

Agent activity

6 hits · last 30 days

node

Resources

No resource links recorded.