From c958720d4d8deecc8d3e03e563e6df2409bc630e Mon Sep 17 00:00:00 2001
From: Yoshi Automation Bot <yoshi-automation@google.com>
Date: Tue, 19 Nov 2019 10:05:05 -0800
Subject: [PATCH] fix(datalabeling): deprecate resource name helper methods
 (via synth) (#9832)

---
 .../gapic/data_labeling_service_client.py     | 63 ++++++++++++++++---
 datalabeling/synth.metadata                   | 10 +--
 2 files changed, 59 insertions(+), 14 deletions(-)

diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/gapic/data_labeling_service_client.py b/datalabeling/google/cloud/datalabeling_v1beta1/gapic/data_labeling_service_client.py
index c4de47d05a63..4fdddd3c3546 100644
--- a/datalabeling/google/cloud/datalabeling_v1beta1/gapic/data_labeling_service_client.py
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/gapic/data_labeling_service_client.py
@@ -90,7 +90,12 @@ def from_service_account_file(cls, filename, *args, **kwargs):
 
     @classmethod
     def annotated_dataset_path(cls, project, dataset, annotated_dataset):
-        """Return a fully-qualified annotated_dataset string."""
+        """DEPRECATED. Return a fully-qualified annotated_dataset string."""
+        warnings.warn(
+            "Resource name helper functions are deprecated.",
+            PendingDeprecationWarning,
+            stacklevel=1,
+        )
         return google.api_core.path_template.expand(
             "projects/{project}/datasets/{dataset}/annotatedDatasets/{annotated_dataset}",
             project=project,
@@ -100,7 +105,12 @@ def annotated_dataset_path(cls, project, dataset, annotated_dataset):
 
     @classmethod
     def annotation_spec_set_path(cls, project, annotation_spec_set):
-        """Return a fully-qualified annotation_spec_set string."""
+        """DEPRECATED. Return a fully-qualified annotation_spec_set string."""
+        warnings.warn(
+            "Resource name helper functions are deprecated.",
+            PendingDeprecationWarning,
+            stacklevel=1,
+        )
         return google.api_core.path_template.expand(
             "projects/{project}/annotationSpecSets/{annotation_spec_set}",
             project=project,
@@ -109,7 +119,12 @@ def annotation_spec_set_path(cls, project, annotation_spec_set):
 
     @classmethod
     def data_item_path(cls, project, dataset, data_item):
-        """Return a fully-qualified data_item string."""
+        """DEPRECATED. Return a fully-qualified data_item string."""
+        warnings.warn(
+            "Resource name helper functions are deprecated.",
+            PendingDeprecationWarning,
+            stacklevel=1,
+        )
         return google.api_core.path_template.expand(
             "projects/{project}/datasets/{dataset}/dataItems/{data_item}",
             project=project,
@@ -119,14 +134,24 @@ def data_item_path(cls, project, dataset, data_item):
 
     @classmethod
     def dataset_path(cls, project, dataset):
-        """Return a fully-qualified dataset string."""
+        """DEPRECATED. Return a fully-qualified dataset string."""
+        warnings.warn(
+            "Resource name helper functions are deprecated.",
+            PendingDeprecationWarning,
+            stacklevel=1,
+        )
         return google.api_core.path_template.expand(
             "projects/{project}/datasets/{dataset}", project=project, dataset=dataset
         )
 
     @classmethod
     def evaluation_path(cls, project, dataset, evaluation):
-        """Return a fully-qualified evaluation string."""
+        """DEPRECATED. Return a fully-qualified evaluation string."""
+        warnings.warn(
+            "Resource name helper functions are deprecated.",
+            PendingDeprecationWarning,
+            stacklevel=1,
+        )
         return google.api_core.path_template.expand(
             "projects/{project}/datasets/{dataset}/evaluations/{evaluation}",
             project=project,
@@ -136,7 +161,12 @@ def evaluation_path(cls, project, dataset, evaluation):
 
     @classmethod
     def evaluation_job_path(cls, project, evaluation_job):
-        """Return a fully-qualified evaluation_job string."""
+        """DEPRECATED. Return a fully-qualified evaluation_job string."""
+        warnings.warn(
+            "Resource name helper functions are deprecated.",
+            PendingDeprecationWarning,
+            stacklevel=1,
+        )
         return google.api_core.path_template.expand(
             "projects/{project}/evaluationJobs/{evaluation_job}",
             project=project,
@@ -145,7 +175,12 @@ def evaluation_job_path(cls, project, evaluation_job):
 
     @classmethod
     def example_path(cls, project, dataset, annotated_dataset, example):
-        """Return a fully-qualified example string."""
+        """DEPRECATED. Return a fully-qualified example string."""
+        warnings.warn(
+            "Resource name helper functions are deprecated.",
+            PendingDeprecationWarning,
+            stacklevel=1,
+        )
         return google.api_core.path_template.expand(
             "projects/{project}/datasets/{dataset}/annotatedDatasets/{annotated_dataset}/examples/{example}",
             project=project,
@@ -156,7 +191,12 @@ def example_path(cls, project, dataset, annotated_dataset, example):
 
     @classmethod
     def instruction_path(cls, project, instruction):
-        """Return a fully-qualified instruction string."""
+        """DEPRECATED. Return a fully-qualified instruction string."""
+        warnings.warn(
+            "Resource name helper functions are deprecated.",
+            PendingDeprecationWarning,
+            stacklevel=1,
+        )
         return google.api_core.path_template.expand(
             "projects/{project}/instructions/{instruction}",
             project=project,
@@ -165,7 +205,12 @@ def instruction_path(cls, project, instruction):
 
     @classmethod
     def project_path(cls, project):
-        """Return a fully-qualified project string."""
+        """DEPRECATED. Return a fully-qualified project string."""
+        warnings.warn(
+            "Resource name helper functions are deprecated.",
+            PendingDeprecationWarning,
+            stacklevel=1,
+        )
         return google.api_core.path_template.expand(
             "projects/{project}", project=project
         )
diff --git a/datalabeling/synth.metadata b/datalabeling/synth.metadata
index 95b5ef41dbd3..c1d9364697ff 100644
--- a/datalabeling/synth.metadata
+++ b/datalabeling/synth.metadata
@@ -1,19 +1,19 @@
 {
-  "updateTime": "2019-11-16T13:18:46.021984Z",
+  "updateTime": "2019-11-19T13:20:27.854150Z",
   "sources": [
     {
       "generator": {
         "name": "artman",
-        "version": "0.41.1",
-        "dockerImage": "googleapis/artman@sha256:545c758c76c3f779037aa259023ec3d1ef2d57d2c8cd00a222cb187d63ceac5e"
+        "version": "0.42.1",
+        "dockerImage": "googleapis/artman@sha256:c773192618c608a7a0415dd95282f841f8e6bcdef7dd760a988c93b77a64bd57"
       }
     },
     {
       "git": {
         "name": "googleapis",
         "remote": "https://github.com/googleapis/googleapis.git",
-        "sha": "c89394342a9ef70acaf73a6959e04b943fbc817b",
-        "internalRef": "280761373"
+        "sha": "d8dd7fe8d5304f7bd1c52207703d7f27d5328c5a",
+        "internalRef": "281088257"
       }
     },
     {