From 2b834a41006e200f6af0e6a63f4b6273775600c1 Mon Sep 17 00:00:00 2001 From: Ricardo Mendes Date: Mon, 15 Feb 2021 21:31:04 -0300 Subject: [PATCH 1/2] docs: improve the breaking changes readability --- UPGRADING.md | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/UPGRADING.md b/UPGRADING.md index 1fa25990..3e5f41d5 100644 --- a/UPGRADING.md +++ b/UPGRADING.md @@ -7,13 +7,15 @@ If you experience issues or have questions, please file an [issue](https://githu ## Supported Python Versions > **WARNING**: Breaking change -The 3.0.0 release requires Python 3.6+. +> +> The 3.0.0 release requires Python 3.6+. ## Method Calls > **WARNING**: Breaking change -Methods expect request objects. We provide a script that will convert most common use cases. +> +> Methods expect request objects. We provide a script that will convert most common use cases. * Install the library @@ -100,7 +102,7 @@ response = client.create_entry_group( parent=parent, entry_group_id=entry_group_id, entry_group=entry_group - ) # Make an API request. +) # Make an API request. ``` This call is invalid because it mixes `request` with a keyword argument `entry_group`. Executing this code @@ -121,8 +123,9 @@ response = client.create_entry_group( ## Enums and Types -> **WARNING**: Breaking change -The submodules `enums` and `types` have been removed. +> **WARNING**: Breaking changes +> +> The submodules `enums` and `types` have been removed; the `type` attributes were renamed to `type_` to avoid name collisions. **Before:** ```py From 3eec6fedc8cd2131b9d5dfb6c1c4ded0f63e33f0 Mon Sep 17 00:00:00 2001 From: Ricardo Mendes Date: Mon, 15 Feb 2021 21:31:21 -0300 Subject: [PATCH 2/2] docs: fix the `entry.type_` attribute name --- UPGRADING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/UPGRADING.md b/UPGRADING.md index 3e5f41d5..1046f20e 100644 --- a/UPGRADING.md +++ b/UPGRADING.md @@ -139,7 +139,7 @@ entry.type = datacatalog_v1.enums.EntryType.FILESET ```py from google.cloud import datacatalog_v1 entry = datacatalog_v1.Entry() -entry.type = datacatalog_v1.EntryType.FILESET +entry.type_ = datacatalog_v1.EntryType.FILESET ``` ## Common Resource Path Helper Methods