Allow Pants to run with Python 3 via ./pants3 script

build-support/pants_venv

@@ -12,7 +12,8 @@ REQUIREMENTS=(
 )
 
 function venv_dir() {
-  echo ${REPO_ROOT}/build-support/pants_dev_deps.venv
+  py_version="py2"; [ "$PANTS_USE_PYTHON3" = true ] && py_version="py3"
+  echo ${REPO_ROOT}/build-support/pants_dev_deps.${py_version}.venv
 }
 
 function activate_venv() {

build-support/python/clean.sh

@@ -3,5 +3,6 @@
 PANTS_BASE=$(dirname $0)/../..
 rm -rf ${HOME}/.pex
 rm -rf ${PANTS_BASE}/build-support/pants_dev_deps.venv
+rm -rf ${PANTS_BASE}/build-support/pants_dev_deps.py{2,3}.venv
 rm -rf ${PANTS_BASE}/.pants.d
 find ${PANTS_BASE} -name '*.pyc' | xargs rm -f

build-support/virtualenv

@@ -14,10 +14,11 @@ fi
 source ${REPO_ROOT}/build-support/common.sh
 
 if [[ -z "${PY}" ]]; then
-  if which python2.7 >/dev/null; then
-    PY=`which python2.7`
+  python_bin_name="python2.7"; [ "$PANTS_USE_PYTHON3" = true ] && python_bin_name="python3"
+  if which "${python_bin_name}" >/dev/null; then
+    PY=`which ${python_bin_name}`
   else
-    die 'No python2.7 interpreter found on the path.  Python will not work!'
+    die "No ${python_bin_name} interpreter found on the path. Python will not work!"
   fi
 fi
 

pants.ini

@@ -369,10 +369,11 @@ verify_commit: False
 
 
 [python-setup]
-# We only support pants running under 2.7 for now with 3.3+ support to be added later.
-# Any example or test targets that are meant to test interpreters outside pants own
-# acceptable set should specify an explicit compatibility constraint.
-interpreter_constraints: ["CPython>=2.7,<3"]
+# We will support Python 2 until release 1.16, at which we will drop Python 2 support and
+# require Python 3.6+ to run Pants.
+# Note this does not mean client code has to use these specified versions, only that
+# an appropriate interpreter must be discoverable.
+interpreter_constraints: ["CPython>=2.7,<3","CPython>=3.6"]
 interpreter_cache_dir: %(pants_bootstrapdir)s/python_cache/interpreters
 resolver_cache_dir: %(pants_bootstrapdir)s/python_cache/requirements
 

pants3

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+# Copyright 2018 Pants project contributors (see CONTRIBUTORS.md).
+# Licensed under the Apache License, Version 2.0 (see LICENSE).
+
+# This bootstrap script invokes Pants using a Python 3 interpreter.
+
+export PANTS_USE_PYTHON3=true
+./pants $@
+unset PANTS_USE_PYTHON3

src/docs/export.md

@@ -101,7 +101,7 @@ The following is an abbreviated export file from a command in the pants repo:
     "python_setup": {
         "interpreters": {
             "CPython-2.7.10": {
-                "binary": "/Users/user/pants/build-support/pants_dev_deps.venv/bin/python2.7",
+                "binary": "/Users/user/pants/build-support/pants_dev_deps.py2.venv/bin/python2.7",
                 "chroot": "/Users/user/pants/.pants.d/python-setup/chroots/e8da2c200f36ca0a1b8a60c12590a59209250b1a"
             }
         },

src/docs/intellij.md

@@ -44,7 +44,7 @@ SDK".
 ![image](images/intellij-new-pythonsdk.png)
 
 This will be a "local" interpreter and you'll need to select the virtual
-environment bootstrapped above; it's in `build-support/pants_dev_deps.venv`.
+environment bootstrapped above; it's in `build-support/pants_dev_deps.py2.venv` if you want to use Python 2 or `build-support/pants_dev_deps.py3.venv` if you want to use Python 3 for the underlying Pants engine.
 
 ![image](images/intellij-select-venv.png)
 

src/python/pants/backend/python/subsystems/python_setup.py

@@ -26,7 +26,7 @@ class PythonSetup(Subsystem):
   @classmethod
   def register_options(cls, register):
     super(PythonSetup, cls).register_options(register)
-    register('--interpreter-constraints', advanced=True, default=['CPython>=2.7,<3'], type=list,
+    register('--interpreter-constraints', advanced=True, default=['CPython>=2.7,<3', 'CPython>=3.6'], type=list,
              metavar='<requirement>',
              help="Constrain the selected Python interpreter.  Specify with requirement syntax, "
                   "e.g. 'CPython>=2.7,<3' (A CPython interpreter with version >=2.7 AND version <3)"