From 5552429f44ed291658519aacaaa3d41a775b8455 Mon Sep 17 00:00:00 2001 From: Prad Nelluru Date: Thu, 29 Aug 2019 12:27:40 -0400 Subject: [PATCH 1/7] Release 1.0.0 --- pubsub/CHANGELOG.md | 21 +++++++++++++++++++++ pubsub/setup.py | 2 +- 2 files changed, 22 insertions(+), 1 deletion(-) diff --git a/pubsub/CHANGELOG.md b/pubsub/CHANGELOG.md index 05df7382e81e..31d4b3f6055c 100644 --- a/pubsub/CHANGELOG.md +++ b/pubsub/CHANGELOG.md @@ -4,6 +4,27 @@ [1]: https://pypi.org/project/google-cloud-pubsub/#history +## 1.0.0 + +08-29-2019 09:27 PDT + +- Docs: Remove CI for gh-pages, use googleapis.dev for api_core refs. ([#9085](https://github.com/googleapis/google-cloud-python/pull/9085)) +- Add 'ReceivedMessage.delivery_attempt' field (via synth). ([#9098](https://github.com/googleapis/google-cloud-python/pull/9098)) +- [CHANGE ME] Re-generated pubsub to pick up changes in the API or client library generator. ([#9078](https://github.com/googleapis/google-cloud-python/pull/9078)) +- Pub/Sub: update docstrings for client kwargs and fix return types uris ([#9037](https://github.com/googleapis/google-cloud-python/pull/9037)) +- Remove compatability badges from READMEs. ([#9035](https://github.com/googleapis/google-cloud-python/pull/9035)) +- Remove send/recv msg size limit, update docstrings (via synth). ([#8964](https://github.com/googleapis/google-cloud-python/pull/8964)) + +### Implementation Changes + +### New Features + +### Dependencies + +### Documentation + +### Internal / Testing Changes + ## 0.45.0 07-31-2019 02:03 PDT diff --git a/pubsub/setup.py b/pubsub/setup.py index ab1d963174a5..c3a34854d87b 100644 --- a/pubsub/setup.py +++ b/pubsub/setup.py @@ -22,7 +22,7 @@ name = "google-cloud-pubsub" description = "Google Cloud Pub/Sub API client library" -version = "0.45.0" +version = "1.0.0" # Should be one of: # 'Development Status :: 3 - Alpha' # 'Development Status :: 4 - Beta' From a24b2a119d2e555d7c8967052ee6f95e849f5f83 Mon Sep 17 00:00:00 2001 From: Prad Nelluru Date: Thu, 29 Aug 2019 11:21:26 -0400 Subject: [PATCH 2/7] Update CPS Python library READMEs to indicate the library is now GA. Also add some extra notes about versioning and contributions. --- README.rst | 6 +++--- pubsub/README.rst | 24 +++++++++++++++++++++++- 2 files changed, 26 insertions(+), 4 deletions(-) diff --git a/README.rst b/README.rst index f0820498cc21..68363d6e0d8f 100644 --- a/README.rst +++ b/README.rst @@ -32,6 +32,7 @@ The following client libraries have **GA** support: - `Google Cloud Datastore`_ (`Datastore README`_) - `Google Cloud KMS`_ (`KMS README`_) - `Google Cloud Natural Language`_ (`Natural Language README`_) +- `Google Cloud Pub/Sub`_ (`Pub/Sub README`_) - `Google Cloud Scheduler`_ (`Scheduler README`_) - `Google Cloud Spanner`_ (`Spanner README`_) - `Google Cloud Speech`_ (`Speech README`_) @@ -48,6 +49,8 @@ The following client libraries have **GA** support: .. _KMS README: https://github.com/googleapis/google-cloud-python/tree/master/kms .. _Google Cloud Natural Language: https://pypi.org/project/google-cloud-language/ .. _Natural Language README: https://github.com/googleapis/google-cloud-python/tree/master/language +.. _Google Cloud Pub/Sub: https://pypi.org/project/google-cloud-pubsub/ +.. _Pub/Sub README: https://github.com/googleapis/google-cloud-python/tree/master/pubsub .. _Google Cloud Spanner: https://pypi.org/project/google-cloud-spanner .. _Spanner README: https://github.com/googleapis/google-cloud-python/tree/master/spanner .. _Google Cloud Speech: https://pypi.org/project/google-cloud-speech/ @@ -74,7 +77,6 @@ The following client libraries have **beta** support: - `Google Cloud Bigtable`_ (`Bigtable README`_) - `Google Cloud Firestore`_ (`Firestore README`_) -- `Google Cloud Pub/Sub`_ (`Pub/Sub README`_) - `Google Cloud Video Intelligence`_ (`Video Intelligence README`_) - `Google Cloud Vision`_ (`Vision README`_) @@ -82,8 +84,6 @@ The following client libraries have **beta** support: .. _Bigtable README: https://github.com/googleapis/google-cloud-python/tree/master/bigtable .. _Google Cloud Firestore: https://pypi.org/project/google-cloud-firestore/ .. _Firestore README: https://github.com/googleapis/google-cloud-python/tree/master/firestore -.. _Google Cloud Pub/Sub: https://pypi.org/project/google-cloud-pubsub/ -.. _Pub/Sub README: https://github.com/googleapis/google-cloud-python/tree/master/pubsub .. _Google Cloud Video Intelligence: https://pypi.org/project/google-cloud-videointelligence .. _Video Intelligence README: https://github.com/googleapis/google-cloud-python/tree/master/videointelligence .. _Google Cloud Vision: https://pypi.org/project/google-cloud-vision/ diff --git a/pubsub/README.rst b/pubsub/README.rst index 3014e1375686..2ccb5dcb27eb 100644 --- a/pubsub/README.rst +++ b/pubsub/README.rst @@ -1,7 +1,7 @@ Python Client for Google Cloud Pub / Sub ======================================== -|beta| |pypi| |versions| +|GA| |pypi| |versions| `Google Cloud Pub / Sub`_ is a fully-managed real-time messaging service that allows you to send and receive messages between independent applications. You @@ -192,3 +192,25 @@ For example, to use JSON Web Tokens, provide a `google.auth.jwt.Credentials`_ in .. _Credentials: https://google-auth.readthedocs.io/en/latest/reference/google.auth.credentials.html#google.auth.credentials.Credentials .. _google-auth: https://google-auth.readthedocs.io/en/latest/index.html .. _google.auth.jwt.Credentials: https://google-auth.readthedocs.io/en/latest/reference/google.auth.jwt.html#google.auth.jwt.Credentials + + +Versioning +---------- + +This library follows [Semantic Versioning](http://semver.org/). + +It is currently in major version one (``1.y.z``), which means that the public API should be considered stable. + + +Contributing +------------ + +Contributions to this library are always welcome and highly encouraged. + +See `google-cloud`'s [CONTRIBUTING] documentation and the [shared documentation](https://github.com/googleapis/google-cloud-common/blob/master/contributing/readme.md#how-to-contribute-to-gcloud) for more information on how to get started. + +Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms. See [Code of Conduct][code-of-conduct] for more information. + +[CONTRIBUTING]:https://github.com/googleapis/google-cloud-java/blob/master/CONTRIBUTING.md +[code-of-conduct]:https://github.com/googleapis/google-cloud-java/blob/master/CODE_OF_CONDUCT.md#contributor-code-of-conduct + From d8671a34ab8239594b9eff50f016182dfdcdbc1b Mon Sep 17 00:00:00 2001 From: Prad Nelluru Date: Thu, 29 Aug 2019 11:51:22 -0400 Subject: [PATCH 3/7] Fix badge image --- pubsub/README.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/pubsub/README.rst b/pubsub/README.rst index 2ccb5dcb27eb..54e5641f849f 100644 --- a/pubsub/README.rst +++ b/pubsub/README.rst @@ -19,8 +19,8 @@ independently written applications. - `Product Documentation`_ - `Client Library Documentation`_ -.. |beta| image:: https://img.shields.io/badge/support-beta-silver.svg - :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#beta-support +.. |GA| image:: https://img.shields.io/badge/support-GA-gold.svg + :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#general-availability .. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-pubsub.svg :target: https://pypi.org/project/google-cloud-pubsub/ .. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-pubsub.svg From 37382923c3d592f4969b841aacee46a048128806 Mon Sep 17 00:00:00 2001 From: Prad Nelluru Date: Thu, 29 Aug 2019 12:02:51 -0400 Subject: [PATCH 4/7] Fix rst docs --- pubsub/README.rst | 25 +++++++++++++++++++------ 1 file changed, 19 insertions(+), 6 deletions(-) diff --git a/pubsub/README.rst b/pubsub/README.rst index 54e5641f849f..a92a43087052 100644 --- a/pubsub/README.rst +++ b/pubsub/README.rst @@ -197,20 +197,33 @@ For example, to use JSON Web Tokens, provide a `google.auth.jwt.Credentials`_ in Versioning ---------- -This library follows [Semantic Versioning](http://semver.org/). +This library follows `Semantic Versioning`_. -It is currently in major version one (``1.y.z``), which means that the public API should be considered stable. +It is currently in major version one (1.y.z), which means that the public API should be considered stable. +.. _Semantic Versioning: http://semver.org/ Contributing ------------ Contributions to this library are always welcome and highly encouraged. -See `google-cloud`'s [CONTRIBUTING] documentation and the [shared documentation](https://github.com/googleapis/google-cloud-common/blob/master/contributing/readme.md#how-to-contribute-to-gcloud) for more information on how to get started. +See the `CONTRIBUTING doc`_ for more information on how to get started. -Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms. See [Code of Conduct][code-of-conduct] for more information. +.. _CONTRIBUTING doc: https://github.com/googleapis/google-cloud-python/blob/master/CONTRIBUTING.rst -[CONTRIBUTING]:https://github.com/googleapis/google-cloud-java/blob/master/CONTRIBUTING.md -[code-of-conduct]:https://github.com/googleapis/google-cloud-java/blob/master/CODE_OF_CONDUCT.md#contributor-code-of-conduct +Community +--------- +Google Cloud Platform Python developers hang out in `Slack`_ in the ``#python`` +channel, click here to `get an invitation`_. + +.. _Slack: https://googlecloud-community.slack.com +.. _get an invitation: https://gcp-slack.appspot.com/ + +License +------- + +Apache 2.0 - See `the LICENSE`_ for more information. + +.. _the LICENSE: https://github.com/googleapis/google-cloud-python/blob/master/LICENSE From c5fd26e15afeafdbe8332ad2761ab0fa343d5294 Mon Sep 17 00:00:00 2001 From: Prad Nelluru Date: Thu, 29 Aug 2019 12:51:39 -0400 Subject: [PATCH 5/7] Address comments by Peter and Bu Sun --- pubsub/CHANGELOG.md | 17 ++++++----------- pubsub/setup.py | 2 +- 2 files changed, 7 insertions(+), 12 deletions(-) diff --git a/pubsub/CHANGELOG.md b/pubsub/CHANGELOG.md index 31d4b3f6055c..613460ed1e3c 100644 --- a/pubsub/CHANGELOG.md +++ b/pubsub/CHANGELOG.md @@ -8,22 +8,17 @@ 08-29-2019 09:27 PDT -- Docs: Remove CI for gh-pages, use googleapis.dev for api_core refs. ([#9085](https://github.com/googleapis/google-cloud-python/pull/9085)) -- Add 'ReceivedMessage.delivery_attempt' field (via synth). ([#9098](https://github.com/googleapis/google-cloud-python/pull/9098)) -- [CHANGE ME] Re-generated pubsub to pick up changes in the API or client library generator. ([#9078](https://github.com/googleapis/google-cloud-python/pull/9078)) -- Pub/Sub: update docstrings for client kwargs and fix return types uris ([#9037](https://github.com/googleapis/google-cloud-python/pull/9037)) -- Remove compatability badges from READMEs. ([#9035](https://github.com/googleapis/google-cloud-python/pull/9035)) -- Remove send/recv msg size limit, update docstrings (via synth). ([#8964](https://github.com/googleapis/google-cloud-python/pull/8964)) - ### Implementation Changes - -### New Features - -### Dependencies +- Add 'ReceivedMessage.delivery_attempt' field (via synth). ([#9098](https://github.com/googleapis/google-cloud-python/pull/9098)) +- Remove send/recv msg size limit, update docstrings (via synth). ([#8964](https://github.com/googleapis/google-cloud-python/pull/8964)) ### Documentation +- Pub/Sub: update docstrings for client kwargs and fix return types uris ([#9037](https://github.com/googleapis/google-cloud-python/pull/9037)) +- Docs: Remove CI for gh-pages, use googleapis.dev for api_core refs. ([#9085](https://github.com/googleapis/google-cloud-python/pull/9085)) +- Remove compatability badges from READMEs. ([#9035](https://github.com/googleapis/google-cloud-python/pull/9035)) ### Internal / Testing Changes +- Re-generated pubsub to pick up changes in the API or client library generator. ([#9078](https://github.com/googleapis/google-cloud-python/pull/9078)) ## 0.45.0 diff --git a/pubsub/setup.py b/pubsub/setup.py index c3a34854d87b..9a13e8ae0f2c 100644 --- a/pubsub/setup.py +++ b/pubsub/setup.py @@ -27,7 +27,7 @@ # 'Development Status :: 3 - Alpha' # 'Development Status :: 4 - Beta' # 'Development Status :: 5 - Production/Stable' -release_status = "Development Status :: 4 - Beta" +release_status = "Development Status :: 5 - Production/Stable" dependencies = [ "google-api-core[grpc] >= 1.14.0, < 2.0.0dev", "grpc-google-iam-v1 >= 0.12.3, < 0.13dev", From 2c3248ccc6503818b9a6e1516cde986d3d15c12c Mon Sep 17 00:00:00 2001 From: Prad Nelluru Date: Thu, 29 Aug 2019 12:54:29 -0400 Subject: [PATCH 6/7] Update repo metadata --- pubsub/.repo-metadata.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/pubsub/.repo-metadata.json b/pubsub/.repo-metadata.json index 916011d82ca9..e14db4392f0a 100644 --- a/pubsub/.repo-metadata.json +++ b/pubsub/.repo-metadata.json @@ -4,10 +4,10 @@ "product_documentation": "https://cloud.google.com/pubsub/docs/", "client_documentation": "https://googleapis.dev/python/pubsub/latest", "issue_tracker": "https://issuetracker.google.com/savedsearches/559741", - "release_level": "beta", + "release_level": "ga", "language": "python", "repo": "googleapis/google-cloud-python", "distribution_name": "google-cloud-pubsub", "api_id": "pubsub.googleapis.com", "requires_billing": true -} \ No newline at end of file +} From 99f7bf81c3fc62203b6d9e618f60ab09ab8b3ac0 Mon Sep 17 00:00:00 2001 From: Prad Nelluru Date: Thu, 29 Aug 2019 13:09:19 -0400 Subject: [PATCH 7/7] Improve changelog entry --- pubsub/CHANGELOG.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/pubsub/CHANGELOG.md b/pubsub/CHANGELOG.md index 613460ed1e3c..347266bd85dc 100644 --- a/pubsub/CHANGELOG.md +++ b/pubsub/CHANGELOG.md @@ -13,12 +13,12 @@ - Remove send/recv msg size limit, update docstrings (via synth). ([#8964](https://github.com/googleapis/google-cloud-python/pull/8964)) ### Documentation -- Pub/Sub: update docstrings for client kwargs and fix return types uris ([#9037](https://github.com/googleapis/google-cloud-python/pull/9037)) -- Docs: Remove CI for gh-pages, use googleapis.dev for api_core refs. ([#9085](https://github.com/googleapis/google-cloud-python/pull/9085)) +- Update docstrings for client kwargs and fix return types uris ([#9037](https://github.com/googleapis/google-cloud-python/pull/9037)) +- Remove CI for gh-pages, use googleapis.dev for api_core refs. ([#9085](https://github.com/googleapis/google-cloud-python/pull/9085)) - Remove compatability badges from READMEs. ([#9035](https://github.com/googleapis/google-cloud-python/pull/9035)) ### Internal / Testing Changes -- Re-generated pubsub to pick up changes in the API or client library generator. ([#9078](https://github.com/googleapis/google-cloud-python/pull/9078)) +- Add dead-letter-policy field in preparation for its implementation (via synth) ([#9078](https://github.com/googleapis/google-cloud-python/pull/9078)) ## 0.45.0