# frozen_string_literal: true

# Copyright 2020 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!

# Require this file early so that the version constant gets defined before
# requiring "google/cloud". This is because google-cloud-core will load the
# entrypoint (gem name) file, which in turn re-requires this file (hence
# causing a require cycle) unless the version constant is already defined.
require "google/cloud/kms/version"

require "googleauth"
gem "google-cloud-core"
require "google/cloud" unless defined? ::Google::Cloud.new
require "google/cloud/config"

# Set the default configuration
::Google::Cloud.configure.add_config! :kms do |config|
  config.add_field! :endpoint,      nil, match: ::String
  config.add_field! :credentials,   nil, match: [::String, ::Hash, ::Google::Auth::Credentials]
  config.add_field! :scope,         nil, match: [::Array, ::String]
  config.add_field! :lib_name,      nil, match: ::String
  config.add_field! :lib_version,   nil, match: ::String
  config.add_field! :interceptors,  nil, match: ::Array
  config.add_field! :timeout,       nil, match: ::Numeric
  config.add_field! :metadata,      nil, match: ::Hash
  config.add_field! :retry_policy,  nil, match: [::Hash, ::Proc]
  config.add_field! :quota_project, nil, match: ::String
  config.add_field! :universe_domain, nil, match: ::String
end

module Google
  module Cloud
    module Kms
      ##
      # Create a new client object for Autokey.
      #
      # By default, this returns an instance of
      # [Google::Cloud::Kms::V1::Autokey::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-kms-v1/latest/Google-Cloud-Kms-V1-Autokey-Client)
      # for a gRPC client for version V1 of the API.
      # However, you can specify a different API version by passing it in the
      # `version` parameter. If the Autokey service is
      # supported by that API version, and the corresponding gem is available, the
      # appropriate versioned client will be returned.
      # You can also specify a different transport by passing `:rest` or `:grpc` in
      # the `transport` parameter.
      #
      # Raises an exception if the currently installed versioned client gem for the
      # given API version does not support the given transport of the Autokey service.
      # You can determine whether the method will succeed by calling
      # {Google::Cloud::Kms.autokey_available?}.
      #
      # ## About Autokey
      #
      # Provides interfaces for using [Cloud KMS
      # Autokey](https://cloud.google.com/kms/help/autokey) to provision new
      # CryptoKeys, ready for Customer Managed
      # Encryption Key (CMEK) use, on-demand. To support certain client tooling, this
      # feature is modeled around a KeyHandle
      # resource: creating a KeyHandle in a resource
      # project and given location triggers Cloud KMS Autokey to provision a
      # CryptoKey in the configured key project and
      # the same location.
      #
      # Prior to use in a given resource project,
      # UpdateAutokeyConfig
      # should have been called on an ancestor folder, setting the key project where
      # Cloud KMS Autokey should create new
      # CryptoKeys. See documentation for additional
      # prerequisites. To check what key project, if any, is currently configured on
      # a resource project's ancestor folder, see
      # ShowEffectiveAutokeyConfig.
      #
      # @param version [::String, ::Symbol] The API version to connect to. Optional.
      #   Defaults to `:v1`.
      # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
      # @return [::Object] A client object for the specified version.
      #
      def self.autokey version: :v1, transport: :grpc, &block
        require "google/cloud/kms/#{version.to_s.downcase}"

        package_name = Google::Cloud::Kms
                       .constants
                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                       .first
        service_module = Google::Cloud::Kms.const_get(package_name).const_get(:Autokey)
        service_module = service_module.const_get(:Rest) if transport == :rest
        service_module.const_get(:Client).new(&block)
      end

      ##
      # Determines whether the Autokey service is supported by the current client.
      # If true, you can retrieve a client object by calling {Google::Cloud::Kms.autokey}.
      # If false, that method will raise an exception. This could happen if the given
      # API version does not exist or does not support the Autokey service,
      # or if the versioned client gem needs an update to support the Autokey service.
      #
      # @param version [::String, ::Symbol] The API version to connect to. Optional.
      #   Defaults to `:v1`.
      # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
      # @return [boolean] Whether the service is available.
      #
      def self.autokey_available? version: :v1, transport: :grpc
        require "google/cloud/kms/#{version.to_s.downcase}"
        package_name = Google::Cloud::Kms
                       .constants
                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                       .first
        return false unless package_name
        service_module = Google::Cloud::Kms.const_get package_name
        return false unless service_module.const_defined? :Autokey
        service_module = service_module.const_get :Autokey
        if transport == :rest
          return false unless service_module.const_defined? :Rest
          service_module = service_module.const_get :Rest
        end
        service_module.const_defined? :Client
      rescue ::LoadError
        false
      end

      ##
      # Create a new client object for AutokeyAdmin.
      #
      # By default, this returns an instance of
      # [Google::Cloud::Kms::V1::AutokeyAdmin::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-kms-v1/latest/Google-Cloud-Kms-V1-AutokeyAdmin-Client)
      # for a gRPC client for version V1 of the API.
      # However, you can specify a different API version by passing it in the
      # `version` parameter. If the AutokeyAdmin service is
      # supported by that API version, and the corresponding gem is available, the
      # appropriate versioned client will be returned.
      # You can also specify a different transport by passing `:rest` or `:grpc` in
      # the `transport` parameter.
      #
      # Raises an exception if the currently installed versioned client gem for the
      # given API version does not support the given transport of the AutokeyAdmin service.
      # You can determine whether the method will succeed by calling
      # {Google::Cloud::Kms.autokey_admin_available?}.
      #
      # ## About AutokeyAdmin
      #
      # Provides interfaces for managing [Cloud KMS
      # Autokey](https://cloud.google.com/kms/help/autokey) folder-level
      # configurations. A configuration is inherited by all descendent projects. A
      # configuration at one folder overrides any other configurations in its
      # ancestry. Setting a configuration on a folder is a prerequisite for Cloud KMS
      # Autokey, so that users working in a descendant project can request
      # provisioned CryptoKeys, ready for Customer
      # Managed Encryption Key (CMEK) use, on-demand.
      #
      # @param version [::String, ::Symbol] The API version to connect to. Optional.
      #   Defaults to `:v1`.
      # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
      # @return [::Object] A client object for the specified version.
      #
      def self.autokey_admin version: :v1, transport: :grpc, &block
        require "google/cloud/kms/#{version.to_s.downcase}"

        package_name = Google::Cloud::Kms
                       .constants
                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                       .first
        service_module = Google::Cloud::Kms.const_get(package_name).const_get(:AutokeyAdmin)
        service_module = service_module.const_get(:Rest) if transport == :rest
        service_module.const_get(:Client).new(&block)
      end

      ##
      # Determines whether the AutokeyAdmin service is supported by the current client.
      # If true, you can retrieve a client object by calling {Google::Cloud::Kms.autokey_admin}.
      # If false, that method will raise an exception. This could happen if the given
      # API version does not exist or does not support the AutokeyAdmin service,
      # or if the versioned client gem needs an update to support the AutokeyAdmin service.
      #
      # @param version [::String, ::Symbol] The API version to connect to. Optional.
      #   Defaults to `:v1`.
      # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
      # @return [boolean] Whether the service is available.
      #
      def self.autokey_admin_available? version: :v1, transport: :grpc
        require "google/cloud/kms/#{version.to_s.downcase}"
        package_name = Google::Cloud::Kms
                       .constants
                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                       .first
        return false unless package_name
        service_module = Google::Cloud::Kms.const_get package_name
        return false unless service_module.const_defined? :AutokeyAdmin
        service_module = service_module.const_get :AutokeyAdmin
        if transport == :rest
          return false unless service_module.const_defined? :Rest
          service_module = service_module.const_get :Rest
        end
        service_module.const_defined? :Client
      rescue ::LoadError
        false
      end

      ##
      # Create a new client object for EkmService.
      #
      # By default, this returns an instance of
      # [Google::Cloud::Kms::V1::EkmService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-kms-v1/latest/Google-Cloud-Kms-V1-EkmService-Client)
      # for a gRPC client for version V1 of the API.
      # However, you can specify a different API version by passing it in the
      # `version` parameter. If the EkmService service is
      # supported by that API version, and the corresponding gem is available, the
      # appropriate versioned client will be returned.
      # You can also specify a different transport by passing `:rest` or `:grpc` in
      # the `transport` parameter.
      #
      # Raises an exception if the currently installed versioned client gem for the
      # given API version does not support the given transport of the EkmService service.
      # You can determine whether the method will succeed by calling
      # {Google::Cloud::Kms.ekm_service_available?}.
      #
      # ## About EkmService
      #
      # Google Cloud Key Management EKM Service
      #
      # Manages external cryptographic keys and operations using those keys.
      # Implements a REST model with the following objects:
      # * EkmConnection
      #
      # @param version [::String, ::Symbol] The API version to connect to. Optional.
      #   Defaults to `:v1`.
      # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
      # @return [::Object] A client object for the specified version.
      #
      def self.ekm_service version: :v1, transport: :grpc, &block
        require "google/cloud/kms/#{version.to_s.downcase}"

        package_name = Google::Cloud::Kms
                       .constants
                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                       .first
        service_module = Google::Cloud::Kms.const_get(package_name).const_get(:EkmService)
        service_module = service_module.const_get(:Rest) if transport == :rest
        service_module.const_get(:Client).new(&block)
      end

      ##
      # Determines whether the EkmService service is supported by the current client.
      # If true, you can retrieve a client object by calling {Google::Cloud::Kms.ekm_service}.
      # If false, that method will raise an exception. This could happen if the given
      # API version does not exist or does not support the EkmService service,
      # or if the versioned client gem needs an update to support the EkmService service.
      #
      # @param version [::String, ::Symbol] The API version to connect to. Optional.
      #   Defaults to `:v1`.
      # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
      # @return [boolean] Whether the service is available.
      #
      def self.ekm_service_available? version: :v1, transport: :grpc
        require "google/cloud/kms/#{version.to_s.downcase}"
        package_name = Google::Cloud::Kms
                       .constants
                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                       .first
        return false unless package_name
        service_module = Google::Cloud::Kms.const_get package_name
        return false unless service_module.const_defined? :EkmService
        service_module = service_module.const_get :EkmService
        if transport == :rest
          return false unless service_module.const_defined? :Rest
          service_module = service_module.const_get :Rest
        end
        service_module.const_defined? :Client
      rescue ::LoadError
        false
      end

      ##
      # Create a new client object for KeyManagementService.
      #
      # By default, this returns an instance of
      # [Google::Cloud::Kms::V1::KeyManagementService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-kms-v1/latest/Google-Cloud-Kms-V1-KeyManagementService-Client)
      # for a gRPC client for version V1 of the API.
      # However, you can specify a different API version by passing it in the
      # `version` parameter. If the KeyManagementService service is
      # supported by that API version, and the corresponding gem is available, the
      # appropriate versioned client will be returned.
      # You can also specify a different transport by passing `:rest` or `:grpc` in
      # the `transport` parameter.
      #
      # Raises an exception if the currently installed versioned client gem for the
      # given API version does not support the given transport of the KeyManagementService service.
      # You can determine whether the method will succeed by calling
      # {Google::Cloud::Kms.key_management_service_available?}.
      #
      # ## About KeyManagementService
      #
      # Google Cloud Key Management Service
      #
      # Manages cryptographic keys and operations using those keys. Implements a REST
      # model with the following objects:
      #
      # * KeyRing
      # * CryptoKey
      # * CryptoKeyVersion
      # * ImportJob
      #
      # If you are using manual gRPC libraries, see
      # [Using gRPC with Cloud KMS](https://cloud.google.com/kms/docs/grpc).
      #
      # @param version [::String, ::Symbol] The API version to connect to. Optional.
      #   Defaults to `:v1`.
      # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
      # @return [::Object] A client object for the specified version.
      #
      def self.key_management_service version: :v1, transport: :grpc, &block
        require "google/cloud/kms/#{version.to_s.downcase}"

        package_name = Google::Cloud::Kms
                       .constants
                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                       .first
        service_module = Google::Cloud::Kms.const_get(package_name).const_get(:KeyManagementService)
        service_module = service_module.const_get(:Rest) if transport == :rest
        service_module.const_get(:Client).new(&block)
      end

      ##
      # Determines whether the KeyManagementService service is supported by the current client.
      # If true, you can retrieve a client object by calling {Google::Cloud::Kms.key_management_service}.
      # If false, that method will raise an exception. This could happen if the given
      # API version does not exist or does not support the KeyManagementService service,
      # or if the versioned client gem needs an update to support the KeyManagementService service.
      #
      # @param version [::String, ::Symbol] The API version to connect to. Optional.
      #   Defaults to `:v1`.
      # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
      # @return [boolean] Whether the service is available.
      #
      def self.key_management_service_available? version: :v1, transport: :grpc
        require "google/cloud/kms/#{version.to_s.downcase}"
        package_name = Google::Cloud::Kms
                       .constants
                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                       .first
        return false unless package_name
        service_module = Google::Cloud::Kms.const_get package_name
        return false unless service_module.const_defined? :KeyManagementService
        service_module = service_module.const_get :KeyManagementService
        if transport == :rest
          return false unless service_module.const_defined? :Rest
          service_module = service_module.const_get :Rest
        end
        service_module.const_defined? :Client
      rescue ::LoadError
        false
      end

      ##
      # Configure the google-cloud-kms library.
      #
      # The following configuration parameters are supported:
      #
      # * `credentials` (*type:* `String, Hash, Google::Auth::Credentials`) -
      #   The path to the keyfile as a String, the contents of the keyfile as a
      #   Hash, or a Google::Auth::Credentials object.
      # * `lib_name` (*type:* `String`) -
      #   The library name as recorded in instrumentation and logging.
      # * `lib_version` (*type:* `String`) -
      #   The library version as recorded in instrumentation and logging.
      # * `interceptors` (*type:* `Array<GRPC::ClientInterceptor>`) -
      #   An array of interceptors that are run before calls are executed.
      # * `timeout` (*type:* `Numeric`) -
      #   Default timeout in seconds.
      # * `metadata` (*type:* `Hash{Symbol=>String}`) -
      #   Additional headers to be sent with the call.
      # * `retry_policy` (*type:* `Hash`) -
      #   The retry policy. The value is a hash with the following keys:
      #     * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
      #     * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
      #     * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
      #     * `:retry_codes` (*type:* `Array<String>`) -
      #       The error codes that should trigger a retry.
      #
      # @return [::Google::Cloud::Config] The default configuration used by this library
      #
      def self.configure
        yield ::Google::Cloud.configure.kms if block_given?

        ::Google::Cloud.configure.kms
      end
    end
  end
end

helper_path = ::File.join __dir__, "kms", "helpers.rb"
require "google/cloud/kms/helpers" if ::File.file? helper_path
