Add synthtool config for remaining clients (#1126)

chingor13 · dwsupplee · commit ea049593fa9d · 2018-06-27T12:03:49.000-10:00
* Add Debugger synth.py

* Copy debugger metadata

* Add Bigtable/Bigtable Admin synth script

* Add BigQueryDataTransfer synth script

* Use public synthtool api for vision

* Add Container synth config

Add Container synth config

* Add Dataproc synth config

* Add Dialogflow synth scripts

* Add Dlp synth script

* Add ErrorReporting synth script

* Add Firestore synth script

* Add Iot synth script

* Add Language synth script

* Add Logging synth script

* Add Monitoring synth script

* Add OsLogin synth script

* Add PubSub synth script

* Add Redis synth script

* Add Spanner synth script

* Add Speech synth scripts

* Add Trace synth script

* Add VideoIntelligence synth script

* Fix comments in synth scripts

* Remove `@experimenal` tags from VideoIntelligence V1 (GA)

* Fix missing documentation in Dlp

* Remove OsLogin synth script - being added separately

* Address PR comments

* Add issue link for Dlp documentation fix

* Copy partial veneers for clients without implemented partial veneers
diff --git a/src/V2/AgentsClient.php b/src/V2/AgentsClient.php
@@ -21,10 +21,6 @@
  * https://github.com/google/googleapis/blob/master/google/cloud/dialogflow/v2/agent.proto
  * and updates to that file get reflected here through a refresh process.
  *
- * EXPERIMENTAL: This client library class has not yet been declared GA (1.0). This means that
- * even though we intend the surface to be stable, we may make backwards incompatible changes
- * if necessary.
- *
  * @experimental
  */
 
diff --git a/src/V2/ContextsClient.php b/src/V2/ContextsClient.php
@@ -21,10 +21,6 @@
  * https://github.com/google/googleapis/blob/master/google/cloud/dialogflow/v2/context.proto
  * and updates to that file get reflected here through a refresh process.
  *
- * EXPERIMENTAL: This client library class has not yet been declared GA (1.0). This means that
- * even though we intend the surface to be stable, we may make backwards incompatible changes
- * if necessary.
- *
  * @experimental
  */
 
diff --git a/src/V2/EntityTypesClient.php b/src/V2/EntityTypesClient.php
@@ -21,10 +21,6 @@
  * https://github.com/google/googleapis/blob/master/google/cloud/dialogflow/v2/entity_type.proto
  * and updates to that file get reflected here through a refresh process.
  *
- * EXPERIMENTAL: This client library class has not yet been declared GA (1.0). This means that
- * even though we intend the surface to be stable, we may make backwards incompatible changes
- * if necessary.
- *
  * @experimental
  */
 
diff --git a/src/V2/Gapic/AgentsGapicClient.php b/src/V2/Gapic/AgentsGapicClient.php
@@ -21,10 +21,6 @@
  * https://github.com/google/googleapis/blob/master/google/cloud/dialogflow/v2/agent.proto
  * and updates to that file get reflected here through a refresh process.
  *
- * EXPERIMENTAL: This client library class has not yet been declared GA (1.0). This means that
- * even though we intend the surface to be stable, we may make backwards incompatible changes
- * if necessary.
- *
  * @experimental
  */
 
@@ -79,10 +75,6 @@
  * For more information about agents, see the
  * [Dialogflow documentation](https://dialogflow.com/docs/agents).
  *
- * EXPERIMENTAL: This client library class has not yet been declared GA (1.0). This means that
- * even though we intend the surface to be stable, we may make backwards incompatible changes
- * if necessary.
- *
  * This class provides the ability to make remote calls to the backing service through method
  * calls that map to API methods. Sample code to get started:
  *
diff --git a/src/V2/Gapic/ContextsGapicClient.php b/src/V2/Gapic/ContextsGapicClient.php
@@ -21,10 +21,6 @@
  * https://github.com/google/googleapis/blob/master/google/cloud/dialogflow/v2/context.proto
  * and updates to that file get reflected here through a refresh process.
  *
- * EXPERIMENTAL: This client library class has not yet been declared GA (1.0). This means that
- * even though we intend the surface to be stable, we may make backwards incompatible changes
- * if necessary.
- *
  * @experimental
  */
 
@@ -68,10 +64,6 @@
  * For more information about contexts, see the
  * [Dialogflow documentation](https://dialogflow.com/docs/contexts).
  *
- * EXPERIMENTAL: This client library class has not yet been declared GA (1.0). This means that
- * even though we intend the surface to be stable, we may make backwards incompatible changes
- * if necessary.
- *
  * This class provides the ability to make remote calls to the backing service through method
  * calls that map to API methods. Sample code to get started:
  *
diff --git a/src/V2/Gapic/EntityTypesGapicClient.php b/src/V2/Gapic/EntityTypesGapicClient.php
@@ -21,10 +21,6 @@
  * https://github.com/google/googleapis/blob/master/google/cloud/dialogflow/v2/entity_type.proto
  * and updates to that file get reflected here through a refresh process.
  *
- * EXPERIMENTAL: This client library class has not yet been declared GA (1.0). This means that
- * even though we intend the surface to be stable, we may make backwards incompatible changes
- * if necessary.
- *
  * @experimental
  */
 
@@ -89,10 +85,6 @@
  * For more information about entity types, see the
  * [Dialogflow documentation](https://dialogflow.com/docs/entities).
  *
- * EXPERIMENTAL: This client library class has not yet been declared GA (1.0). This means that
- * even though we intend the surface to be stable, we may make backwards incompatible changes
- * if necessary.
- *
  * This class provides the ability to make remote calls to the backing service through method
  * calls that map to API methods. Sample code to get started:
  *
diff --git a/src/V2/Gapic/IntentsGapicClient.php b/src/V2/Gapic/IntentsGapicClient.php
@@ -21,10 +21,6 @@
  * https://github.com/google/googleapis/blob/master/google/cloud/dialogflow/v2/intent.proto
  * and updates to that file get reflected here through a refresh process.
  *
- * EXPERIMENTAL: This client library class has not yet been declared GA (1.0). This means that
- * even though we intend the surface to be stable, we may make backwards incompatible changes
- * if necessary.
- *
  * @experimental
  */
 
@@ -89,10 +85,6 @@
  * For more information about intents, see the
  * [Dialogflow documentation](https://dialogflow.com/docs/intents).
  *
- * EXPERIMENTAL: This client library class has not yet been declared GA (1.0). This means that
- * even though we intend the surface to be stable, we may make backwards incompatible changes
- * if necessary.
- *
  * This class provides the ability to make remote calls to the backing service through method
  * calls that map to API methods. Sample code to get started:
  *
diff --git a/src/V2/Gapic/SessionEntityTypesGapicClient.php b/src/V2/Gapic/SessionEntityTypesGapicClient.php
@@ -21,10 +21,6 @@
  * https://github.com/google/googleapis/blob/master/google/cloud/dialogflow/v2/session_entity_type.proto
  * and updates to that file get reflected here through a refresh process.
  *
- * EXPERIMENTAL: This client library class has not yet been declared GA (1.0). This means that
- * even though we intend the surface to be stable, we may make backwards incompatible changes
- * if necessary.
- *
  * @experimental
  */
 
@@ -62,10 +58,6 @@
  * For more information about entity types, see the
  * [Dialogflow documentation](https://dialogflow.com/docs/entities).
  *
- * EXPERIMENTAL: This client library class has not yet been declared GA (1.0). This means that
- * even though we intend the surface to be stable, we may make backwards incompatible changes
- * if necessary.
- *
  * This class provides the ability to make remote calls to the backing service through method
  * calls that map to API methods. Sample code to get started:
  *
diff --git a/src/V2/Gapic/SessionsGapicClient.php b/src/V2/Gapic/SessionsGapicClient.php
@@ -21,10 +21,6 @@
  * https://github.com/google/googleapis/blob/master/google/cloud/dialogflow/v2/session.proto
  * and updates to that file get reflected here through a refresh process.
  *
- * EXPERIMENTAL: This client library class has not yet been declared GA (1.0). This means that
- * even though we intend the surface to be stable, we may make backwards incompatible changes
- * if necessary.
- *
  * @experimental
  */
 
@@ -52,10 +48,6 @@
  * [StreamingDetectIntent][google.cloud.dialogflow.v2.Sessions.StreamingDetectIntent]) method to determine
  * user intent and respond.
  *
- * EXPERIMENTAL: This client library class has not yet been declared GA (1.0). This means that
- * even though we intend the surface to be stable, we may make backwards incompatible changes
- * if necessary.
- *
  * This class provides the ability to make remote calls to the backing service through method
  * calls that map to API methods. Sample code to get started:
  *
diff --git a/src/V2/IntentsClient.php b/src/V2/IntentsClient.php
@@ -21,10 +21,6 @@
  * https://github.com/google/googleapis/blob/master/google/cloud/dialogflow/v2/intent.proto
  * and updates to that file get reflected here through a refresh process.
  *
- * EXPERIMENTAL: This client library class has not yet been declared GA (1.0). This means that
- * even though we intend the surface to be stable, we may make backwards incompatible changes
- * if necessary.
- *
  * @experimental
  */
 
diff --git a/src/V2/SessionEntityTypesClient.php b/src/V2/SessionEntityTypesClient.php
@@ -21,10 +21,6 @@
  * https://github.com/google/googleapis/blob/master/google/cloud/dialogflow/v2/session_entity_type.proto
  * and updates to that file get reflected here through a refresh process.
  *
- * EXPERIMENTAL: This client library class has not yet been declared GA (1.0). This means that
- * even though we intend the surface to be stable, we may make backwards incompatible changes
- * if necessary.
- *
  * @experimental
  */
 
diff --git a/src/V2/SessionsClient.php b/src/V2/SessionsClient.php
@@ -21,10 +21,6 @@
  * https://github.com/google/googleapis/blob/master/google/cloud/dialogflow/v2/session.proto
  * and updates to that file get reflected here through a refresh process.
  *
- * EXPERIMENTAL: This client library class has not yet been declared GA (1.0). This means that
- * even though we intend the surface to be stable, we may make backwards incompatible changes
- * if necessary.
- *
  * @experimental
  */
 
diff --git a/synth.py b/synth.py
@@ -0,0 +1,54 @@
+# Copyright 2018 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+import synthtool.gcp as gcp
+import logging
+
+logging.basicConfig(level=logging.DEBUG)
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+
+library = gapic.php_library(
+    service='dialogflow',
+    version='v2',
+    artman_output_name='google-cloud-dialogflow-v2')
+
+# copy all src including partial veneer classes
+s.move(library / 'src')
+
+# copy proto files to src also
+s.move(library / 'proto/src/Google/Cloud/Dialogflow', 'src/')
+s.move(library / 'tests/')
+
+# copy GPBMetadata file to metadata
+s.move(library / 'proto/src/GPBMetadata/Google/Cloud/Dialogflow', 'metadata/')
+
+# fix year
+s.replace(
+    '**/Gapic/*GapicClient.php',
+    r'Copyright \d{4}',
+    'Copyright 2018')
+for client in ['Agents', 'Contexts', 'EntityTypes', 'Intents', 'SessionEntityTypes', 'Sessions']:
+    s.replace(
+        f'**/V1/{client}Client.php',
+        r'Copyright \d{4}',
+        'Copyright 2018')
+s.replace(
+    'tests/**/V2/*Test.php',
+    r'Copyright \d{4}',
+    'Copyright 2018')
