Accueil·Commandes du terminal

python -m venv

Paquets et runtimes

Syntaxe

python -m venv [--upgrade-deps] <directory>

Crée un interpréteur isolé et son site-packages dans un dossier ; le créer ne suffit pas, il faut l'activer ou appeler directement .venv/bin/python, et comme les chemins y sont inscrits, renommer le dossier ensuite le casse.

Options courantes

OptionSignification
--upgrade-depsstart with an up-to-date pip
--system-site-packageslet it see the globally installed packages
--clearempty the directory first
--prompt <name>what the shell prompt should say
--without-pipno pip inside

Exemples

python -m venv .venv

creates an isolated interpreter and site-packages in .venv

source .venv/bin/activate

starts using it; on Windows it is .venv\Scripts\activate

python -m venv --upgrade-deps .venv

creates it with the newest pip inside

La question est toujours quoi va où : dans ce projet, ou sur la machine entière.

Comment lire

  • Les crochets [ ] marquent une partie facultative.
  • Les points de suspension … signifient qu’on peut en mettre plusieurs.
  • Les options sont sensibles à la casse : sur certaines commandes, -r et -R ne font pas la même chose.

Questions fréquentes

Q. Que fait python -m venv ?

Crée un interpréteur isolé et son site-packages dans un dossier ; le créer ne suffit pas, il faut l'activer ou appeler directement .venv/bin/python, et comme les chemins y sont inscrits, renommer le dossier ensuite le casse.

Q. Comment l’écrire ?

python -m venv [--upgrade-deps] <directory> — les crochets marquent ce qui est facultatif.

Q. Combien d’options valent la peine ?

Il y en a 5 ici ; la liste complète est dans man python. Cette commande relève de Paquets et runtimes.

Commandes liées

page man: man python--m-venv