google-cloud-billing-v1 0.3.1 → 0.5.2

data/lib/google/cloud/billing/v1/cloud_billing/credentials.rb

@@ -24,7 +24,7 @@ module Google
       module V1
         module CloudBilling
           # Credentials for the CloudBilling API.
-          class Credentials < Google::Auth::Credentials
+          class Credentials < ::Google::Auth::Credentials
             self.scope = [
               "https://www.googleapis.com/auth/cloud-platform"
             ]

data/lib/google/cloud/billing/v1/cloud_billing/paths.rb

@@ -33,7 +33,7 @@ module Google
             #
             # @param billing_account [String]
             #
-            # @return [String]
+            # @return [::String]
             def billing_account_path billing_account:
               "billingAccounts/#{billing_account}"
             end

data/lib/google/cloud/billing/v1/cloud_catalog.rb

@@ -16,5 +16,36 @@
 
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
-require "google/cloud/billing/v1/cloud_catalog/client"
+require "gapic/common"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/billing/v1/version"
+
 require "google/cloud/billing/v1/cloud_catalog/credentials"
+require "google/cloud/billing/v1/cloud_catalog/paths"
+require "google/cloud/billing/v1/cloud_catalog/client"
+
+module Google
+  module Cloud
+    module Billing
+      module V1
+        ##
+        # A catalog of Google Cloud Platform services and SKUs.
+        # Provides pricing information and metadata on Google Cloud Platform services
+        # and SKUs.
+        #
+        # To load this service and instantiate a client:
+        #
+        #     require "google/cloud/billing/v1/cloud_catalog"
+        #     client = ::Google::Cloud::Billing::V1::CloudCatalog::Client.new
+        #
+        module CloudCatalog
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "cloud_catalog", "helpers.rb"
+require "google/cloud/billing/v1/cloud_catalog/helpers" if ::File.file? helper_path

data/lib/google/cloud/billing/v1/cloud_catalog/client.rb

@@ -16,15 +16,8 @@
 
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
-require "gapic/common"
-require "gapic/config"
-require "gapic/config/method"
-
 require "google/cloud/errors"
-require "google/cloud/billing/v1/version"
 require "google/cloud/billing/v1/cloud_catalog_pb"
-require "google/cloud/billing/v1/cloud_catalog/credentials"
-require "google/cloud/billing/v1/cloud_catalog/paths"
 
 module Google
   module Cloud
@@ -47,15 +40,15 @@ module Google
             ##
             # Configure the CloudCatalog Client class.
             #
-            # See {Google::Cloud::Billing::V1::CloudCatalog::Client::Configuration}
+            # See {::Google::Cloud::Billing::V1::CloudCatalog::Client::Configuration}
             # for a description of the configuration fields.
             #
             # ## Example
             #
             # To modify the configuration for all CloudCatalog clients:
             #
-            #     Google::Cloud::Billing::V1::CloudCatalog::Client.configure do |config|
-            #       config.timeout = 10_000
+            #     ::Google::Cloud::Billing::V1::CloudCatalog::Client.configure do |config|
+            #       config.timeout = 10.0
             #     end
             #
             # @yield [config] Configure the Client client.
@@ -91,7 +84,7 @@ module Google
             # but structural changes (adding new fields, etc.) are not allowed. Structural changes
             # should be made on {Client.configure}.
             #
-            # See {Google::Cloud::Billing::V1::CloudCatalog::Client::Configuration}
+            # See {::Google::Cloud::Billing::V1::CloudCatalog::Client::Configuration}
             # for a description of the configuration fields.
             #
             # @yield [config] Configure the Client client.
@@ -112,13 +105,13 @@ module Google
             # To create a new CloudCatalog client with the default
             # configuration:
             #
-            #     client = Google::Cloud::Billing::V1::CloudCatalog::Client.new
+            #     client = ::Google::Cloud::Billing::V1::CloudCatalog::Client.new
             #
             # To create a new CloudCatalog client with a custom
             # configuration:
             #
-            #     client = Google::Cloud::Billing::V1::CloudCatalog::Client.new do |config|
-            #       config.timeout = 10_000
+            #     client = ::Google::Cloud::Billing::V1::CloudCatalog::Client.new do |config|
+            #       config.timeout = 10.0
             #     end
             #
             # @yield [config] Configure the CloudCatalog client.
@@ -143,10 +136,11 @@ module Google
               if credentials.is_a?(String) || credentials.is_a?(Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
-              @quota_project_id = credentials.respond_to?(:quota_project_id) ? credentials.quota_project_id : nil
+              @quota_project_id = @config.quota_project
+              @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
 
-              @cloud_catalog_stub = Gapic::ServiceStub.new(
-                Google::Cloud::Billing::V1::CloudCatalog::Stub,
+              @cloud_catalog_stub = ::Gapic::ServiceStub.new(
+                ::Google::Cloud::Billing::V1::CloudCatalog::Stub,
                 credentials:  credentials,
                 endpoint:     @config.endpoint,
                 channel_args: @config.channel_args,
@@ -160,41 +154,48 @@ module Google
             # Lists all public cloud services.
             #
             # @overload list_services(request, options = nil)
-            #   @param request [Google::Cloud::Billing::V1::ListServicesRequest | Hash]
-            #     Lists all public cloud services.
-            #   @param options [Gapic::CallOptions, Hash]
+            #   Pass arguments to `list_services` via a request object, either of type
+            #   {::Google::Cloud::Billing::V1::ListServicesRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Billing::V1::ListServicesRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload list_services(page_size: nil, page_token: nil)
-            #   @param page_size [Integer]
+            #   Pass arguments to `list_services` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param page_size [::Integer]
             #     Requested page size. Defaults to 5000.
-            #   @param page_token [String]
+            #   @param page_token [::String]
             #     A token identifying a page of results to return. This should be a
             #     `next_page_token` value returned from a previous `ListServices`
             #     call. If unspecified, the first page of results is returned.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [Gapic::PagedEnumerable<Google::Cloud::Billing::V1::Service>]
-            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Billing::V1::Service>]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
             #
-            # @return [Gapic::PagedEnumerable<Google::Cloud::Billing::V1::Service>]
+            # @return [::Gapic::PagedEnumerable<::Google::Cloud::Billing::V1::Service>]
             #
-            # @raise [Google::Cloud::Error] if the RPC is aborted.
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
             def list_services request, options = nil
-              raise ArgumentError, "request must be provided" if request.nil?
+              raise ::ArgumentError, "request must be provided" if request.nil?
 
-              request = Gapic::Protobuf.coerce request, to: Google::Cloud::Billing::V1::ListServicesRequest
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Billing::V1::ListServicesRequest
 
               # Converts hash and nil to an options object
-              options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
 
               # Customize the options with defaults
               metadata = @config.rpcs.list_services.metadata.to_h
 
               # Set x-goog-api-client and x-goog-user-project headers
-              metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                 lib_name: @config.lib_name, lib_version: @config.lib_version,
                 gapic_version: ::Google::Cloud::Billing::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -206,74 +207,81 @@ module Google
                                      retry_policy: @config.retry_policy
 
               @cloud_catalog_stub.call_rpc :list_services, request, options: options do |response, operation|
-                response = Gapic::PagedEnumerable.new @cloud_catalog_stub, :list_services, request, response, operation, options
+                response = ::Gapic::PagedEnumerable.new @cloud_catalog_stub, :list_services, request, response, operation, options
                 yield response, operation if block_given?
                 return response
               end
-            rescue GRPC::BadStatus => e
-              raise Google::Cloud::Error.from_error(e)
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
             end
 
             ##
             # Lists all publicly available SKUs for a given cloud service.
             #
             # @overload list_skus(request, options = nil)
-            #   @param request [Google::Cloud::Billing::V1::ListSkusRequest | Hash]
-            #     Lists all publicly available SKUs for a given cloud service.
-            #   @param options [Gapic::CallOptions, Hash]
+            #   Pass arguments to `list_skus` via a request object, either of type
+            #   {::Google::Cloud::Billing::V1::ListSkusRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Billing::V1::ListSkusRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload list_skus(parent: nil, start_time: nil, end_time: nil, currency_code: nil, page_size: nil, page_token: nil)
-            #   @param parent [String]
+            #   Pass arguments to `list_skus` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param parent [::String]
             #     Required. The name of the service.
             #     Example: "services/DA34-426B-A397"
-            #   @param start_time [Google::Protobuf::Timestamp | Hash]
+            #   @param start_time [::Google::Protobuf::Timestamp, ::Hash]
             #     Optional inclusive start time of the time range for which the pricing
             #     versions will be returned. Timestamps in the future are not allowed.
             #     The time range has to be within a single calendar month in
             #     America/Los_Angeles timezone. Time range as a whole is optional. If not
             #     specified, the latest pricing will be returned (up to 12 hours old at
             #     most).
-            #   @param end_time [Google::Protobuf::Timestamp | Hash]
+            #   @param end_time [::Google::Protobuf::Timestamp, ::Hash]
             #     Optional exclusive end time of the time range for which the pricing
             #     versions will be returned. Timestamps in the future are not allowed.
             #     The time range has to be within a single calendar month in
             #     America/Los_Angeles timezone. Time range as a whole is optional. If not
             #     specified, the latest pricing will be returned (up to 12 hours old at
             #     most).
-            #   @param currency_code [String]
+            #   @param currency_code [::String]
             #     The ISO 4217 currency code for the pricing info in the response proto.
             #     Will use the conversion rate as of start_time.
             #     Optional. If not specified USD will be used.
-            #   @param page_size [Integer]
+            #   @param page_size [::Integer]
             #     Requested page size. Defaults to 5000.
-            #   @param page_token [String]
+            #   @param page_token [::String]
             #     A token identifying a page of results to return. This should be a
             #     `next_page_token` value returned from a previous `ListSkus`
             #     call. If unspecified, the first page of results is returned.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [Gapic::PagedEnumerable<Google::Cloud::Billing::V1::Sku>]
-            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Billing::V1::Sku>]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
             #
-            # @return [Gapic::PagedEnumerable<Google::Cloud::Billing::V1::Sku>]
+            # @return [::Gapic::PagedEnumerable<::Google::Cloud::Billing::V1::Sku>]
             #
-            # @raise [Google::Cloud::Error] if the RPC is aborted.
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
             def list_skus request, options = nil
-              raise ArgumentError, "request must be provided" if request.nil?
+              raise ::ArgumentError, "request must be provided" if request.nil?
 
-              request = Gapic::Protobuf.coerce request, to: Google::Cloud::Billing::V1::ListSkusRequest
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Billing::V1::ListSkusRequest
 
               # Converts hash and nil to an options object
-              options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
 
               # Customize the options with defaults
               metadata = @config.rpcs.list_skus.metadata.to_h
 
               # Set x-goog-api-client and x-goog-user-project headers
-              metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                 lib_name: @config.lib_name, lib_version: @config.lib_version,
                 gapic_version: ::Google::Cloud::Billing::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -291,12 +299,12 @@ module Google
                                      retry_policy: @config.retry_policy
 
               @cloud_catalog_stub.call_rpc :list_skus, request, options: options do |response, operation|
-                response = Gapic::PagedEnumerable.new @cloud_catalog_stub, :list_skus, request, response, operation, options
+                response = ::Gapic::PagedEnumerable.new @cloud_catalog_stub, :list_skus, request, response, operation, options
                 yield response, operation if block_given?
                 return response
               end
-            rescue GRPC::BadStatus => e
-              raise Google::Cloud::Error.from_error(e)
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
             end
 
             ##
@@ -306,7 +314,7 @@ module Google
             # providing control over timeouts, retry behavior, logging, transport
             # parameters, and other low-level controls. Certain parameters can also be
             # applied individually to specific RPCs. See
-            # {Google::Cloud::Billing::V1::CloudCatalog::Client::Configuration::Rpcs}
+            # {::Google::Cloud::Billing::V1::CloudCatalog::Client::Configuration::Rpcs}
             # for a list of RPCs that can be configured independently.
             #
             # Configuration can be applied globally to all clients, or to a single client
@@ -317,22 +325,22 @@ module Google
             # To modify the global config, setting the timeout for list_services
             # to 20 seconds, and all remaining timeouts to 10 seconds:
             #
-            #     Google::Cloud::Billing::V1::CloudCatalog::Client.configure do |config|
-            #       config.timeout = 10_000
-            #       config.rpcs.list_services.timeout = 20_000
+            #     ::Google::Cloud::Billing::V1::CloudCatalog::Client.configure do |config|
+            #       config.timeout = 10.0
+            #       config.rpcs.list_services.timeout = 20.0
             #     end
             #
             # To apply the above configuration only to a new client:
             #
-            #     client = Google::Cloud::Billing::V1::CloudCatalog::Client.new do |config|
-            #       config.timeout = 10_000
-            #       config.rpcs.list_services.timeout = 20_000
+            #     client = ::Google::Cloud::Billing::V1::CloudCatalog::Client.new do |config|
+            #       config.timeout = 10.0
+            #       config.rpcs.list_services.timeout = 20.0
             #     end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.
             #   Defaults to `"cloudbilling.googleapis.com"`.
-            #   @return [String]
+            #   @return [::String]
             # @!attribute [rw] credentials
             #   Credentials to send with calls. You may provide any of the following types:
             #    *  (`String`) The path to a service account key file in JSON format
@@ -344,29 +352,29 @@ module Google
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials
-            #   @return [Object]
+            #   @return [::Object]
             # @!attribute [rw] scope
             #   The OAuth scopes
-            #   @return [Array<String>]
+            #   @return [::Array<::String>]
             # @!attribute [rw] lib_name
             #   The library name as recorded in instrumentation and logging
-            #   @return [String]
+            #   @return [::String]
             # @!attribute [rw] lib_version
             #   The library version as recorded in instrumentation and logging
-            #   @return [String]
+            #   @return [::String]
             # @!attribute [rw] channel_args
             #   Extra parameters passed to the gRPC channel. Note: this is ignored if a
             #   `GRPC::Core::Channel` object is provided as the credential.
-            #   @return [Hash]
+            #   @return [::Hash]
             # @!attribute [rw] interceptors
             #   An array of interceptors that are run before calls are executed.
-            #   @return [Array<GRPC::ClientInterceptor>]
+            #   @return [::Array<::GRPC::ClientInterceptor>]
             # @!attribute [rw] timeout
-            #   The call timeout in milliseconds.
-            #   @return [Numeric]
+            #   The call timeout in seconds.
+            #   @return [::Numeric]
             # @!attribute [rw] metadata
             #   Additional gRPC headers to be sent with the call.
-            #   @return [Hash{Symbol=>String}]
+            #   @return [::Hash{::Symbol=>::String}]
             # @!attribute [rw] retry_policy
             #   The retry policy. The value is a hash with the following keys:
             #    *  `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
@@ -374,25 +382,29 @@ module Google
             #    *  `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
             #    *  `:retry_codes` (*type:* `Array<String>`) - The error codes that should
             #       trigger a retry.
-            #   @return [Hash]
+            #   @return [::Hash]
+            # @!attribute [rw] quota_project
+            #   A separate project against which to charge quota.
+            #   @return [::String]
             #
             class Configuration
-              extend Gapic::Config
+              extend ::Gapic::Config
 
-              config_attr :endpoint,     "cloudbilling.googleapis.com", String
-              config_attr :credentials,  nil do |value|
+              config_attr :endpoint,      "cloudbilling.googleapis.com", ::String
+              config_attr :credentials,   nil do |value|
                 allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                 allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
                 allowed.any? { |klass| klass === value }
               end
-              config_attr :scope,        nil, String, Array, nil
-              config_attr :lib_name,     nil, String, nil
-              config_attr :lib_version,  nil, String, nil
-              config_attr(:channel_args, { "grpc.service_config_disable_resolution"=>1 }, Hash, nil)
-              config_attr :interceptors, nil, Array, nil
-              config_attr :timeout,      nil, Numeric, nil
-              config_attr :metadata,     nil, Hash, nil
-              config_attr :retry_policy, nil, Hash, Proc, nil
+              config_attr :scope,         nil, ::String, ::Array, nil
+              config_attr :lib_name,      nil, ::String, nil
+              config_attr :lib_version,   nil, ::String, nil
+              config_attr(:channel_args,  { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
+              config_attr :interceptors,  nil, ::Array, nil
+              config_attr :timeout,       nil, ::Numeric, nil
+              config_attr :metadata,      nil, ::Hash, nil
+              config_attr :retry_policy,  nil, ::Hash, ::Proc, nil
+              config_attr :quota_project, nil, ::String, nil
 
               # @private
               def initialize parent_config = nil
@@ -408,7 +420,7 @@ module Google
               def rpcs
                 @rpcs ||= begin
                   parent_rpcs = nil
-                  parent_rpcs = @parent_config.rpcs if @parent_config&.respond_to? :rpcs
+                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
                   Rpcs.new parent_rpcs
                 end
               end
@@ -433,21 +445,21 @@ module Google
               class Rpcs
                 ##
                 # RPC-specific configuration for `list_services`
-                # @return [Gapic::Config::Method]
+                # @return [::Gapic::Config::Method]
                 #
                 attr_reader :list_services
                 ##
                 # RPC-specific configuration for `list_skus`
-                # @return [Gapic::Config::Method]
+                # @return [::Gapic::Config::Method]
                 #
                 attr_reader :list_skus
 
                 # @private
                 def initialize parent_rpcs = nil
                   list_services_config = parent_rpcs&.list_services if parent_rpcs&.respond_to? :list_services
-                  @list_services = Gapic::Config::Method.new list_services_config
+                  @list_services = ::Gapic::Config::Method.new list_services_config
                   list_skus_config = parent_rpcs&.list_skus if parent_rpcs&.respond_to? :list_skus
-                  @list_skus = Gapic::Config::Method.new list_skus_config
+                  @list_skus = ::Gapic::Config::Method.new list_skus_config
 
                   yield self if block_given?
                 end
@@ -459,13 +471,3 @@ module Google
     end
   end
 end
-
-# rubocop:disable Lint/HandleExceptions
-
-# Once client is loaded, load helpers.rb if it exists.
-begin
-  require "google/cloud/billing/v1/cloud_catalog/helpers"
-rescue LoadError
-end
-
-# rubocop:enable Lint/HandleExceptions