google-cloud-api_keys-v2 0.1.0

data/lib/google/cloud/api_keys/v2/api_keys/paths.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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 ApiKeys
+      module V2
+        module ApiKeys
+          # Path helper methods for the ApiKeys API.
+          module Paths
+            ##
+            # Create a fully-qualified Key resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/keys/{key}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param key [String]
+            #
+            # @return [::String]
+            def key_path project:, location:, key:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/keys/#{key}"
+            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
+
+            extend self
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/api_keys/v2/api_keys.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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 "gapic/common"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/api_keys/v2/version"
+
+require "google/cloud/api_keys/v2/api_keys/credentials"
+require "google/cloud/api_keys/v2/api_keys/paths"
+require "google/cloud/api_keys/v2/api_keys/operations"
+require "google/cloud/api_keys/v2/api_keys/client"
+
+module Google
+  module Cloud
+    module ApiKeys
+      module V2
+        ##
+        # Manages the API keys associated with projects.
+        #
+        # To load this service and instantiate a client:
+        #
+        #     require "google/cloud/api_keys/v2/api_keys"
+        #     client = ::Google::Cloud::ApiKeys::V2::ApiKeys::Client.new
+        #
+        module ApiKeys
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "api_keys", "helpers.rb"
+require "google/cloud/api_keys/v2/api_keys/helpers" if ::File.file? helper_path

data/lib/google/cloud/api_keys/v2/version.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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 ApiKeys
+      module V2
+        VERSION = "0.1.0"
+      end
+    end
+  end
+end

data/lib/google/cloud/api_keys/v2.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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 "google/cloud/api_keys/v2/api_keys"
+require "google/cloud/api_keys/v2/version"
+
+module Google
+  module Cloud
+    module ApiKeys
+      ##
+      # To load this package, including all its services, and instantiate a client:
+      #
+      # @example
+      #
+      #     require "google/cloud/api_keys/v2"
+      #     client = ::Google::Cloud::ApiKeys::V2::ApiKeys::Client.new
+      #
+      module V2
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "v2", "_helpers.rb"
+require "google/cloud/api_keys/v2/_helpers" if ::File.file? helper_path

data/lib/google-cloud-api_keys-v2.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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!
+
+# 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/api_keys/v2"

data/proto_docs/README.md

@@ -0,0 +1,4 @@
+# API Keys V2 Protocol Buffer Documentation
+
+These files are for the YARD documentation of the generated protobuf files.
+They are not intended to be required or loaded at runtime.

data/proto_docs/google/api/apikeys/v2/apikeys.rb

@@ -0,0 +1,173 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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 ApiKeys
+      module V2
+        # Request message for `CreateKey` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The project in which the API key is created.
+        # @!attribute [rw] key
+        #   @return [::Google::Cloud::ApiKeys::V2::Key]
+        #     Required. The API key fields to set at creation time.
+        #     You can configure only the `display_name`, `restrictions`, and
+        #     `annotations` fields.
+        # @!attribute [rw] key_id
+        #   @return [::String]
+        #     User specified key id (optional). If specified, it will become the final
+        #     component of the key resource name.
+        #
+        #     The id must be unique within the project, must conform with RFC-1034,
+        #     is restricted to lower-cased letters, and has a maximum length of 63
+        #     characters. In another word, the id must match the regular
+        #     expression: `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`.
+        #
+        #     The id must NOT be a UUID-like string.
+        class CreateKeyRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for `ListKeys` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Lists all API keys associated with this project.
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. Specifies the maximum number of results to be returned at a time.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. Requests a specific page of results.
+        # @!attribute [rw] show_deleted
+        #   @return [::Boolean]
+        #     Optional. Indicate that keys deleted in the past 30 days should also be
+        #     returned.
+        class ListKeysRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for `ListKeys` method.
+        # @!attribute [rw] keys
+        #   @return [::Array<::Google::Cloud::ApiKeys::V2::Key>]
+        #     A list of API keys.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     The pagination token for the next page of results.
+        class ListKeysResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for `GetKey` method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the API key to get.
+        class GetKeyRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for `GetKeyString` method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the API key to be retrieved.
+        class GetKeyStringRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for `GetKeyString` method.
+        # @!attribute [rw] key_string
+        #   @return [::String]
+        #     An encrypted and signed value of the key.
+        class GetKeyStringResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for `UpdateKey` method.
+        # @!attribute [rw] key
+        #   @return [::Google::Cloud::ApiKeys::V2::Key]
+        #     Required. Set the `name` field to the resource name of the API key to be
+        #     updated. You can update only the `display_name`, `restrictions`, and
+        #     `annotations` fields.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     The field mask specifies which fields to be updated as part of this
+        #     request. All other fields are ignored.
+        #     Mutable fields are: `display_name`, `restrictions`, and `annotations`.
+        #     If an update mask is not provided, the service treats it as an implied mask
+        #     equivalent to all allowed fields that are set on the wire. If the field
+        #     mask has a special value "*", the service treats it equivalent to replace
+        #     all allowed mutable fields.
+        class UpdateKeyRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for `DeleteKey` method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the API key to be deleted.
+        # @!attribute [rw] etag
+        #   @return [::String]
+        #     Optional. The etag known to the client for the expected state of the key.
+        #     This is to be used for optimistic concurrency.
+        class DeleteKeyRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for `UndeleteKey` method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the API key to be undeleted.
+        class UndeleteKeyRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for `LookupKey` method.
+        # @!attribute [rw] key_string
+        #   @return [::String]
+        #     Required. Finds the project that owns the key string value.
+        class LookupKeyRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for `LookupKey` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     The project that owns the key with the value specified in the request.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     The resource name of the API key. If the API key has been purged,
+        #     resource name is empty.
+        class LookupKeyResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/api/apikeys/v2/resources.rb

@@ -0,0 +1,189 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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 ApiKeys
+      module V2
+        # The representation of a key managed by the API Keys API.
+        # @!attribute [r] name
+        #   @return [::String]
+        #     Output only. The resource name of the key.
+        #     The `name` has the form:
+        #     `projects/<PROJECT_NUMBER>/locations/global/keys/<KEY_ID>`.
+        #     For example:
+        #     `projects/123456867718/locations/global/keys/b7ff1f9f-8275-410a-94dd-3855ee9b5dd2`
+        #
+        #     NOTE: Key is a global resource; hence the only supported value for
+        #     location is `global`.
+        # @!attribute [r] uid
+        #   @return [::String]
+        #     Output only. Unique id in UUID4 format.
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     Human-readable display name of this key that you can modify.
+        #     The maximum length is 63 characters.
+        # @!attribute [r] key_string
+        #   @return [::String]
+        #     Output only. An encrypted and signed value held by this key.
+        #     This field can be accessed only through the `GetKeyString` method.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. A timestamp identifying the time this key was originally
+        #     created.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. A timestamp identifying the time this key was last
+        #     updated.
+        # @!attribute [r] delete_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. A timestamp when this key was deleted. If the resource is not deleted,
+        #     this must be empty.
+        # @!attribute [rw] annotations
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Annotations is an unstructured key-value map stored with a policy that
+        #     may be set by external tools to store and retrieve arbitrary metadata.
+        #     They are not queryable and should be preserved when modifying objects.
+        # @!attribute [rw] restrictions
+        #   @return [::Google::Cloud::ApiKeys::V2::Restrictions]
+        #     Key restrictions.
+        # @!attribute [r] etag
+        #   @return [::String]
+        #     Output only. A checksum computed by the server based on the current value of the Key
+        #     resource. This may be sent on update and delete requests to ensure the
+        #     client has an up-to-date value before proceeding.
+        #     See https://google.aip.dev/154.
+        class Key
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class AnnotationsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Describes the restrictions on the key.
+        # @!attribute [rw] browser_key_restrictions
+        #   @return [::Google::Cloud::ApiKeys::V2::BrowserKeyRestrictions]
+        #     The HTTP referrers (websites) that are allowed to use the key.
+        # @!attribute [rw] server_key_restrictions
+        #   @return [::Google::Cloud::ApiKeys::V2::ServerKeyRestrictions]
+        #     The IP addresses of callers that are allowed to use the key.
+        # @!attribute [rw] android_key_restrictions
+        #   @return [::Google::Cloud::ApiKeys::V2::AndroidKeyRestrictions]
+        #     The Android apps that are allowed to use the key.
+        # @!attribute [rw] ios_key_restrictions
+        #   @return [::Google::Cloud::ApiKeys::V2::IosKeyRestrictions]
+        #     The iOS apps that are allowed to use the key.
+        # @!attribute [rw] api_targets
+        #   @return [::Array<::Google::Cloud::ApiKeys::V2::ApiTarget>]
+        #     A restriction for a specific service and optionally one or
+        #     more specific methods. Requests are allowed if they
+        #     match any of these restrictions. If no restrictions are
+        #     specified, all targets are allowed.
+        class Restrictions
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The HTTP referrers (websites) that are allowed to use the key.
+        # @!attribute [rw] allowed_referrers
+        #   @return [::Array<::String>]
+        #     A list of regular expressions for the referrer URLs that are allowed
+        #     to make API calls with this key.
+        class BrowserKeyRestrictions
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The IP addresses of callers that are allowed to use the key.
+        # @!attribute [rw] allowed_ips
+        #   @return [::Array<::String>]
+        #     A list of the caller IP addresses that are allowed to make API calls
+        #     with this key.
+        class ServerKeyRestrictions
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The Android apps that are allowed to use the key.
+        # @!attribute [rw] allowed_applications
+        #   @return [::Array<::Google::Cloud::ApiKeys::V2::AndroidApplication>]
+        #     A list of Android applications that are allowed to make API calls with
+        #     this key.
+        class AndroidKeyRestrictions
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Identifier of an Android application for key use.
+        # @!attribute [rw] sha1_fingerprint
+        #   @return [::String]
+        #     The SHA1 fingerprint of the application. For example, both sha1 formats are
+        #     acceptable : DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09 or
+        #     DA39A3EE5E6B4B0D3255BFEF95601890AFD80709.
+        #     Output format is the latter.
+        # @!attribute [rw] package_name
+        #   @return [::String]
+        #     The package name of the application.
+        class AndroidApplication
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The iOS apps that are allowed to use the key.
+        # @!attribute [rw] allowed_bundle_ids
+        #   @return [::Array<::String>]
+        #     A list of bundle IDs that are allowed when making API calls with this key.
+        class IosKeyRestrictions
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A restriction for a specific service and optionally one or multiple
+        # specific methods. Both fields are case insensitive.
+        # @!attribute [rw] service
+        #   @return [::String]
+        #     The service for this restriction. It should be the canonical
+        #     service name, for example: `translate.googleapis.com`.
+        #     You can use [`gcloud services list`](/sdk/gcloud/reference/services/list)
+        #     to get a list of services that are enabled in the project.
+        # @!attribute [rw] methods
+        #   @return [::Array<::String>]
+        #     Optional. List of one or more methods that can be called.
+        #     If empty, all methods for the service are allowed. A wildcard
+        #     (*) can be used as the last symbol.
+        #     Valid examples:
+        #       `google.cloud.translate.v2.TranslateService.GetSupportedLanguage`
+        #       `TranslateText`
+        #       `Get*`
+        #       `translate.googleapis.com.Get*`
+        class ApiTarget
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/api/field_behavior.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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 Api
+    # An indicator of the behavior of a given field (for example, that a field
+    # is required in requests, or given as output but ignored as input).
+    # This **does not** change the behavior in protocol buffers itself; it only
+    # denotes the behavior and may affect how API tooling handles the field.
+    #
+    # Note: This enum **may** receive new values in the future.
+    module FieldBehavior
+      # Conventional default for enums. Do not use this.
+      FIELD_BEHAVIOR_UNSPECIFIED = 0
+
+      # Specifically denotes a field as optional.
+      # While all fields in protocol buffers are optional, this may be specified
+      # for emphasis if appropriate.
+      OPTIONAL = 1
+
+      # Denotes a field as required.
+      # This indicates that the field **must** be provided as part of the request,
+      # and failure to do so will cause an error (usually `INVALID_ARGUMENT`).
+      REQUIRED = 2
+
+      # Denotes a field as output only.
+      # This indicates that the field is provided in responses, but including the
+      # field in a request does nothing (the server *must* ignore it and
+      # *must not* throw an error as a result of the field's presence).
+      OUTPUT_ONLY = 3
+
+      # Denotes a field as input only.
+      # This indicates that the field is provided in requests, and the
+      # corresponding field is not included in output.
+      INPUT_ONLY = 4
+
+      # Denotes a field as immutable.
+      # This indicates that the field may be set once in a request to create a
+      # resource, but may not be changed thereafter.
+      IMMUTABLE = 5
+
+      # Denotes that a (repeated) field is an unordered list.
+      # This indicates that the service may provide the elements of the list
+      # in any arbitrary  order, rather than the order the user originally
+      # provided. Additionally, the list's order may or may not be stable.
+      UNORDERED_LIST = 6
+
+      # Denotes that this field returns a non-empty default value if not set.
+      # This indicates that if the user provides the empty value in a request,
+      # a non-empty value will be returned. The user will not be aware of what
+      # non-empty value to expect.
+      NON_EMPTY_DEFAULT = 7
+    end
+  end
+end