[docs] [issue25152] venv documentation doesn't tell you how to specify a particular version of python
report at bugs.python.org
Thu Sep 17 16:13:32 CEST 2015
New submission from Laura Creighton:
https://docs.python.org/3/library/venv.html nowhere explicitly states
how you are supposed to get a venv with a particular python version.
Users of virtualenv will be looking for a -p option.
The doc says:
"Creation of virtual environments is done by executing the pyvenv script:"
which undoubtably works if you _have_ a pyenv script, but I don't have
one. It is nowhere stated where I should find one.
Fortunately, I can also run things as
some_python_version -m venv myvenv
This, everybody is able to do. (However, it may not work, see
issue 25151 -- but forget that for now.)
This is something that everybody ought to be able to do.
Thus I propose either deleting the mention of pyenv, (if it is exactly
equivalent to running python -m venv) or expanding
the section, indicating where the script lives, and why you might
want to run it instead of python -m venv.
Then, before the line:
The command, if run with -h, will show the available options:
add the line:
The version of python used in the venv is determined at this time.
If the default version of python is not the one desired, use:
/path/to/the/python/I/want -m venv myenv instead.
(Plus, if there is a way to do this with pyenv, then list that
assignee: docs at python
components: Distutils, Documentation
nosy: docs at python, dstufft, eric.araujo, lac
title: venv documentation doesn't tell you how to specify a particular version of python
versions: Python 3.3, Python 3.4, Python 3.5, Python 3.6
Python tracker <report at bugs.python.org>
More information about the docs