changeset:   98772:6ab285820db2
parent:      98770:5877c191b76e
user:        Brett Cannon <brett@python.org>
date:        Fri Oct 16 15:14:27 2015 -0700
files:       Doc/whatsnew/3.6.rst Misc/NEWS Tools/scripts/pyvenv
description:
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.


diff -r 5877c191b76e -r 6ab285820db2 Doc/whatsnew/3.6.rst
--- a/Doc/whatsnew/3.6.rst	Fri Oct 16 12:21:37 2015 -0700
+++ b/Doc/whatsnew/3.6.rst	Fri Oct 16 15:14:27 2015 -0700
@@ -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 -r 5877c191b76e -r 6ab285820db2 Misc/NEWS
--- a/Misc/NEWS	Fri Oct 16 12:21:37 2015 -0700
+++ b/Misc/NEWS	Fri Oct 16 15:14:27 2015 -0700
@@ -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 -r 5877c191b76e -r 6ab285820db2 Tools/scripts/pyvenv
--- a/Tools/scripts/pyvenv	Fri Oct 16 12:21:37 2015 -0700
+++ b/Tools/scripts/pyvenv	Fri Oct 16 15:14:27 2015 -0700
@@ -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