Begin deprecation process for google-cloud umbrella package (googleapis#5321)

crwilcox · web-flow · commit 71e5d4bf9474 · 2018-05-21T16:25:37.000-04:00
* Begin deprecation process for google-cloud umbrella package
diff --git a/README.rst b/README.rst
@@ -121,18 +121,6 @@ If you need support for other Google APIs, check out the
 
 .. _Google APIs Python Client library: https://github.com/google/google-api-python-client
 
-Quick Start
------------
-
-.. code-block:: console
-
-    $ pip install --upgrade google-cloud
-
-For more information on setting up your Python development environment,
-such as installing ``pip`` and ``virtualenv`` on your system, please refer
-to `Python Development Environment Setup Guide`_ for Google Cloud Platform.
-
-.. _Python Development Environment Setup Guide: https://cloud.google.com/python/setup
 
 Example Applications
 --------------------
diff --git a/legacy/google-cloud/setup-README.rst b/legacy/google-cloud/setup-README.rst
@@ -0,0 +1,40 @@
+Google Cloud Python Client
+==========================
+
+    Python idiomatic client for `Google Cloud Platform`_ services.
+
+    WARNING: The google-cloud Python package is deprecated. On June 18, 2018,
+    this package will no longer install any other packages. Please install the
+    `product-specific google-cloud-* packages`__ needed for your application.
+
+.. __: https://github.com/GoogleCloudPlatform/google-cloud-python#google-cloud-python-client
+
+.. _Google Cloud Platform: https://cloud.google.com/
+
+|pypi| |circleci| |appveyor| |coverage| |versions|
+
+-  `Homepage`_
+-  `API Documentation`_
+-  `Read The Docs Documentation`_
+
+.. _Homepage: https://googlecloudplatform.github.io/google-cloud-python/
+.. _API Documentation: https://googlecloudplatform.github.io/google-cloud-python/latest/
+.. _Read The Docs Documentation: https://google-cloud-python.readthedocs.io/en/latest/
+
+License
+-------
+
+Apache 2.0 - See `the LICENSE`_ for more information.
+
+.. _the LICENSE: https://github.com/GoogleCloudPlatform/google-cloud-python/blob/master/LICENSE
+
+.. |circleci| image:: https://circleci.com/gh/GoogleCloudPlatform/google-cloud-python.svg?style=shield
+   :target: https://circleci.com/gh/GoogleCloudPlatform/google-cloud-python
+.. |appveyor| image:: https://ci.appveyor.com/api/projects/status/github/googlecloudplatform/google-cloud-python?branch=master&svg=true
+   :target: https://ci.appveyor.com/project/GoogleCloudPlatform/google-cloud-python
+.. |coverage| image:: https://coveralls.io/repos/GoogleCloudPlatform/google-cloud-python/badge.svg?branch=master
+   :target: https://coveralls.io/r/GoogleCloudPlatform/google-cloud-python?branch=master
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud.svg
+   :target: https://pypi.org/project/google-cloud/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud.svg
+   :target: https://pypi.org/project/google-cloud/
diff --git a/legacy/google-cloud/setup.cfg b/legacy/google-cloud/setup.cfg
diff --git a/legacy/google-cloud/setup.py b/legacy/google-cloud/setup.py
@@ -13,13 +13,13 @@
 # limitations under the License.
 
 import os
+import logging
 
 from setuptools import setup
 
-
 PACKAGE_ROOT = os.path.abspath(os.path.dirname(__file__))
 
-with open(os.path.join(PACKAGE_ROOT, 'README.rst')) as file_obj:
+with open(os.path.join(PACKAGE_ROOT, 'setup-README.rst')) as file_obj:
     README = file_obj.read()
 
 # NOTE: This is duplicated throughout and we should try to
@@ -34,7 +34,7 @@
     'include_package_data': True,
     'zip_safe': False,
     'classifiers': [
-        'Development Status :: 4 - Beta',
+        'Development Status :: 7 - Inactive',
         'Intended Audience :: Developers',
         'License :: OSI Approved :: Apache Software License',
         'Operating System :: OS Independent',
@@ -76,9 +76,17 @@
 
 setup(
     name='google-cloud',
-    version='0.32.1.dev1',
+    version='0.33.0',
     description='API Client library for Google Cloud',
     long_description=README,
     install_requires=REQUIREMENTS,
     **SETUP_BASE
 )
+
+warning = "WARNING: The google-cloud Python package is deprecated. On " \
+          "June 18, 2018, this package will no longer install any other " \
+          "packages. Please install the product-specific google-cloud-* " \
+          "packages needed for your application. See " \
+          "https://github.com/GoogleCloudPlatform/google-cloud-python."
+
+logging.warn(warning)
diff --git a/nox.py b/nox.py
@@ -46,4 +46,4 @@ def lint_setup_py(session):
 
     session.install('docutils', 'Pygments')
     session.run(
-        'python', 'setup.py', 'check', '--restructuredtext', '--strict')
+        'python', 'legacy/google-cloud/setup.py', 'check', '--restructuredtext', '--strict')
