{"id":24665676,"url":"https://github.com/makukha/virtualenv-multipython","last_synced_at":"2026-05-19T02:41:13.656Z","repository":{"id":270902372,"uuid":"911807938","full_name":"makukha/virtualenv-multipython","owner":"makukha","description":"virtualenv discovery plugin for multipython","archived":false,"fork":false,"pushed_at":"2025-01-19T10:42:35.000Z","size":182,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-19T11:28:59.016Z","etag":null,"topics":["discovery","multipython","plugin","testing","tox","virtualenv","virtualenv-discovery","virtualenv-plugin"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/makukha.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-03T22:45:28.000Z","updated_at":"2025-01-19T10:41:56.000Z","dependencies_parsed_at":"2025-01-03T23:15:24.537Z","dependency_job_id":"eeb98e86-d629-42b4-bcc5-143dab337eea","html_url":"https://github.com/makukha/virtualenv-multipython","commit_stats":null,"previous_names":["makukha/virtualenv-multipython"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makukha%2Fvirtualenv-multipython","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makukha%2Fvirtualenv-multipython/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makukha%2Fvirtualenv-multipython/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makukha%2Fvirtualenv-multipython/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/makukha","download_url":"https://codeload.github.com/makukha/virtualenv-multipython/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244781791,"owners_count":20509667,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["discovery","multipython","plugin","testing","tox","virtualenv","virtualenv-discovery","virtualenv-plugin"],"created_at":"2025-01-26T07:13:10.268Z","updated_at":"2026-05-19T02:41:13.608Z","avatar_url":"https://github.com/makukha.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# virtualenv-multipython\n\u003e virtualenv discovery plugin for [multipython](https://github.com/makukha/multipython)\n\n[![python versions](https://img.shields.io/pypi/pyversions/virtualenv-multipython.svg)](https://pypi.org/project/virtualenv-multipython)\n[![pypi](https://img.shields.io/pypi/v/virtualenv-multipython.svg#v0.4.1)](https://pypi.python.org/pypi/virtualenv-multipython)\n[![tested with multipython](https://img.shields.io/badge/tested_with-multipython-x)](https://github.com/makukha/multipython)\n[![uses docsub](https://img.shields.io/badge/uses-docsub-royalblue)\n](https://github.com/makukha/docsub)\n[![license](https://img.shields.io/github/license/makukha/virtualenv-multipython.svg)](https://github.com/makukha/virtualenv-multipython/blob/main/LICENSE)\n\n\u003e [!NOTE]\n\u003e [virtualenv-multipython]() has twin plugin [tox-multipython](https://github.com/makukha/tox-multipython) that serves similar purpose for [tox](https://tox.wiki) 3\n\nThis [virtualenv](https://virtualenv.pypa.io) 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.\n\nEnvironment names supported are all multipython tags, including free threading Python builds `py313t` and `py314t`. More names may be added in the future.\n\n# Behaviour\n\n* Loosely follow behaviour of builtin virtualenv discovery, with some important differences:\n* Try requests one by one, starting with [`--try-first-with`](https://virtualenv.pypa.io/en/latest/cli_interface.html#try-first-with); if one matches multipython tag or is an absolute path, return it to virtualenv.\n* If no version was requested at all, use `sys.executable`\n* If no request matched conditions above, fail to discover interpreter.\n* In particular, command names on `PATH` are not discovered.\n\n# Testing\n\nThere are two test suites:\n\n1. `venv` — Install `virtualenv` in *host tag* environment and create virtual environments for all *target tags*. Environment's python version must match *target tag*.\n2. `tox4` — `tox` and `virtualenv` are installed in *host tag* environment, and `tox run` is executed on `tox.ini` with env names equal to *target tags*. This test includes subtests:\n    - assert `{env_python}` version inside tox env\n    - assert `python` version inside tox env\n    - install externally built *sample package* in tox environment\n    - execute entrypoint of *sample package*\n\nVirtualenv supports discovery plugins since v20. In v20.22, it dropped support for Python \u003c=3.6, in v20.27 it dropped support for Python 3.7.\n\nThis is why we use 6 different test setups:\n\n1. `venv` + `virtualenv\u003e=20`\n1. `venv` + `virtualenv\u003e=20,\u003c20.27`\n1. `venv` + `virtualenv\u003e=20,\u003c20.22`\n1. `tox4` + `virtualenv\u003e=20`\n1. `tox4` + `virtualenv\u003e=20,\u003c20.27`\n1. `tox4` + `virtualenv\u003e=20,\u003c20.22`\n\n## Test report\n\nWhen `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](https://github.com/makukha/multipython) executable. For prohibited 🚫️ *target tag*, python executable is not discoverable. For failing 💥 *target tag*, interpreter is discoverable, but virtual environment with *sample package* cannot be created.\n\n*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).\n\n\u003ctable\u003e\n\u003ctbody\u003e\n\n\u003ctr\u003e\n\n\u003ctd\u003e\n\u003ccode\u003evirtualenv\u003e=20\u003c/code\u003e\n\u003c!-- docsub: begin --\u003e\n\u003c!-- docsub: x pretty venv-v__ --\u003e\n\u003c!-- docsub: lines after 1 upto -1 --\u003e\n\u003cpre\u003e\n  HOST    TARGETS\n——————    A B C D E F G H I J K L M\npy314t  A ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\npy313t  B ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n py314  C ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n py313  D ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n py312  E ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n py311  F ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n py310  G ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n  py39  H ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n  py38  I ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n  py37  J ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n  py36  K ✅✅✅✅✅✅✅✅✅✅✅✅✅\n  py35  L ✅✅✅✅✅✅✅✅✅✅✅✅✅\n  py27  M ✅✅✅✅✅✅✅✅✅✅✅✅✅\n\u003c/pre\u003e\n\u003c!-- docsub: end --\u003e\n\u003c/td\u003e\n\n\u003ctd\u003e\n\u003ccode\u003etox\u003e=4,\u003c5\u003c/code\u003e, \u003ccode\u003evirtualenv\u003e=20\u003c/code\u003e\n\u003c!-- docsub: begin --\u003e\n\u003c!-- docsub: x pretty tox4-v__ --\u003e\n\u003c!-- docsub: lines after 1 upto -1 --\u003e\n\u003cpre\u003e\n  HOST    TARGETS\n——————    A B C D E F G H I J K L M\npy314t  A ✅✅✅✅✅✅✅✅✅💥🚫🚫🚫\npy313t  B ✅✅✅✅✅✅✅✅✅💥🚫🚫🚫\n py314  C ✅✅✅✅✅✅✅✅✅💥🚫🚫🚫\n py313  D ✅✅✅✅✅✅✅✅✅💥🚫🚫🚫\n py312  E ✅✅✅✅✅✅✅✅✅💥🚫🚫🚫\n py311  F ✅✅✅✅✅✅✅✅✅💥🚫🚫🚫\n py310  G ✅✅✅✅✅✅✅✅✅💥🚫🚫🚫\n  py39  H ✅✅✅✅✅✅✅✅✅💥🚫🚫🚫\n  py38  I ✅✅✅✅✅✅✅✅✅💥🚫🚫🚫\n  py37  J ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n  py36  K . . . . . . . . . . . . .\n  py35  L . . . . . . . . . . . . .\n  py27  M . . . . . . . . . . . . .\n\u003c/pre\u003e\n\u003c!-- docsub: end --\u003e\n\u003c/td\u003e\n\n\u003c/tr\u003e\n\n\u003ctr\u003e\n\n\u003ctd\u003e\n\u003ccode\u003evirtualenv\u003e=20,\u003c20.27\u003c/code\u003e\n\u003c!-- docsub: begin --\u003e\n\u003c!-- docsub: x pretty venv-v27 --\u003e\n\u003c!-- docsub: lines after 1 upto -1 --\u003e\n\u003cpre\u003e\n  HOST    TARGETS\n——————    A B C D E F G H I J K L M\npy314t  A ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\npy313t  B ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n py314  C ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n py313  D ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n py312  E ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n py311  F ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n py310  G ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n  py39  H ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n  py38  I ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n  py37  J ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n  py36  K ✅✅✅✅✅✅✅✅✅✅✅✅✅\n  py35  L ✅✅✅✅✅✅✅✅✅✅✅✅✅\n  py27  M ✅✅✅✅✅✅✅✅✅✅✅✅✅\n\u003c/pre\u003e\n\u003c!-- docsub: end --\u003e\n\u003c/td\u003e\n\n\u003ctd\u003e\n\u003ccode\u003etox\u003e=4,\u003c5\u003c/code\u003e, \u003ccode\u003evirtualenv\u003e=20,\u003c20.27\u003c/code\u003e\n\u003c!-- docsub: begin --\u003e\n\u003c!-- docsub: x pretty tox4-v27 --\u003e\n\u003c!-- docsub: lines after 1 upto -1 --\u003e\n\u003cpre\u003e\n  HOST    TARGETS\n——————    A B C D E F G H I J K L M\npy314t  A ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\npy313t  B ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n py314  C ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n py313  D ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n py312  E ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n py311  F ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n py310  G ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n  py39  H ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n  py38  I ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n  py37  J ✅✅✅✅✅✅✅✅✅✅🚫🚫🚫\n  py36  K . . . . . . . . . . . . .\n  py35  L . . . . . . . . . . . . .\n  py27  M . . . . . . . . . . . . .\n\u003c/pre\u003e\n\u003c!-- docsub: end --\u003e\n\u003c/td\u003e\n\n\u003c/tr\u003e\n\n\u003ctr\u003e\n\n\u003ctd\u003e\n\u003ccode\u003evirtualenv\u003e=20,\u003c20.22\u003c/code\u003e\n\u003c!-- docsub: begin --\u003e\n\u003c!-- docsub: x pretty venv-v22 --\u003e\n\u003c!-- docsub: lines after 1 upto -1 --\u003e\n\u003cpre\u003e\n  HOST    TARGETS\n——————    A B C D E F G H I J K L M\npy314t  A ✅✅✅✅✅✅✅✅✅✅✅✅✅\npy313t  B ✅✅✅✅✅✅✅✅✅✅✅✅✅\n py314  C ✅✅✅✅✅✅✅✅✅✅✅✅✅\n py313  D ✅✅✅✅✅✅✅✅✅✅✅✅✅\n py312  E ✅✅✅✅✅✅✅✅✅✅✅✅✅\n py311  F ✅✅✅✅✅✅✅✅✅✅✅✅✅\n py310  G ✅✅✅✅✅✅✅✅✅✅✅✅✅\n  py39  H ✅✅✅✅✅✅✅✅✅✅✅✅✅\n  py38  I ✅✅✅✅✅✅✅✅✅✅✅✅✅\n  py37  J ✅✅✅✅✅✅✅✅✅✅✅✅✅\n  py36  K ✅✅✅✅✅✅✅✅✅✅✅✅✅\n  py35  L ✅✅✅✅✅✅✅✅✅✅✅✅✅\n  py27  M ✅✅✅✅✅✅✅✅✅✅✅✅✅\n\u003c/pre\u003e\n\u003c!-- docsub: end --\u003e\n\u003c/td\u003e\n\n\u003ctd\u003e\n\u003ccode\u003etox\u003e=4,\u003c5\u003c/code\u003e, \u003ccode\u003evirtualenv\u003e=20,\u003c20.22\u003c/code\u003e\n\u003c!-- docsub: begin --\u003e\n\u003c!-- docsub: x pretty tox4-v22 --\u003e\n\u003c!-- docsub: lines after 1 upto -1 --\u003e\n\u003cpre\u003e\n  HOST    TARGETS\n——————    A B C D E F G H I J K L M\npy314t  A ✅✅✅✅✅✅✅✅✅✅✅✅✅\npy313t  B ✅✅✅✅✅✅✅✅✅✅✅✅✅\n py314  C ✅✅✅✅✅✅✅✅✅✅✅✅✅\n py313  D ✅✅✅✅✅✅✅✅✅✅✅✅✅\n py312  E ✅✅✅✅✅✅✅✅✅✅✅✅✅\n py311  F ✅✅✅✅✅✅✅✅✅✅✅✅✅\n py310  G ✅✅✅✅✅✅✅✅✅✅✅✅✅\n  py39  H ✅✅✅✅✅✅✅✅✅✅✅✅✅\n  py38  I ✅✅✅✅✅✅✅✅✅✅✅✅✅\n  py37  J ✅✅✅✅✅✅✅✅✅✅✅✅✅\n  py36  K . . . . . . . . . . . . .\n  py35  L . . . . . . . . . . . . .\n  py27  M . . . . . . . . . . . . .\n\u003c/pre\u003e\n\u003c!-- docsub: end --\u003e\n\u003c/td\u003e\n\n\u003c/tr\u003e\n\n\u003c/tbody\u003e\n\u003c/table\u003e\n\n\n# Changelog\n\nCheck repository [CHANGELOG.md](https://github.com/makukha/virtualenv-multipython/tree/main/CHANGELOG.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmakukha%2Fvirtualenv-multipython","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmakukha%2Fvirtualenv-multipython","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmakukha%2Fvirtualenv-multipython/lists"}