PublicArchive/cpython
2
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2026-08-09 18:50:37 -04:00
Code Issues Packages Projects Releases Wiki Activity

gh-124113: Clarify venv target directory reuse (#151419)

Browse Source 
* gh-124113: Clarify venv target directory reuse

* gh-124113: Refine venv reuse wording

* gh-124113: State that --clear also deletes non-venv files
This commit is contained in:
Harjoth Khara
2026-06-22 15:05:03 +01:00
committed by GitHub
parent 4448205d95
commit 614e3ec0c6
1 changed files with 6 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Doc/library/venv.rst
+6 -1
View File
@@ -77,6 +77,9 @@ containing a copy or symlink of the Python executable
It also creates a :file:`lib/pythonX.Y/site-packages` subdirectory
(on Windows, this is :file:`Lib\\site-packages`).
If an existing directory is specified, it will be re-used.
Reusing an existing directory does not leave it unchanged: ``venv`` may create,
update, or replace files in the target directory. Use a dedicated directory for
the virtual environment, and avoid placing project files directly inside it.
.. versionchanged:: 3.5
The use of ``venv`` is now recommended for creating virtual environments.
@@ -126,7 +129,9 @@ The command, if run with ``-h``, will show the available options::
.. option:: --clear
Delete the contents of the environment directory if it already exists, before environment creation.
Delete all contents of the environment directory if it already exists,
including files that were not created by ``venv``,
before environment creation.
.. option:: --upgrade