virtualenv-multipython 0.3.1

virtualenv discovery plugin for tox 4 and multipython

virtualenv-multipython

virtualenv discovery plugin for multipython

[!NOTE] virtualenv-multipython has twin plugin tox-multipython that serves the same purpose for tox 3

This virtualenv plugin comes pre-installed in multipython Docker image and is responsible for resolving tox environment name to Python executable. Most probably, you don't need to install it yourself.

Environment names supported are all multipython tags, including free threading Python builds py313t and py314t. More names may be added in the future.

[!IMPORTANT] This plugin does not fall back to tox python: interpreter discovery errors are explicit.

Testing

There are two types of tests performed, both with env var VIRTUALENV_DISCOVERY=multipython exported:

1. Virtualenv. Install virtualenv in host tag environment and create virtual environments for all target tags. Environment's python version must match target tag. In these tests we test all multipython tags as both host tags and target tags.
2. Tox 4. tox and virtualenv are installed in host tag environment, and tox run is executed on tox.ini with env names equal to target tags. Tox environment's python version must match tox env name and target tag. In these tests we test all multipython tags as target tags and all tags except py27, py35, py36 as target tags (because tox 4 is requires Python 3.7+).

Virtualenv supports discovery plugins since v20. In v20.22, it dropped support for Python <=3.6, in v20.27 it dropped support for Python 3.7. You will see below that it is still capable to discover 3.7, but probably those 3.7 environments won't be fully functional.

This is why we use 6 different test setups:

1. Virtualenv, virtualenv>=20
2. Virtualenv, virtualenv>=20,<20.27
3. Virtualenv, virtualenv>=20,<20.22
4. Tox 4, tox>=4,<5, virtualenv>=20
5. Tox 4, tox>=4,<5, virtualenv>=20,<20.27
6. Tox 4, tox>=4,<5, virtualenv>=20,<20.22

Test report

When virtualenv-multipython is installed inside Host tag environment, it allows to use selected ✅ Target tag (create virtualenv environment or use as tox env name in env_list) and automatically discovers corresponding multipython executable. For failing 🚫️ Target tag, python executable is not discoverable.

Host tag and Target tags are valid multipython tags. Host tags are listed vertically (rows), target tags are listed horizontally (columns).

[!NOTE] The fully green line for py313 is a multipython design flaw that should be fixed soon: https://github.com/makukha/multipython/issues/76

virtualenv>=20 TARGETS HOST A B C D E F G H I J K L M py314t A ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py313t B ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py314 C ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py313 D ✅✅✅✅✅✅✅✅✅✅✅✅✅ py312 E ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py311 F ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py310 G ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py39 H ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py38 I ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py37 J ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py36 K ✅✅✅✅✅✅✅✅✅✅✅✅✅ py35 L ✅✅✅✅✅✅✅✅✅✅✅✅✅ py27 M ✅✅✅✅✅✅✅✅✅✅✅✅✅	tox>=4,<5, virtualenv>=20 TARGETS HOST A B C D E F G H I J K L M py314t A ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py313t B ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py314 C ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py313 D ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py312 E ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py311 F ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py310 G ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py39 H ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py38 I ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py37 J ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py36 K . . . . . . . . . . . . . py35 L . . . . . . . . . . . . . py27 M . . . . . . . . . . . . .
virtualenv>=20,<20.27 TARGETS HOST A B C D E F G H I J K L M py314t A ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py313t B ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py314 C ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py313 D ✅✅✅✅✅✅✅✅✅✅✅✅✅ py312 E ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py311 F ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py310 G ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py39 H ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py38 I ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py37 J ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py36 K ✅✅✅✅✅✅✅✅✅✅✅✅✅ py35 L ✅✅✅✅✅✅✅✅✅✅✅✅✅ py27 M ✅✅✅✅✅✅✅✅✅✅✅✅✅	tox>=4,<5, virtualenv>=20,<20.27 TARGETS HOST A B C D E F G H I J K L M py314t A ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py313t B ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py314 C ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py313 D ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py312 E ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py311 F ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py310 G ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py39 H ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py38 I ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py37 J ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫 py36 K . . . . . . . . . . . . . py35 L . . . . . . . . . . . . . py27 M . . . . . . . . . . . . .
virtualenv>=20,<20.22 TARGETS HOST A B C D E F G H I J K L M py314t A ✅✅✅✅✅✅✅✅✅✅✅✅✅ py313t B ✅✅✅✅✅✅✅✅✅✅✅✅✅ py314 C ✅✅✅✅✅✅✅✅✅✅✅✅✅ py313 D ✅✅✅✅✅✅✅✅✅✅✅✅✅ py312 E ✅✅✅✅✅✅✅✅✅✅✅✅✅ py311 F ✅✅✅✅✅✅✅✅✅✅✅✅✅ py310 G ✅✅✅✅✅✅✅✅✅✅✅✅✅ py39 H ✅✅✅✅✅✅✅✅✅✅✅✅✅ py38 I ✅✅✅✅✅✅✅✅✅✅✅✅✅ py37 J ✅✅✅✅✅✅✅✅✅✅✅✅✅ py36 K ✅✅✅✅✅✅✅✅✅✅✅✅✅ py35 L ✅✅✅✅✅✅✅✅✅✅✅✅✅ py27 M ✅✅✅✅✅✅✅✅✅✅✅✅✅	tox>=4,<5, virtualenv>=20,<20.22 TARGETS HOST A B C D E F G H I J K L M py314t A ✅✅✅✅✅✅✅✅✅✅✅✅✅ py313t B ✅✅✅✅✅✅✅✅✅✅✅✅✅ py314 C ✅✅✅✅✅✅✅✅✅✅✅✅✅ py313 D ✅✅✅✅✅✅✅✅✅✅✅✅✅ py312 E ✅✅✅✅✅✅✅✅✅✅✅✅✅ py311 F ✅✅✅✅✅✅✅✅✅✅✅✅✅ py310 G ✅✅✅✅✅✅✅✅✅✅✅✅✅ py39 H ✅✅✅✅✅✅✅✅✅✅✅✅✅ py38 I ✅✅✅✅✅✅✅✅✅✅✅✅✅ py37 J ✅✅✅✅✅✅✅✅✅✅✅✅✅ py36 K . . . . . . . . . . . . . py35 L . . . . . . . . . . . . . py27 M . . . . . . . . . . . . .

Authors

• Michael Makukha

This package is a part of multipython project.

License

MIT License

Changelog

Check repository CHANGELOG.md