pyenv.pyenv/plugins/pyenv-link/README.md
macayu17 798a1ad603 Incorporate the pyenv-link plugin
* Adapt test_helper for use in plugins
* Add pyenv-link tests
* Add pyenv-link tests to CI
2026-09-09 02:30:53 +03:00

931 B

pyenv-link

A pyenv plugin for linking Python installations and virtual environments into your pyenv root.

This plugin recommends the pyenv-virtualenv plugin.

Usage

Make an arbitrary virtualenv available through pyenv. This automatically guesses a fitting name from the prompt, the directory name or the location of the venv.

$ pyenv link version .venv
Linked new version named myproject

You can also specify a name to use for the venv.

$ pyenv link version .venv myname
Linked new version named myname

The same command can give a platform-specific binary installation a shorter name:

$ pyenv link version "$(pyenv root)/versions/3.13.14-linux-x86_64" 3.13.14
Linked new version named 3.13.14

Now you can make pyenv activate/use the venv automatically:

$ pyenv local myproject