Pytest plugin to select test using Ekstazi algorithm
pytest-ekstazi is a plugin for pytest that selects the test cases that need to be run based on the Ekstazi algorithm.
You will need the following prerequisites in order to use pytest-ekstazi:
- Python 3.7 or newer
- Pytest 6.0.0 or newer
To install pytest-ekstazi:
pip install pytest-ekstazi
Selecting the test cases
--ekstazi command line option to enable the plugin. For the first session the plugin is going to run the entire test suite and map the depedencies of each test function. The next executions, Ekstazi is going to check for each test function if their dependency files have changed. Just test cases with depedencies that have changed will run.
pytest --ekstazi .
For every run, the plugin saves/updates the dependency tree, last test results and dependency hashes in a configuration file. By default the configuration file is saved in working directory under name
ekstazi.json. You can change the configuration file location by doing:
pytest --ekstazi --ekstazi-file path/to/bar.json
Run the plugin always in the same directory or pass full path of the configuration file, otherwise the plugin will not be able to select the test case based on previous result.
To setup the development environment, first make sure
Python >= 3.7 is installed in your machine. So clone the repo:
git clone https://github.com/Igorxp5/pytest-ekstazi.git
Open the project directory and install the plugin in editable-mode:
pip install -e .
Ekstazi is Regression Test Selection algorithm created by Milos Gligoric, Lamyaa Eloussi, and Darko Marinov. Check out the their research paper.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Hashes for pytest_ekstazi-1.0.0-py3-none-any.whl