google-cloud-observability-v1 0.a → 0.1.0

data/lib/google/cloud/observability/v1/observability/paths.rb

@@ -0,0 +1,226 @@
+# frozen_string_literal: true
+
+# Copyright 2026 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Observability
+      module V1
+        module Observability
+          # Path helper methods for the Observability API.
+          module Paths
+            ##
+            # Create a fully-qualified Bucket resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/buckets/{bucket}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param bucket [String]
+            #
+            # @return [::String]
+            def bucket_path project:, location:, bucket:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/buckets/#{bucket}"
+            end
+
+            ##
+            # Create a fully-qualified Dataset resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/buckets/{bucket}/datasets/{dataset}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param bucket [String]
+            # @param dataset [String]
+            #
+            # @return [::String]
+            def dataset_path project:, location:, bucket:, dataset:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+              raise ::ArgumentError, "bucket cannot contain /" if bucket.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/buckets/#{bucket}/datasets/#{dataset}"
+            end
+
+            ##
+            # Create a fully-qualified Link resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/buckets/{bucket}/datasets/{dataset}/links/{link}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param bucket [String]
+            # @param dataset [String]
+            # @param link [String]
+            #
+            # @return [::String]
+            def link_path project:, location:, bucket:, dataset:, link:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+              raise ::ArgumentError, "bucket cannot contain /" if bucket.to_s.include? "/"
+              raise ::ArgumentError, "dataset cannot contain /" if dataset.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/buckets/#{bucket}/datasets/#{dataset}/links/#{link}"
+            end
+
+            ##
+            # Create a fully-qualified Location resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}`
+            #
+            # @param project [String]
+            # @param location [String]
+            #
+            # @return [::String]
+            def location_path project:, location:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}"
+            end
+
+            ##
+            # Create a fully-qualified Scope resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/scopes/{scope}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param scope [String]
+            #
+            # @return [::String]
+            def scope_path project:, location:, scope:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/scopes/#{scope}"
+            end
+
+            ##
+            # Create a fully-qualified Settings resource string.
+            #
+            # @overload settings_path(project:, location:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/settings`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #
+            # @overload settings_path(organization:, location:)
+            #   The resource will be in the following format:
+            #
+            #   `organizations/{organization}/locations/{location}/settings`
+            #
+            #   @param organization [String]
+            #   @param location [String]
+            #
+            # @overload settings_path(folder:, location:)
+            #   The resource will be in the following format:
+            #
+            #   `folders/{folder}/locations/{location}/settings`
+            #
+            #   @param folder [String]
+            #   @param location [String]
+            #
+            # @return [::String]
+            def settings_path **args
+              resources = {
+                "location:project" => (proc do |project:, location:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/settings"
+                end),
+                "location:organization" => (proc do |organization:, location:|
+                  raise ::ArgumentError, "organization cannot contain /" if organization.to_s.include? "/"
+
+                  "organizations/#{organization}/locations/#{location}/settings"
+                end),
+                "folder:location" => (proc do |folder:, location:|
+                  raise ::ArgumentError, "folder cannot contain /" if folder.to_s.include? "/"
+
+                  "folders/#{folder}/locations/#{location}/settings"
+                end)
+              }
+
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
+            end
+
+            ##
+            # Create a fully-qualified TraceScope resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/traceScopes/{trace_scope}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param trace_scope [String]
+            #
+            # @return [::String]
+            def trace_scope_path project:, location:, trace_scope:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/traceScopes/#{trace_scope}"
+            end
+
+            ##
+            # Create a fully-qualified View resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/buckets/{bucket}/datasets/{dataset}/views/{view}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param bucket [String]
+            # @param dataset [String]
+            # @param view [String]
+            #
+            # @return [::String]
+            def view_path project:, location:, bucket:, dataset:, view:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+              raise ::ArgumentError, "bucket cannot contain /" if bucket.to_s.include? "/"
+              raise ::ArgumentError, "dataset cannot contain /" if dataset.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/buckets/#{bucket}/datasets/#{dataset}/views/#{view}"
+            end
+
+            extend self
+          end
+        end
+      end
+    end
+  end
+end