chore!: promote Dataflow to v2

googleapis · Dec 17, 2024 · 792186d · 792186d
1 parent 70dd30d
commit 792186d
Show file tree

Hide file tree

Showing 148 changed files with 590 additions and 5,696 deletions.
diff --git a/.repo-metadata-full.json b/.repo-metadata-full.json
@@ -509,7 +509,7 @@
     "Dataflow": {
         "language": "php",
         "distribution_name": "google/cloud-dataflow",
-        "release_level": "preview",
+        "release_level": "stable",
         "client_documentation": "https://cloud.google.com/php/docs/reference/cloud-dataflow/latest",
         "library_type": "GAPIC_AUTO",
         "api_shortname": "dataflow"
@@ -1599,4 +1599,4 @@
         "library_type": "GAPIC_AUTO",
         "api_shortname": "workflows"
     }
-}
+}
diff --git a/Dataflow/.OwlBot.yaml b/Dataflow/.OwlBot.yaml
@@ -1,4 +1,4 @@
 deep-copy-regex:
-    - source: /google/dataflow/v1beta3/.*-php/(.*)
-      dest: /owl-bot-staging/Dataflow/v1beta3/$1
+    - source: /google/dataflow/(v1beta3)/.*-php/(.*)
+      dest: /owl-bot-staging/Dataflow/$1/$2
 api-name: Dataflow
diff --git a/Dataflow/README.md b/Dataflow/README.md
@@ -35,9 +35,8 @@ for more information about the debugging tools.
 
 ### Version
 
-This component is considered beta. As such, it should be expected to be mostly
-stable and we're working towards a release candidate. We will address issues
-and requests with a higher priority.
+This component is considered GA (generally available). As such, it will not introduce backwards-incompatible changes in
+any minor or patch releases. We will address issues and requests with the highest priority.
 
 ### Next Steps
 

diff --git a/Dataflow/owlbot.py b/Dataflow/owlbot.py
@@ -1,4 +1,4 @@
-# Copyright 2021 Google LLC
+# Copyright 2024 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -32,37 +32,14 @@
 
 php.owlbot_main(src=src, dest=dest)
 
-# Change the wording for the deprecation warning.
+# remove class_alias code
 s.replace(
-    'src/*/*_*.php',
-    r'will be removed in the next major release',
-    'will be removed in a future release')
-
-### [START] protoc backwards compatibility fixes
-
-# roll back to private properties.
-s.replace(
-    "src/**/V*/**/*.php",
-    r"Generated from protobuf field ([^\n]{0,})\n\s{5}\*/\n\s{4}protected \$",
-    r"""Generated from protobuf field \1
-     */
-    private $""")
-
-# Replace "Unwrapped" with "Value" for method names.
-s.replace(
-    "src/**/V*/**/*.php",
-    r"public function ([s|g]\w{3,})Unwrapped",
-    r"public function \1Value"
-)
-
-### [END] protoc backwards compatibility fixes
-
-# fix relative cloud.google.com links
-s.replace(
-    "src/**/V*/**/*.php",
-    r"(.{0,})\]\((/.{0,})\)",
-    r"\1](https://cloud.google.com\2)"
-)
+    "src/V*/**/*.php",
+    r"^// Adding a class alias for backwards compatibility with the previous class name.$"
+    + "\n"
+    + r"^class_alias\(.*\);$"
+    + "\n",
+    '')
 
 # format generated clients
 subprocess.run([
@@ -72,8 +49,8 @@
     '--package=@prettier/plugin-php@^0.16',
     '--',
     'prettier',
-    '**/Gapic/*',
+    '**/Client/*',
     '--write',
     '--parser=php',
     '--single-quote',
-    '--print-width=80'])
+    '--print-width=120'])
diff --git a/Dataflow/src/V1beta3/AutoscalingEvent.php b/Dataflow/src/V1beta3/AutoscalingEvent.php
diff --git a/Dataflow/src/V1beta3/AutoscalingEvent/AutoscalingEventType.php b/Dataflow/src/V1beta3/AutoscalingEvent/AutoscalingEventType.php
diff --git a/Dataflow/src/V1beta3/AutoscalingEvent_AutoscalingEventType.php b/Dataflow/src/V1beta3/AutoscalingEvent_AutoscalingEventType.php
diff --git a/Dataflow/src/V1beta3/AutoscalingSettings.php b/Dataflow/src/V1beta3/AutoscalingSettings.php
diff --git a/Dataflow/src/V1beta3/BigQueryIODetails.php b/Dataflow/src/V1beta3/BigQueryIODetails.php
diff --git a/Dataflow/src/V1beta3/BigTableIODetails.php b/Dataflow/src/V1beta3/BigTableIODetails.php
diff --git a/Dataflow/src/V1beta3/CheckActiveJobsRequest.php b/Dataflow/src/V1beta3/CheckActiveJobsRequest.php
diff --git a/Dataflow/src/V1beta3/CheckActiveJobsResponse.php b/Dataflow/src/V1beta3/CheckActiveJobsResponse.php
diff --git a/Dataflow/src/V1beta3/Client/FlexTemplatesServiceClient.php b/Dataflow/src/V1beta3/Client/FlexTemplatesServiceClient.php
@@ -1,6 +1,6 @@
 <?php
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -36,7 +36,6 @@
 use Google\Cloud\Dataflow\V1beta3\LaunchFlexTemplateRequest;
 use Google\Cloud\Dataflow\V1beta3\LaunchFlexTemplateResponse;
 use GuzzleHttp\Promise\PromiseInterface;
-use Psr\Log\LoggerInterface;
 
 /**
  * Service Description: Provides a service for Flex templates. This feature is not ready yet.
@@ -148,9 +147,6 @@ private static function getClientDefaults()
      *     @type callable $clientCertSource
      *           A callable which returns the client cert as a string. This can be used to
      *           provide a certificate and private key to the transport layer for mTLS.
-     *     @type false|LoggerInterface $logger
-     *           A PSR-3 compliant logger. If set to false, logging is disabled, ignoring the
-     *           'GOOGLE_SDK_PHP_LOGGING' environment flag
      * }
      *
      * @throws ValidationException
@@ -198,8 +194,10 @@ public function __call($method, $args)
      *
      * @experimental
      */
-    public function launchFlexTemplate(LaunchFlexTemplateRequest $request, array $callOptions = []): LaunchFlexTemplateResponse
-    {
+    public function launchFlexTemplate(
+        LaunchFlexTemplateRequest $request,
+        array $callOptions = []
+    ): LaunchFlexTemplateResponse {
         return $this->startApiCall('LaunchFlexTemplate', $request, $callOptions)->wait();
     }
 }
diff --git a/Dataflow/src/V1beta3/Client/JobsV1Beta3Client.php b/Dataflow/src/V1beta3/Client/JobsV1Beta3Client.php
@@ -1,6 +1,6 @@
 <?php
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -44,7 +44,6 @@
 use Google\Cloud\Dataflow\V1beta3\SnapshotJobRequest;
 use Google\Cloud\Dataflow\V1beta3\UpdateJobRequest;
 use GuzzleHttp\Promise\PromiseInterface;
-use Psr\Log\LoggerInterface;
 
 /**
  * Service Description: Provides a method to create and modify Google Cloud Dataflow jobs.
@@ -163,9 +162,6 @@ private static function getClientDefaults()
      *     @type callable $clientCertSource
      *           A callable which returns the client cert as a string. This can be used to
      *           provide a certificate and private key to the transport layer for mTLS.
-     *     @type false|LoggerInterface $logger
-     *           A PSR-3 compliant logger. If set to false, logging is disabled, ignoring the
-     *           'GOOGLE_SDK_PHP_LOGGING' environment flag
      * }
      *
      * @throws ValidationException

diff --git a/Dataflow/src/V1beta3/Client/MessagesV1Beta3Client.php b/Dataflow/src/V1beta3/Client/MessagesV1Beta3Client.php
@@ -1,6 +1,6 @@
 <?php
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -36,7 +36,6 @@
 use Google\Auth\FetchAuthTokenInterface;
 use Google\Cloud\Dataflow\V1beta3\ListJobMessagesRequest;
 use GuzzleHttp\Promise\PromiseInterface;
-use Psr\Log\LoggerInterface;
 
 /**
  * Service Description: The Dataflow Messages API is used for monitoring the progress of
@@ -149,9 +148,6 @@ private static function getClientDefaults()
      *     @type callable $clientCertSource
      *           A callable which returns the client cert as a string. This can be used to
      *           provide a certificate and private key to the transport layer for mTLS.
-     *     @type false|LoggerInterface $logger
-     *           A PSR-3 compliant logger. If set to false, logging is disabled, ignoring the
-     *           'GOOGLE_SDK_PHP_LOGGING' environment flag
      * }
      *
      * @throws ValidationException

diff --git a/Dataflow/src/V1beta3/Client/MetricsV1Beta3Client.php b/Dataflow/src/V1beta3/Client/MetricsV1Beta3Client.php
@@ -1,6 +1,6 @@
 <?php
 /*
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -39,7 +39,6 @@
 use Google\Cloud\Dataflow\V1beta3\GetStageExecutionDetailsRequest;
 use Google\Cloud\Dataflow\V1beta3\JobMetrics;
 use GuzzleHttp\Promise\PromiseInterface;
-use Psr\Log\LoggerInterface;
 
 /**
  * Service Description: The Dataflow Metrics API lets you monitor the progress of Dataflow
@@ -154,9 +153,6 @@ private static function getClientDefaults()
      *     @type callable $clientCertSource
      *           A callable which returns the client cert as a string. This can be used to
      *           provide a certificate and private key to the transport layer for mTLS.
-     *     @type false|LoggerInterface $logger
-     *           A PSR-3 compliant logger. If set to false, logging is disabled, ignoring the
-     *           'GOOGLE_SDK_PHP_LOGGING' environment flag
      * }
      *
      * @throws ValidationException
@@ -206,8 +202,10 @@ public function __call($method, $args)
      *
      * @experimental
      */
-    public function getJobExecutionDetails(GetJobExecutionDetailsRequest $request, array $callOptions = []): PagedListResponse
-    {
+    public function getJobExecutionDetails(
+        GetJobExecutionDetailsRequest $request,
+        array $callOptions = []
+    ): PagedListResponse {
         return $this->startApiCall('GetJobExecutionDetails', $request, $callOptions);
     }
 
@@ -272,8 +270,10 @@ public function getJobMetrics(GetJobMetricsRequest $request, array $callOptions
      *
      * @experimental
      */
-    public function getStageExecutionDetails(GetStageExecutionDetailsRequest $request, array $callOptions = []): PagedListResponse
-    {
+    public function getStageExecutionDetails(
+        GetStageExecutionDetailsRequest $request,
+        array $callOptions = []
+    ): PagedListResponse {
         return $this->startApiCall('GetStageExecutionDetails', $request, $callOptions);
     }
 }