[Python-checkins] cpython: Issue #25154: Deprecate the pyvenv script.

[brett.cannon]

https://hg.python.org/cpython/rev/6ab285820db2
changeset:   98772:6ab285820db2
parent:      98770:5877c191b76e
user:        Brett Cannon <brett at python.org>
date:        Fri Oct 16 15:14:27 2015 -0700
summary:
  Issue #25154: Deprecate the pyvenv script.

This was done so as to move users to `python3 -m venv` which prevents
confusion over which Python interpreter will be used in the virtual
environment when more than one is installed.

files:
  Doc/whatsnew/3.6.rst |  5 ++++-
  Misc/NEWS            |  6 ++++++
  Tools/scripts/pyvenv |  6 ++++++
  3 files changed, 16 insertions(+), 1 deletions(-)


diff --git a/Doc/whatsnew/3.6.rst b/Doc/whatsnew/3.6.rst
--- a/Doc/whatsnew/3.6.rst
+++ b/Doc/whatsnew/3.6.rst
@@ -197,7 +197,10 @@
 Deprecated features
 -------------------
 
-* None yet.
+* The ``pyvenv`` script has been deprecated in favour of ``python3 -m venv``.
+  This prevents confusion as to what Python interpreter ``pyvenv`` is
+  connected to and thus what Python interpreter will be used by the virtual
+  environment. See :issue:`25154`.
 
 
 Removed
diff --git a/Misc/NEWS b/Misc/NEWS
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -289,6 +289,12 @@
 
 - Issue #25022: Removed very outdated PC/example_nt/ directory.
 
+Tools/Demos
+-----------
+
+- Issue #25154: The pyvenv script has been deprecated in favour of
+  `python3 -m venv`.
+
 
 What's New in Python 3.5.1 release candidate 1?
 ===============================================
diff --git a/Tools/scripts/pyvenv b/Tools/scripts/pyvenv
--- a/Tools/scripts/pyvenv
+++ b/Tools/scripts/pyvenv
@@ -1,6 +1,12 @@
 #!/usr/bin/env python3
 if __name__ == '__main__':
     import sys
+    import pathlib
+
+    executable = pathlib.Path(sys.executable or 'python3').name
+    print('WARNING: the pyenv script is deprecated in favour of '
+          '`{} -m venv`'.format(exeutable, file=sys.stderr))
+
     rc = 1
     try:
         import venv

-- 
Repository URL: https://hg.python.org/cpython