https://github.com/makukha/tox-multipython
tox 3 discovery plugin for multipython
https://github.com/makukha/tox-multipython
discovery plugin testing tox tox-plugin
Last synced: 3 months ago
JSON representation
tox 3 discovery plugin for multipython
- Host: GitHub
- URL: https://github.com/makukha/tox-multipython
- Owner: makukha
- License: mit
- Created: 2025-01-08T20:48:27.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-01-22T09:09:06.000Z (5 months ago)
- Last Synced: 2025-01-26T07:13:05.576Z (4 months ago)
- Topics: discovery, plugin, testing, tox, tox-plugin
- Language: Python
- Homepage:
- Size: 93.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# tox-multipython
> python interpreter discovery plugin for [tox](https://tox.wiki) 3 and [multipython](https://github.com/makukha/multipython)[](https://github.com/makukha/tox-multipython/blob/main/LICENSE)
[](https://pypi.org/project/tox-multipython)
[](https://pypi.python.org/pypi/tox-multipython)
[](https://github.com/makukha/multipython)
[](https://github.com/makukha/docsub)> [!NOTE]
> [tox-multipython]() has twin plugin [virtualenv-multipython](https://github.com/makukha/virtualenv-multipython) that serves the same purpose for [tox](https://tox.wiki) 4This [tox](https://tox.wiki) plugin comes pre-installed in [multipython](https://hub.docker.com/r/makukha/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. More names may be added in the future.
# Testing
There is one test suite:
1. `tox3` — `tox>=3,<4` is installed in *host tag* environment, and `tox run` is executed on `tox.ini` with env names equal to *target tags*. This test includes subtests:
- assert `{env_python}` version inside tox env
- assert `python` version inside tox env
- install externally built *sample package* in tox environment
- execute entrypoint of *sample package*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.
This is why we use 6 different test setups:
1. `tox3` + `virtualenv>=20`
1. `tox3` + `virtualenv>=20,<20.27`
1. `tox3` + `virtualenv>=20,<20.22`## Test report
When `tox-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](https://github.com/makukha/multipython) executable. For failing 💥 *target tag*, interpreter is discoverable, but virtual environment with *sample package* cannot be created.
*Host tag* and *Target tags* are valid [multipython](https://hub.docker.com/r/makukha/multipython) tags. *Host tags* are listed vertically (rows), *target tags* are listed horizontally (columns).
tox>=3,<4
,virtualenv>=20
HOST TARGETS
—————— 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>=3,<4
,virtualenv>=20,<20.27
HOST TARGETS
—————— 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>=3,<4
,virtualenv>=20,<20.22
HOST TARGETS
—————— 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 💥💥💥💥💥✅✅✅✅✅✅✅✅# Changelog
Check [CHANGELOG.md](https://github.com/makukha/tox-multipython/tree/main/CHANGELOG.md)