feat: update gapic-common dependency to 1.3 and document retry jitter (#32442)

* feat: update gapic-common dependency to 1.3 and document retry jitter
docs: list Ruby 3.2+ as supported versions in README
fix: rename client variable in tests

PiperOrigin-RevId: 930120621

Source-Link: googleapis/googleapis@f7b1717

Source-Link: googleapis/googleapis-gen@e38df62
Copy-Tag: eyJwIjoiZ29vZ2xlLWNsb3VkLWRhdGFmb3JtLXYxYmV0YTEvLk93bEJvdC55YW1sIiwiaCI6ImUzOGRmNjI4NWQ5MTk4ZmU2OTFlNmQ4YjUzZTc2ZmI1MWNkZGY1Y2MifQ==

chore: Add google-cloud-common dependency to google-cloud-dataform-v1beta1

PiperOrigin-RevId: 897388845

Source-Link: googleapis/googleapis@4755f8c

Source-Link: googleapis/googleapis-gen@43c2b07
Copy-Tag: eyJwIjoiZ29vZ2xlLWNsb3VkLWRhdGFmb3JtLXYxYmV0YTEvLk93bEJvdC55YW1sIiwiaCI6IjQzYzJiMDczMjlkZTRkOGQ5OGJhNWZhNWYzYTc3YjEyZTg5OTQwNmUifQ==

docs: update SelectiveGapicGeneration usage doc

PiperOrigin-RevId: 892649773

Source-Link: googleapis/googleapis@06a20b2

Source-Link: googleapis/googleapis-gen@d9ae664
Copy-Tag: eyJwIjoiZ29vZ2xlLWNsb3VkLWRhdGFmb3JtLXYxYmV0YTEvLk93bEJvdC55YW1sIiwiaCI6ImQ5YWU2NjQ1MWY4MWM5ZGY5OWRiZGM5YjIzYmQ3NWQwMDczODBmNGUifQ==

feat: publish client batch config schema
feat: publish new error reasons
docs: fix documentation formatting
docs: update various comments
docs: update license year

PiperOrigin-RevId: 889289393

Source-Link: googleapis/googleapis@94bc991

Source-Link: googleapis/googleapis-gen@db7143a
Copy-Tag: eyJwIjoiZ29vZ2xlLWNsb3VkLWRhdGFmb3JtLXYxYmV0YTEvLk93bEJvdC55YW1sIiwiaCI6ImRiNzE0M2EzMzhhN2M3NTgzOWI0Njk4Y2IzZWE2ZjEwMTNiNGMzYzcifQ==

feat: Add irb as explicit dependency for Ruby 4.0 compatibility

PiperOrigin-RevId: 885280435

Source-Link: googleapis/googleapis@f29d228

Source-Link: googleapis/googleapis-gen@fca7136
Copy-Tag: eyJwIjoiZ29vZ2xlLWNsb3VkLWRhdGFmb3JtLXYxYmV0YTEvLk93bEJvdC55YW1sIiwiaCI6ImZjYTcxMzZjMWMwYWE5MDBjYTRmYTBhNGJhMTRmMWFlYjI5YjBiZmQifQ==

feat: Update minimum Ruby to v3.2 and required dependencies for Ruby v4.0

PiperOrigin-RevId: 883373063

Source-Link: googleapis/googleapis@e1443bf

Source-Link: googleapis/googleapis-gen@8ecc70c
Copy-Tag: eyJwIjoiZ29vZ2xlLWNsb3VkLWRhdGFmb3JtLXYxYmV0YTEvLk93bEJvdC55YW1sIiwiaCI6IjhlY2M3MGMyOTIyY2ZjNDY0OWEwNDU0YmM4ZDJlMWYzYTU4YTlkNzgifQ==

feat: upgrade protobuf from v25.7 to v31.0

PiperOrigin-RevId: 881595129

Source-Link: googleapis/googleapis@d90d23f

Source-Link: googleapis/googleapis-gen@f1a9443
Copy-Tag: eyJwIjoiZ29vZ2xlLWNsb3VkLWRhdGFmb3JtLXYxYmV0YTEvLk93bEJvdC55YW1sIiwiaCI6ImYxYTk0NDMzNjY0Zjg2NTBhNGFjYjczZDYwOWI5NDNkMmVjYmI2ZTAifQ==

feat: Update GCP Client Libraries in v1beta1 to support Folders, TeamFolders, and other relevant APIs

The v1beta1 API now includes support for Folders and TeamFolders, allowing users to organize repositories and files hierarchically and manage access controls.

New Features:
- Added TeamFolder resource and methods:
CreateTeamFolder, GetTeamFolder, UpdateTeamFolder, DeleteTeamFolder
QueryTeamFolderContents to list folder contents.
SearchTeamFolders to search for TeamFolders.
- Added Folder resource and methods:
CreateFolder, GetFolder, UpdateFolder, DeleteFolder
QueryFolderContents to list folder contents.
Added MoveFolder to move Folders between TeamFolders, other Folders, or the user root folder.
- Added MoveRepository to move Repositories between TeamFolders, Folders, or the user root folder.
- Added QueryUserRootContents to list contents of a user's root folder.
Repository resource now includes containing_folder and team_folder_name fields to indicate its location within the folder hierarchy.
- IAM methods (GetIamPolicy, SetIamPolicy, TestIamPermissions) now support Folder and TeamFolder resources for access control management
docs: A comment for field `force` in message `.google.cloud.dataform.v1beta1.DeleteRepositoryRequest` is changed
PiperOrigin-RevId: 868182714

Source-Link: googleapis/googleapis@e1c1073

Source-Link: googleapis/googleapis-gen@fcbd8c7
Copy-Tag: eyJwIjoiZ29vZ2xlLWNsb3VkLWRhdGFmb3JtLXYxYmV0YTEvLk93bEJvdC55YW1sIiwiaCI6ImZjYmQ4YzdlMmU4ODA2ZjM4YTQ0NDIwNWFiMGY5NDU4OGI5NDlkZjIifQ==

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

google-cloud-dataform-v1beta1/.owlbot-manifest.json

@@ -19,20 +19,34 @@
     "lib/google/cloud/dataform/v1beta1/dataform.rb",
     "lib/google/cloud/dataform/v1beta1/dataform/client.rb",
     "lib/google/cloud/dataform/v1beta1/dataform/credentials.rb",
+    "lib/google/cloud/dataform/v1beta1/dataform/operations.rb",
     "lib/google/cloud/dataform/v1beta1/dataform/paths.rb",
     "lib/google/cloud/dataform/v1beta1/dataform/rest.rb",
     "lib/google/cloud/dataform/v1beta1/dataform/rest/client.rb",
+    "lib/google/cloud/dataform/v1beta1/dataform/rest/operations.rb",
     "lib/google/cloud/dataform/v1beta1/dataform/rest/service_stub.rb",
     "lib/google/cloud/dataform/v1beta1/dataform_pb.rb",
     "lib/google/cloud/dataform/v1beta1/dataform_services_pb.rb",
     "lib/google/cloud/dataform/v1beta1/rest.rb",
     "lib/google/cloud/dataform/v1beta1/version.rb",
+    "lib/google/longrunning.rb",
+    "lib/google/longrunning/bindings_override.rb",
+    "lib/google/longrunning/operations.rb",
+    "lib/google/longrunning/operations/client.rb",
+    "lib/google/longrunning/operations/credentials.rb",
+    "lib/google/longrunning/operations/operations.rb",
+    "lib/google/longrunning/operations/rest.rb",
+    "lib/google/longrunning/operations/rest/client.rb",
+    "lib/google/longrunning/operations/rest/operations.rb",
+    "lib/google/longrunning/operations/rest/service_stub.rb",
+    "lib/google/longrunning/rest.rb",
     "proto_docs/README.md",
     "proto_docs/google/api/client.rb",
     "proto_docs/google/api/field_behavior.rb",
     "proto_docs/google/api/launch_stage.rb",
     "proto_docs/google/api/resource.rb",
     "proto_docs/google/cloud/dataform/v1beta1/dataform.rb",
+    "proto_docs/google/longrunning/operations.rb",
     "proto_docs/google/protobuf/any.rb",
     "proto_docs/google/protobuf/duration.rb",
     "proto_docs/google/protobuf/empty.rb",
@@ -47,13 +61,17 @@
     "snippets/dataform/commit_workspace_changes.rb",
     "snippets/dataform/compute_repository_access_token_status.rb",
     "snippets/dataform/create_compilation_result.rb",
+    "snippets/dataform/create_folder.rb",
     "snippets/dataform/create_release_config.rb",
     "snippets/dataform/create_repository.rb",
+    "snippets/dataform/create_team_folder.rb",
     "snippets/dataform/create_workflow_config.rb",
     "snippets/dataform/create_workflow_invocation.rb",
     "snippets/dataform/create_workspace.rb",
+    "snippets/dataform/delete_folder.rb",
     "snippets/dataform/delete_release_config.rb",
     "snippets/dataform/delete_repository.rb",
+    "snippets/dataform/delete_team_folder.rb",
     "snippets/dataform/delete_workflow_config.rb",
     "snippets/dataform/delete_workflow_invocation.rb",
     "snippets/dataform/delete_workspace.rb",
@@ -64,8 +82,11 @@
     "snippets/dataform/fetch_repository_history.rb",
     "snippets/dataform/get_compilation_result.rb",
     "snippets/dataform/get_config.rb",
+    "snippets/dataform/get_folder.rb",
+    "snippets/dataform/get_iam_policy.rb",
     "snippets/dataform/get_release_config.rb",
     "snippets/dataform/get_repository.rb",
+    "snippets/dataform/get_team_folder.rb",
     "snippets/dataform/get_workflow_config.rb",
     "snippets/dataform/get_workflow_invocation.rb",
     "snippets/dataform/get_workspace.rb",
@@ -79,27 +100,47 @@
     "snippets/dataform/make_directory.rb",
     "snippets/dataform/move_directory.rb",
     "snippets/dataform/move_file.rb",
+    "snippets/dataform/move_folder.rb",
+    "snippets/dataform/move_repository.rb",
     "snippets/dataform/pull_git_commits.rb",
     "snippets/dataform/push_git_commits.rb",
     "snippets/dataform/query_compilation_result_actions.rb",
     "snippets/dataform/query_directory_contents.rb",
+    "snippets/dataform/query_folder_contents.rb",
     "snippets/dataform/query_repository_directory_contents.rb",
+    "snippets/dataform/query_team_folder_contents.rb",
+    "snippets/dataform/query_user_root_contents.rb",
     "snippets/dataform/query_workflow_invocation_actions.rb",
     "snippets/dataform/read_file.rb",
     "snippets/dataform/read_repository_file.rb",
     "snippets/dataform/remove_directory.rb",
     "snippets/dataform/remove_file.rb",
     "snippets/dataform/reset_workspace_changes.rb",
     "snippets/dataform/search_files.rb",
+    "snippets/dataform/search_team_folders.rb",
+    "snippets/dataform/set_iam_policy.rb",
+    "snippets/dataform/test_iam_permissions.rb",
     "snippets/dataform/update_config.rb",
+    "snippets/dataform/update_folder.rb",
     "snippets/dataform/update_release_config.rb",
     "snippets/dataform/update_repository.rb",
+    "snippets/dataform/update_team_folder.rb",
     "snippets/dataform/update_workflow_config.rb",
     "snippets/dataform/write_file.rb",
+    "snippets/operations/cancel_operation.rb",
+    "snippets/operations/delete_operation.rb",
+    "snippets/operations/get_operation.rb",
+    "snippets/operations/list_operations.rb",
+    "snippets/operations/wait_operation.rb",
     "snippets/snippet_metadata_google.cloud.dataform.v1beta1.json",
+    "snippets/snippet_metadata_google.longrunning.json",
+    "test/google/cloud/dataform/v1beta1/dataform_operations_test.rb",
     "test/google/cloud/dataform/v1beta1/dataform_paths_test.rb",
     "test/google/cloud/dataform/v1beta1/dataform_rest_test.rb",
     "test/google/cloud/dataform/v1beta1/dataform_test.rb",
+    "test/google/longrunning/operations_operations_test.rb",
+    "test/google/longrunning/operations_rest_test.rb",
+    "test/google/longrunning/operations_test.rb",
     "test/helper.rb"
   ],
   "static": [

google-cloud-dataform-v1beta1/AUTHENTICATION.md

@@ -56,7 +56,7 @@ To configure a credentials file for an individual client initialization:
 ```ruby
 require "google/cloud/dataform/v1beta1"
 
-client = ::Google::Cloud::Dataform::V1beta1::Dataform::Client.new do |config|
+client = ::Google::Longrunning::Operations::Client.new do |config|
   config.credentials = "path/to/credentialfile.json"
 end
 ```
@@ -66,11 +66,11 @@ To configure a credentials file globally for all clients:
 ```ruby
 require "google/cloud/dataform/v1beta1"
 
-::Google::Cloud::Dataform::V1beta1::Dataform::Client.configure do |config|
+::Google::Longrunning::Operations::Client.configure do |config|
   config.credentials = "path/to/credentialfile.json"
 end
 
-client = ::Google::Cloud::Dataform::V1beta1::Dataform::Client.new
+client = ::Google::Longrunning::Operations::Client.new
 ```
 
 ### Environment Variables
@@ -100,7 +100,7 @@ require "google/cloud/dataform/v1beta1"
 
 ENV["GOOGLE_APPLICATION_CREDENTIALS"] = "path/to/credentialfile.json"
 
-client = ::Google::Cloud::Dataform::V1beta1::Dataform::Client.new
+client = ::Google::Longrunning::Operations::Client.new
 ```
 
 ### Local ADC file

google-cloud-dataform-v1beta1/README.md

@@ -32,9 +32,9 @@ In order to use this library, you first need to go through the following steps:
 ```ruby
 require "google/cloud/dataform/v1beta1"
 
-client = ::Google::Cloud::Dataform::V1beta1::Dataform::Client.new
-request = ::Google::Cloud::Dataform::V1beta1::ListRepositoriesRequest.new # (request fields as keyword arguments...)
-response = client.list_repositories request
+client = ::Google::Longrunning::Operations::Client.new
+request = ::Google::Longrunning::ListOperationsRequest.new # (request fields as keyword arguments...)
+response = client.list_operations request
 ```
 
 View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-dataform-v1beta1/latest)
@@ -75,7 +75,7 @@ constructing a client object. For example:
 require "google/cloud/dataform/v1beta1"
 require "logger"
 
-client = ::Google::Cloud::Dataform::V1beta1::Dataform::Client.new do |config|
+client = ::Google::Longrunning::Operations::Client.new do |config|
   config.logger = Logger.new "my-app.log"
 end
 ```
@@ -86,7 +86,7 @@ To browse ready to use code samples check [Google Cloud Samples](https://cloud.g
 
 ## Supported Ruby Versions
 
-This library is supported on Ruby 3.0+.
+This library is supported on Ruby 3.2+.
 
 Google provides official support for Ruby versions that are actively supported
 by Ruby Core—that is, Ruby versions that are either in normal maintenance or

google-cloud-dataform-v1beta1/Rakefile

@@ -57,8 +57,8 @@ task :acceptance, :project, :keyfile do |t, args|
   if project.nil? || keyfile.nil?
     fail "You must provide a project and keyfile. e.g. rake acceptance[test123, /path/to/keyfile.json] or GOOGLE_CLOUD_TEST_PROJECT=test123 GOOGLE_CLOUD_TEST_KEYFILE=/path/to/keyfile.json rake acceptance"
   end
-  require "google/cloud/dataform/v1beta1/dataform/credentials"
-  ::Google::Cloud::Dataform::V1beta1::Dataform::Credentials.env_vars.each do |path|
+  require "google/longrunning/operations/credentials"
+  ::Google::Longrunning::Operations::Credentials.env_vars.each do |path|
     ENV[path] = nil
   end
   ENV["GOOGLE_CLOUD_PROJECT"] = project

google-cloud-dataform-v1beta1/gapic_metadata.json

@@ -10,6 +10,71 @@
         "grpc": {
           "libraryClient": "::Google::Cloud::Dataform::V1beta1::Dataform::Client",
           "rpcs": {
+            "GetTeamFolder": {
+              "methods": [
+                "get_team_folder"
+              ]
+            },
+            "CreateTeamFolder": {
+              "methods": [
+                "create_team_folder"
+              ]
+            },
+            "UpdateTeamFolder": {
+              "methods": [
+                "update_team_folder"
+              ]
+            },
+            "DeleteTeamFolder": {
+              "methods": [
+                "delete_team_folder"
+              ]
+            },
+            "QueryTeamFolderContents": {
+              "methods": [
+                "query_team_folder_contents"
+              ]
+            },
+            "SearchTeamFolders": {
+              "methods": [
+                "search_team_folders"
+              ]
+            },
+            "GetFolder": {
+              "methods": [
+                "get_folder"
+              ]
+            },
+            "CreateFolder": {
+              "methods": [
+                "create_folder"
+              ]
+            },
+            "UpdateFolder": {
+              "methods": [
+                "update_folder"
+              ]
+            },
+            "DeleteFolder": {
+              "methods": [
+                "delete_folder"
+              ]
+            },
+            "QueryFolderContents": {
+              "methods": [
+                "query_folder_contents"
+              ]
+            },
+            "QueryUserRootContents": {
+              "methods": [
+                "query_user_root_contents"
+              ]
+            },
+            "MoveFolder": {
+              "methods": [
+                "move_folder"
+              ]
+            },
             "ListRepositories": {
               "methods": [
                 "list_repositories"
@@ -35,6 +100,11 @@
                 "delete_repository"
               ]
             },
+            "MoveRepository": {
+              "methods": [
+                "move_repository"
+              ]
+            },
             "CommitRepositoryChanges": {
               "methods": [
                 "commit_repository_changes"
@@ -279,6 +349,21 @@
               "methods": [
                 "update_config"
               ]
+            },
+            "GetIamPolicy": {
+              "methods": [
+                "get_iam_policy"
+              ]
+            },
+            "SetIamPolicy": {
+              "methods": [
+                "set_iam_policy"
+              ]
+            },
+            "TestIamPermissions": {
+              "methods": [
+                "test_iam_permissions"
+              ]
             }
           }
         }

google-cloud-dataform-v1beta1/google-cloud-dataform-v1beta1.gemspec

@@ -23,7 +23,7 @@ Gem::Specification.new do |gem|
 
   gem.required_ruby_version = ">= 3.2"
 
-  gem.add_dependency "gapic-common", "~> 1.2"
+  gem.add_dependency "gapic-common", "~> 1.3"
   gem.add_dependency "google-cloud-common", "~> 1.9"
   gem.add_dependency "google-cloud-errors", "~> 1.0"
   gem.add_dependency "google-cloud-location", "~> 1.0"

google-cloud-dataform-v1beta1/lib/google-cloud-dataform-v1beta1.rb

@@ -19,3 +19,4 @@
 # This gem does not autoload during Bundler.require. To load this gem,
 # issue explicit require statements for the packages desired, e.g.:
 # require "google/cloud/dataform/v1beta1"
+# require "google/longrunning"

google-cloud-dataform-v1beta1/lib/google/cloud/dataform/v1beta1/bindings_override.rb

@@ -64,63 +64,6 @@ def self.configure
                 body: nil
               )
             ]
-            default_config.bindings_override["google.iam.v1.IAMPolicy.GetIamPolicy"] = [
-
-              Gapic::Rest::GrpcTranscoder::HttpBinding.create_with_validation(
-                uri_method: :get,
-                uri_template: "/v1beta1/{resource}:getIamPolicy",
-                matches: [
-                  ["resource", %r{^projects/[^/]+/locations/[^/]+/repositories/[^/]+/?$}, false]
-                ],
-                body: nil
-              ),
-              Gapic::Rest::GrpcTranscoder::HttpBinding.create_with_validation(
-                uri_method: :get,
-                uri_template: "/v1beta1/{resource}:getIamPolicy",
-                matches: [
-                  ["resource", %r{^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+/?$}, false]
-                ],
-                body: nil
-              )
-            ]
-            default_config.bindings_override["google.iam.v1.IAMPolicy.SetIamPolicy"] = [
-
-              Gapic::Rest::GrpcTranscoder::HttpBinding.create_with_validation(
-                uri_method: :post,
-                uri_template: "/v1beta1/{resource}:setIamPolicy",
-                matches: [
-                  ["resource", %r{^projects/[^/]+/locations/[^/]+/repositories/[^/]+/?$}, false]
-                ],
-                body: "*"
-              ),
-              Gapic::Rest::GrpcTranscoder::HttpBinding.create_with_validation(
-                uri_method: :post,
-                uri_template: "/v1beta1/{resource}:setIamPolicy",
-                matches: [
-                  ["resource", %r{^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+/?$}, false]
-                ],
-                body: "*"
-              )
-            ]
-            default_config.bindings_override["google.iam.v1.IAMPolicy.TestIamPermissions"] = [
-
-              Gapic::Rest::GrpcTranscoder::HttpBinding.create_with_validation(
-                uri_method: :post,
-                uri_template: "/v1beta1/{resource}:testIamPermissions",
-                matches: [
-                  ["resource", %r{^projects/[^/]+/locations/[^/]+/repositories/[^/]+/?$}, false]
-                ],
-                body: "*"
-              ),
-              Gapic::Rest::GrpcTranscoder::HttpBinding.create_with_validation(
-                uri_method: :post,
-                uri_template: "/v1beta1/{resource}:testIamPermissions",
-                matches: [
-                  ["resource", %r{^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+/?$}, false]
-                ],
-                body: "*"
-              )
-            ]
             default_config
           end
           yield @configure if block_given?

google-cloud-dataform-v1beta1/lib/google/cloud/dataform/v1beta1/dataform.rb

@@ -24,6 +24,7 @@
 
 require "google/cloud/dataform/v1beta1/dataform/credentials"
 require "google/cloud/dataform/v1beta1/dataform/paths"
+require "google/cloud/dataform/v1beta1/dataform/operations"
 require "google/cloud/dataform/v1beta1/dataform/client"
 require "google/cloud/dataform/v1beta1/dataform/rest"