Merge pull request #386 from dhermes/document-supported-versions

silvolu · silvolu · commit 572b86485122 · 2014-11-24T19:02:27.000-08:00
Document our explicit Python version support.
diff --git a/README.rst b/README.rst
@@ -92,6 +92,37 @@ Contributions to this library are always welcome and highly encouraged.
 See `CONTRIBUTING <CONTRIBUTING.rst>`__ for more information on how to
 get started.
 
+Supported Python Versions
+-------------------------
+
+We support:
+
+-  `Python 2.6 <https://docs.python.org/2.6/>`__
+-  `Python 2.7 <https://docs.python.org/2.7/>`__
+
+We plan to support:
+
+-  `Python 3.3 <https://docs.python.org/3.3/>`__
+-  `Python 3.4 <https://docs.python.org/3.4/>`__
+
+Supported versions can be found in our ``tox.ini``
+`config <https://github.com/GoogleCloudPlatform/gcloud-python/blob/master/tox.ini>`__.
+
+We explicitly decided not to support
+`Python 2.5 <https://docs.python.org/2.5/>`__ due to
+`decreased usage <https://caremad.io/2013/10/a-look-at-pypi-downloads/>`__ and
+lack of continuous integration
+`support <http://blog.travis-ci.com/2013-11-18-upcoming-build-environment-updates/>`__.
+
+We also explicitly decided to support Python 3 beginning with version 3.3.
+Reasons for this include:
+
+-  Encouraging use of newest versions of Python 3
+-  Taking the lead of prominent open-source
+   `projects <http://flask.pocoo.org/docs/0.10/python3/>`__
+-  Unicode literal `support <https://www.python.org/dev/peps/pep-0414>`__ which
+   allows for a cleaner codebase that works in both Python 2 and Python 3.
+
 License
 -------
 
diff --git a/setup.py b/setup.py
@@ -7,8 +7,8 @@
     from distutils.core import setup, find_packages
 
 
-if sys.version_info <= (2, 4):
-    raise Exception('Requires Python Version 2.5 or above... exiting.')
+if sys.version_info <= (2, 5):
+    raise Exception('Requires Python Version 2.6 or above... exiting.')
 
 
 REQUIREMENTS = [
@@ -43,7 +43,6 @@
         'License :: OSI Approved :: Apache Software License',
         'Operating System :: OS Independent',
         'Programming Language :: Python :: 2',
-        'Programming Language :: Python :: 2.5',
         'Programming Language :: Python :: 2.6',
         'Programming Language :: Python :: 2.7',
         'Topic :: Internet',
