GA and Beta Promotions (googleapis#3245)

* Make clients explicitly unpickleable. Closes googleapis#3211. * Make clients explicitly unpickleable. Closes googleapis#3211. * Add GA designator, add 1.0 version numbers. * Version changes. Eep. * Oops, Speech is still alpha. * 0.24.0, not 0.24.1 * Remove double __getstate__ goof. * Version changes. Eep. * Oops, Speech is still alpha. * Remove double __getstate__ goof. * Adding 3.6 classifier where missing and fixing bad versions. Done via "git grep '0\.24'" and "git grep '0\.23'". * Fix Noxfiles forlocal packages. * Fixing copy-pasta issue in error reporting nox config. Also fixing bad indent in same file. * Depend on stable logging in error reporting package. * Fixing lint errors in error_reporting. These were masked because error_reporting's lint nox session was linting the datastore codebase. This also means that the error reporting package has gained __all__. * Fixing a syntax error in nox config for logging. Also fixing an indent error while I was in there. * Revert "Add docs for 'result_index' usage and a system test." This reverts commit b5742aa. * Fixing docs nox session for umbrella package. Two issues: - error_reporting came BEFORE logging (which means it would try to pull in a logging dep from PyPI that doesn't exist) - dns was NOT in the list of local packages * Updating upper bound on logging in error_reporting. * Un-revert typo fix.
richkadel · Mar 30, 2017 · 13abcf6 · 13abcf6
1 parent 95b5f33
commit 13abcf6
Show file tree

Hide file tree

Showing 41 changed files with 219 additions and 141 deletions.
diff --git a/README.rst b/README.rst
@@ -15,14 +15,25 @@ Google Cloud Python Client
 .. _API Documentation: https://googlecloudplatform.github.io/google-cloud-python/stable/
 .. _Read The Docs Documentation: https://google-cloud-python.readthedocs.io/en/latest/
 
-This client library has **beta** support for the following Google
-Cloud Platform services:
+The following client libraries have **GA** support:
 
--  `Google BigQuery`_ (`BigQuery README`_)
 -  `Google Cloud Datastore`_ (`Datastore README`_)
 -  `Stackdriver Logging`_ (`Logging README`_)
 -  `Google Cloud Storage`_ (`Storage README`_)
+
+**GA** (general availability) indicates that the client library for a
+particular service is stable, and that the code surface will not change in
+backwards-incompatible ways unless either absolutely necessary (e.g. because
+of critical security issues) or with an extensive deprecation period.
+Issues and requests against GA libraries are addressed with the highest
+priority.
+
+The following client libraries have **beta** support:
+
+-  `Google BigQuery`_ (`BigQuery README`_)
 -  `Google Cloud Vision`_ (`Vision README`_)
+-  `Google Cloud Natural Language`_ (`Natural Language README`_)
+-  `Google Cloud Translation`_ (`Translation README`_)
 
 **Beta** indicates that the client library for a particular service is
 mostly stable and is being prepared for release. Issues and requests
@@ -37,8 +48,6 @@ Cloud Platform services:
 -  `Google Cloud Bigtable`_ (`Bigtable README`_)
 -  `Google Cloud DNS`_ (`DNS README`_)
 -  `Stackdriver Error Reporting`_ (`Error Reporting README`_)
--  `Google Cloud Natural Language`_ (`Natural Language README`_)
--  `Google Cloud Translation`_ (`Translation README`_)
 -  `Google Cloud Speech`_ (`Speech README`_)
 -  `Google Cloud Bigtable - HappyBase`_ (`HappyBase README`_)
 -  `Google Cloud Runtime Configuration`_ (`Runtime Config README`_)

diff --git a/bigquery/nox.py b/bigquery/nox.py
@@ -19,6 +19,9 @@
 import nox
 
 
+LOCAL_DEPS = ('../core/',)
+
+
 @nox.session
 @nox.parametrize('python_version', ['2.7', '3.4', '3.5', '3.6'])
 def unit_tests(session, python_version):
@@ -28,7 +31,7 @@ def unit_tests(session, python_version):
     session.interpreter = 'python{}'.format(python_version)
 
     # Install all test dependencies, then install this package in-place.
-    session.install('mock', 'pytest', 'pytest-cov', '../core/')
+    session.install('mock', 'pytest', 'pytest-cov', *LOCAL_DEPS)
     session.install('-e', '.')
 
     # Run py.test against the unit tests.
@@ -53,9 +56,8 @@ def system_tests(session, python_version):
 
     # Install all test dependencies, then install this package into the
     # virutalenv's dist-packages.
-    session.install('mock', 'pytest',
-                    '../core/', '../test_utils/',
-                    '../storage/')
+    session.install('mock', 'pytest', *LOCAL_DEPS)
+    session.install('../storage/', '../test_utils/')
     session.install('.')
 
     # Run py.test against the system tests.
@@ -70,7 +72,7 @@ def lint(session):
     serious code quality issues.
     """
     session.interpreter = 'python3.6'
-    session.install('flake8')
+    session.install('flake8', *LOCAL_DEPS)
     session.install('.')
     session.run('flake8', 'google/cloud/bigquery')
 

diff --git a/bigquery/setup.py b/bigquery/setup.py
@@ -44,18 +44,19 @@
         'Programming Language :: Python :: 3',
         'Programming Language :: Python :: 3.4',
         'Programming Language :: Python :: 3.5',
+        'Programming Language :: Python :: 3.6',
         'Topic :: Internet',
     ],
 }
 
 
 REQUIREMENTS = [
-    'google-cloud-core >= 0.23.1, < 0.24dev',
+    'google-cloud-core >= 0.24.0, < 0.25dev',
 ]
 
 setup(
     name='google-cloud-bigquery',
-    version='0.23.0',
+    version='0.24.0',
     description='Python Client for Google BigQuery',
     long_description=README,
     namespace_packages=[

diff --git a/bigtable/nox.py b/bigtable/nox.py
@@ -18,6 +18,9 @@
 import nox
 
 
+LOCAL_DEPS = ('../core/',)
+
+
 @nox.session
 @nox.parametrize('python_version', ['2.7', '3.4', '3.5', '3.6'])
 def unit_tests(session, python_version):
@@ -27,7 +30,7 @@ def unit_tests(session, python_version):
     session.interpreter = 'python{}'.format(python_version)
 
     # Install all test dependencies, then install this package in-place.
-    session.install('mock', 'pytest', 'pytest-cov', '../core/')
+    session.install('mock', 'pytest', 'pytest-cov', *LOCAL_DEPS)
     session.install('-e', '.')
 
     # Run py.test against the unit tests.
@@ -52,8 +55,8 @@ def system_tests(session, python_version):
 
     # Install all test dependencies, then install this package into the
     # virutalenv's dist-packages.
-    session.install('mock', 'pytest',
-                    '../core/', '../test_utils/')
+    session.install('mock', 'pytest', *LOCAL_DEPS)
+    session.install('../test_utils/')
     session.install('.')
 
     # Run py.test against the system tests.
@@ -68,7 +71,7 @@ def lint(session):
     serious code quality issues.
     """
     session.interpreter = 'python3.6'
-    session.install('flake8')
+    session.install('flake8', *LOCAL_DEPS)
     session.install('.')
     session.run('flake8', 'google/cloud/bigtable')
 

diff --git a/bigtable/setup.py b/bigtable/setup.py
@@ -44,19 +44,20 @@
         'Programming Language :: Python :: 3',
         'Programming Language :: Python :: 3.4',
         'Programming Language :: Python :: 3.5',
+        'Programming Language :: Python :: 3.6',
         'Topic :: Internet',
     ],
 }
 
 
 REQUIREMENTS = [
-    'google-cloud-core >= 0.23.1, < 0.24dev',
+    'google-cloud-core >= 0.24.0, < 0.25dev',
     'google-gax>=0.15.7, <0.16dev',
 ]
 
 setup(
     name='google-cloud-bigtable',
-    version='0.23.1',
+    version='0.24.0',
     description='Python Client for Google Cloud Bigtable',
     long_description=README,
     namespace_packages=[

diff --git a/core/setup.py b/core/setup.py
@@ -44,6 +44,7 @@
         'Programming Language :: Python :: 3',
         'Programming Language :: Python :: 3.4',
         'Programming Language :: Python :: 3.5',
+        'Programming Language :: Python :: 3.6',
         'Topic :: Internet',
     ],
 }
@@ -60,7 +61,7 @@
 
 setup(
     name='google-cloud-core',
-    version='0.23.1',
+    version='0.24.0',
     description='API Client library for Google Cloud: Core Helpers',
     long_description=README,
     namespace_packages=[

diff --git a/datastore/nox.py b/datastore/nox.py
@@ -19,6 +19,9 @@
 import nox
 
 
+LOCAL_DEPS = ('../core/',)
+
+
 @nox.session
 @nox.parametrize('python_version', ['2.7', '3.4', '3.5', '3.6'])
 def unit_tests(session, python_version):
@@ -28,7 +31,7 @@ def unit_tests(session, python_version):
     session.interpreter = 'python{}'.format(python_version)
 
     # Install all test dependencies, then install this package in-place.
-    session.install('mock', 'pytest', 'pytest-cov', '../core/')
+    session.install('mock', 'pytest', 'pytest-cov', *LOCAL_DEPS)
     session.install('-e', '.')
 
     # Run py.test against the unit tests.
@@ -53,7 +56,8 @@ def system_tests(session, python_version):
 
     # Install all test dependencies, then install this package into the
     # virutalenv's dist-packages.
-    session.install('mock', 'pytest', '../core/', '../test_utils/')
+    session.install('mock', 'pytest', *LOCAL_DEPS)
+    session.install('../test_utils/')
     session.install('.')
 
     # Run py.test against the system tests.
@@ -76,8 +80,8 @@ def doctests(session):
 
     # Install all test dependencies, then install this package into the
     # virutalenv's dist-packages.
-    session.install('mock', 'pytest', 'sphinx',
-                    '../core/', '../test_utils/')
+    session.install('mock', 'pytest', 'sphinx', *LOCAL_DEPS)
+    session.install('../test_utils/')
     session.install('.')
 
     # Run py.test against the system tests.
@@ -92,7 +96,7 @@ def lint(session):
     serious code quality issues.
     """
     session.interpreter = 'python3.6'
-    session.install('flake8')
+    session.install('flake8', *LOCAL_DEPS)
     session.install('.')
     session.run('flake8', 'google/cloud/datastore')
 

diff --git a/datastore/setup.py b/datastore/setup.py
@@ -35,7 +35,7 @@
     'include_package_data': True,
     'zip_safe': False,
     'classifiers': [
-        'Development Status :: 4 - Beta',
+        'Development Status :: 5 - Production/Stable',
         'Intended Audience :: Developers',
         'License :: OSI Approved :: Apache Software License',
         'Operating System :: OS Independent',
@@ -44,20 +44,21 @@
         'Programming Language :: Python :: 3',
         'Programming Language :: Python :: 3.4',
         'Programming Language :: Python :: 3.5',
+        'Programming Language :: Python :: 3.6',
         'Topic :: Internet',
     ],
 }
 
 
 REQUIREMENTS = [
-    'google-cloud-core >= 0.23.1, < 0.24dev',
+    'google-cloud-core >= 0.24.0, < 0.25dev',
     'google-gax>=0.15.7, <0.16dev',
     'gapic-google-cloud-datastore-v1 >= 0.15.0, < 0.16dev',
 ]
 
 setup(
     name='google-cloud-datastore',
-    version='0.23.0',
+    version='1.0.0',
     description='Python Client for Google Cloud Datastore',
     long_description=README,
     namespace_packages=[

diff --git a/dns/nox.py b/dns/nox.py
@@ -19,6 +19,9 @@
 import nox
 
 
+LOCAL_DEPS = ('../core/',)
+
+
 @nox.session
 @nox.parametrize('python_version', ['2.7', '3.4', '3.5', '3.6'])
 def unit_tests(session, python_version):
@@ -28,7 +31,7 @@ def unit_tests(session, python_version):
     session.interpreter = 'python{}'.format(python_version)
 
     # Install all test dependencies, then install this package in-place.
-    session.install('mock', 'pytest', 'pytest-cov', '../core/')
+    session.install('mock', 'pytest', 'pytest-cov', *LOCAL_DEPS)
     session.install('-e', '.')
 
     # Run py.test against the unit tests.
@@ -47,7 +50,7 @@ def lint(session):
     serious code quality issues.
     """
     session.interpreter = 'python3.6'
-    session.install('flake8')
+    session.install('flake8', *LOCAL_DEPS)
     session.install('.')
     session.run('flake8', 'google/cloud/dns')
 

diff --git a/dns/setup.py b/dns/setup.py
@@ -44,18 +44,19 @@
         'Programming Language :: Python :: 3',
         'Programming Language :: Python :: 3.4',
         'Programming Language :: Python :: 3.5',
+        'Programming Language :: Python :: 3.6',
         'Topic :: Internet',
     ],
 }
 
 
 REQUIREMENTS = [
-    'google-cloud-core >= 0.23.1, < 0.24dev',
+    'google-cloud-core >= 0.24.0, < 0.25dev',
 ]
 
 setup(
     name='google-cloud-dns',
-    version='0.23.0',
+    version='0.24.0',
     description='Python Client for Google Cloud DNS',
     long_description=README,
     namespace_packages=[

diff --git a/docs/conf.py b/docs/conf.py
@@ -69,7 +69,7 @@
 
 # General information about the project.
 project = u'google-cloud'
-copyright = u'2014, Google'
+copyright = u'2014-2017, Google'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the

diff --git a/error_reporting/google/cloud/error_reporting/__init__.py b/error_reporting/google/cloud/error_reporting/__init__.py
@@ -21,3 +21,5 @@
 from google.cloud.error_reporting.client import Client
 from google.cloud.error_reporting.client import HTTPContext
 from google.cloud.error_reporting.util import build_flask_context
+
+__all__ = ['__version__', 'Client', 'HTTPContext', 'build_flask_context']
diff --git a/error_reporting/google/cloud/error_reporting/_logging.py b/error_reporting/google/cloud/error_reporting/_logging.py
@@ -33,9 +33,9 @@ class _ErrorReportingLoggingAPI(object):
     :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
                        :class:`NoneType`
     :param credentials: The OAuth2 Credentials to use for the connection
-                        owned by this client. If not passed (and if no ``_http``
-                        object is passed), falls back to the default inferred
-                        from the environment.
+                        owned by this client. If not passed (and if no
+                        ``_http`` object is passed), falls back to the default
+                        inferred from the environment.
 
     :type _http: :class:`httplib2.Http` or class that defines ``request()``.
     :param _http: An optional HTTP object to make requests. If not passed, an

diff --git a/error_reporting/google/cloud/error_reporting/client.py b/error_reporting/google/cloud/error_reporting/client.py
@@ -86,9 +86,9 @@ class Client(ClientWithProject):
     :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
                        :class:`NoneType`
     :param credentials: The OAuth2 Credentials to use for the connection
-                        owned by this client. If not passed (and if no ``_http``
-                        object is passed), falls back to the default inferred
-                        from the environment.
+                        owned by this client. If not passed (and if no
+                        ``_http`` object is passed), falls back to the default
+                        inferred from the environment.
 
     :type _http: :class:`httplib2.Http` or class that defines ``request()``.
     :param _http: An optional HTTP object to make requests. If not passed, an

diff --git a/error_reporting/nox.py b/error_reporting/nox.py
@@ -19,6 +19,9 @@
 import nox
 
 
+LOCAL_DEPS = ('../core/', '../logging/')
+
+
 @nox.session
 @nox.parametrize('python_version', ['2.7', '3.4', '3.5', '3.6'])
 def unit_tests(session, python_version):
@@ -28,14 +31,14 @@ def unit_tests(session, python_version):
     session.interpreter = 'python{}'.format(python_version)
 
     # Install all test dependencies, then install this package in-place.
-    session.install('mock', 'pytest', 'pytest-cov', '../core/', '../logging/')
+    session.install('mock', 'pytest', 'pytest-cov', *LOCAL_DEPS)
     session.install('-e', '.')
 
     # Run py.test against the unit tests.
-    session.run('py.test', '--quiet',
-        '--cov=google.cloud.datastore', '--cov=tests.unit', '--cov-append',
-        '--cov-config=.coveragerc', '--cov-report=', '--cov-fail-under=97',
-        'tests/unit',
+    session.run(
+        'py.test', '--quiet', '--cov=google.cloud.error_reporting',
+        '--cov=tests.unit', '--cov-append', '--cov-config=.coveragerc',
+        '--cov-report=', '--cov-fail-under=97', 'tests/unit',
     )
 
 
@@ -47,9 +50,9 @@ def lint(session):
     serious code quality issues.
     """
     session.interpreter = 'python3.6'
-    session.install('flake8')
+    session.install('flake8', *LOCAL_DEPS)
     session.install('.')
-    session.run('flake8', 'google/cloud/datastore')
+    session.run('flake8', 'google/cloud/error_reporting')
 
 
 @nox.session