Installation

It’s recommended to install this package from PyPI:

pip install pytest-select

Usage

This plugin adds new command line options to pytest:

• --select-from-file

• --deselect-from-file

• --select-fail-on-missing

The first two both expect an argument that resolves to a UTF-8 encoded text file containing one test name per line.

The third one changes the behaviour in case (de-)selected test names are missing from the to-be executed tests. By default a warning is emitted and the remaining selected tests are executed as normal. By using the --select-fail-on-missing flag this behaviour can be changed to instead abort execution in that case.

Test names are expected in the same format as seen in the output of pytest --collect-only --quiet for example.

Both plain test names or complete node ids (e.g. test_file.py::test_name) are accepted.

Example:

$~ cat selection.txt
test_something
test_parametrized[1]
tests/test_foo.py::test_other

$~ pytest --select-from-file selection.txt
$~ pytest --deselect-from-file selection.txt

Development

This package uses Poetry. To setup a development environment install Poetry and then run:

poetry install

Questions

pytest --collect-only --quiet | \
    grep '::' | \
    circleci tests split --split-by=timings --timings-type=testname > selected.txt
pytest --select-from-file selected.txt

Version History

• v0.1.2 - 2019-01-18:

  • Add informational pytest header report output

• v0.1.1 - 2018-12-10:

  • Add --select-fail-on-missing option

  • Add basic mutation testing

• v0.1.0post0 - 2018-12-08:

  • Fix README

• v0.1.0 - 2018-12-08:

  • Initial release