google-cloud-retail-v2 0.3.2 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87b9f4c67fc0eb686393793f16351c68da89eabde00f3327d8b1d38efbb6ee37
-  data.tar.gz: 19537a2c1d8ae67ff434f8f7066c7eb4cc5fd1664883eba0fba0eb5de10c9c95
+  metadata.gz: 0c775217886f336442c897f7ab810d219aeb65d75cb5c1af8e31dfb884b68202
+  data.tar.gz: bc830f5824438ccfebc31eca687dabfc263c0855c5a17cff264db2b1eb22ba09
 SHA512:
-  metadata.gz: fdd2817462eddf5a7e74bba977b47475a04d10e80e6d071cd6ad2776cf4b67db03b19fa8ddfe462a9d1b13f6266f69756307ca841a8d3d87d14cbdad80c93a5b
-  data.tar.gz: c14247f18a0d53cd5a57f9b73b0bcf7b4c0d6b39dd06f226a70f0a346d9375a5b5b99c8972790a0578e69581fa136fa8ce62102431034df8544565a934714280
+  metadata.gz: 38e7ab1b9f161c0bca43f813ad1356f0267459ed35a17dd074f516e181df72284408dfe8ebf67fdd11fc00ce931d04bc862e827aaa4c82cd16c08b6df731ce99
+  data.tar.gz: 0625bfe6a8d7e15ab43af987b1946475746f47f47144c20e28fc522052e3554f21904d7651ada0247abc16100dc6a4ddfc1a44b67308bed34640ec0b392628ff

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

@@ -17,8 +17,10 @@
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
 require "google/cloud/retail/v2/catalog_service"
+require "google/cloud/retail/v2/completion_service"
 require "google/cloud/retail/v2/prediction_service"
 require "google/cloud/retail/v2/product_service"
+require "google/cloud/retail/v2/search_service"
 require "google/cloud/retail/v2/user_event_service"
 require "google/cloud/retail/v2/version"
 

data/lib/google/cloud/retail/v2/catalog_pb.rb

@@ -6,6 +6,8 @@ require 'google/protobuf'
 require 'google/api/annotations_pb'
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
+require 'google/cloud/retail/v2/common_pb'
+require 'google/cloud/retail/v2/import_config_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/retail/v2/catalog.proto", :syntax => :proto3) do
     add_message "google.cloud.retail.v2.ProductLevelConfig" do

data/lib/google/cloud/retail/v2/catalog_service/client.rb

@@ -274,10 +274,7 @@ module Google
             #     a NOT_FOUND error is returned.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Indicates which fields in the provided
-            #     {::Google::Cloud::Retail::V2::Catalog Catalog} to update. If not set, will only
-            #     update the
-            #     {::Google::Cloud::Retail::V2::Catalog#product_level_config Catalog.product_level_config}
-            #     field, which is also the only currently supported field to update.
+            #     {::Google::Cloud::Retail::V2::Catalog Catalog} to update.
             #
             #     If an unsupported or unknown field is provided, an INVALID_ARGUMENT error
             #     is returned.
@@ -327,6 +324,194 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Set a specified branch id as default branch. API methods such as
+            # {::Google::Cloud::Retail::V2::SearchService::Client#search SearchService.Search},
+            # {::Google::Cloud::Retail::V2::ProductService::Client#get_product ProductService.GetProduct},
+            # {::Google::Cloud::Retail::V2::ProductService::Client#list_products ProductService.ListProducts}
+            # will treat requests using "default_branch" to the actual branch id set as
+            # default.
+            #
+            # For example, if `projects/*/locations/*/catalogs/*/branches/1` is set as
+            # default, setting
+            # {::Google::Cloud::Retail::V2::SearchRequest#branch SearchRequest.branch} to
+            # `projects/*/locations/*/catalogs/*/branches/default_branch` is equivalent
+            # to setting
+            # {::Google::Cloud::Retail::V2::SearchRequest#branch SearchRequest.branch} to
+            # `projects/*/locations/*/catalogs/*/branches/1`.
+            #
+            # Using multiple branches can be useful when developers would like
+            # to have a staging branch to test and verify for future usage. When it
+            # becomes ready, developers switch on the staging branch using this API while
+            # keeping using `projects/*/locations/*/catalogs/*/branches/default_branch`
+            # as {::Google::Cloud::Retail::V2::SearchRequest#branch SearchRequest.branch} to
+            # route the traffic to this staging branch.
+            #
+            # CAUTION: If you have live predict/search traffic, switching the default
+            # branch could potentially cause outages if the ID space of the new branch is
+            # very different from the old one.
+            #
+            # More specifically:
+            #
+            # * PredictionService will only return product IDs from branch \\{newBranch}.
+            # * SearchService will only return product IDs from branch \\{newBranch}
+            #   (if branch is not explicitly set).
+            # * UserEventService will only join events with products from branch
+            #   \\{newBranch}.
+            #
+            # This feature is only available for users who have Retail Search enabled.
+            # Contact Retail Support (retail-search-support@google.com) if you are
+            # interested in using Retail Search.
+            #
+            # @overload set_default_branch(request, options = nil)
+            #   Pass arguments to `set_default_branch` via a request object, either of type
+            #   {::Google::Cloud::Retail::V2::SetDefaultBranchRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Retail::V2::SetDefaultBranchRequest, ::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 set_default_branch(catalog: nil, branch_id: nil, note: nil)
+            #   Pass arguments to `set_default_branch` 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 catalog [::String]
+            #     Full resource name of the catalog, such as
+            #     `projects/*/locations/global/catalogs/default_catalog`.
+            #   @param branch_id [::String]
+            #     The final component of the resource name of a branch.
+            #
+            #     This field must be one of "0", "1" or "2". Otherwise, an INVALID_ARGUMENT
+            #     error is returned.
+            #   @param note [::String]
+            #     Some note on this request, this can be retrieved by
+            #     {::Google::Cloud::Retail::V2::CatalogService::Client#get_default_branch CatalogService.GetDefaultBranch}
+            #     before next valid default branch set occurs.
+            #
+            #     This field must be a UTF-8 encoded string with a length limit of 1,000
+            #     characters. Otherwise, an INVALID_ARGUMENT error is returned.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Protobuf::Empty]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Protobuf::Empty]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def set_default_branch request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Retail::V2::SetDefaultBranchRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.set_default_branch.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 \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Retail::V2::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {
+                "catalog" => request.catalog
+              }
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.set_default_branch.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.set_default_branch.retry_policy
+              options.apply_defaults metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @catalog_service_stub.call_rpc :set_default_branch, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
+            ##
+            # Get which branch is currently default branch set by
+            # {::Google::Cloud::Retail::V2::CatalogService::Client#set_default_branch CatalogService.SetDefaultBranch}
+            # method under a specified parent catalog.
+            #
+            # This feature is only available for users who have Retail Search enabled.
+            # Contact Retail Support (retail-search-support@google.com) if you are
+            # interested in using Retail Search.
+            #
+            # @overload get_default_branch(request, options = nil)
+            #   Pass arguments to `get_default_branch` via a request object, either of type
+            #   {::Google::Cloud::Retail::V2::GetDefaultBranchRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Retail::V2::GetDefaultBranchRequest, ::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 get_default_branch(catalog: nil)
+            #   Pass arguments to `get_default_branch` 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 catalog [::String]
+            #     The parent catalog resource name, such as
+            #     `projects/*/locations/global/catalogs/default_catalog`.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::Retail::V2::GetDefaultBranchResponse]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::Retail::V2::GetDefaultBranchResponse]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def get_default_branch request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Retail::V2::GetDefaultBranchRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.get_default_branch.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 \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Retail::V2::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {
+                "catalog" => request.catalog
+              }
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.get_default_branch.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.get_default_branch.retry_policy
+              options.apply_defaults metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @catalog_service_stub.call_rpc :get_default_branch, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Configuration class for the CatalogService API.
             #
@@ -473,6 +658,16 @@ module Google
                 # @return [::Gapic::Config::Method]
                 #
                 attr_reader :update_catalog
+                ##
+                # RPC-specific configuration for `set_default_branch`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :set_default_branch
+                ##
+                # RPC-specific configuration for `get_default_branch`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :get_default_branch
 
                 # @private
                 def initialize parent_rpcs = nil
@@ -480,6 +675,10 @@ module Google
                   @list_catalogs = ::Gapic::Config::Method.new list_catalogs_config
                   update_catalog_config = parent_rpcs.update_catalog if parent_rpcs.respond_to? :update_catalog
                   @update_catalog = ::Gapic::Config::Method.new update_catalog_config
+                  set_default_branch_config = parent_rpcs.set_default_branch if parent_rpcs.respond_to? :set_default_branch
+                  @set_default_branch = ::Gapic::Config::Method.new set_default_branch_config
+                  get_default_branch_config = parent_rpcs.get_default_branch if parent_rpcs.respond_to? :get_default_branch
+                  @get_default_branch = ::Gapic::Config::Method.new get_default_branch_config
 
                   yield self if block_given?
                 end

data/lib/google/cloud/retail/v2/catalog_service/paths.rb

@@ -24,6 +24,27 @@ module Google
         module CatalogService
           # Path helper methods for the CatalogService API.
           module Paths
+            ##
+            # Create a fully-qualified Branch resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/catalogs/{catalog}/branches/{branch}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param catalog [String]
+            # @param branch [String]
+            #
+            # @return [::String]
+            def branch_path project:, location:, catalog:, branch:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+              raise ::ArgumentError, "catalog cannot contain /" if catalog.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/catalogs/#{catalog}/branches/#{branch}"
+            end
+
             ##
             # Create a fully-qualified Catalog resource string.
             #

data/lib/google/cloud/retail/v2/catalog_service_pb.rb

@@ -26,6 +26,19 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :catalog, :message, 1, "google.cloud.retail.v2.Catalog"
       optional :update_mask, :message, 2, "google.protobuf.FieldMask"
     end
+    add_message "google.cloud.retail.v2.SetDefaultBranchRequest" do
+      optional :catalog, :string, 1
+      optional :branch_id, :string, 2
+      optional :note, :string, 3
+    end
+    add_message "google.cloud.retail.v2.GetDefaultBranchRequest" do
+      optional :catalog, :string, 1
+    end
+    add_message "google.cloud.retail.v2.GetDefaultBranchResponse" do
+      optional :branch, :string, 1
+      optional :set_time, :message, 2, "google.protobuf.Timestamp"
+      optional :note, :string, 3
+    end
   end
 end
 
@@ -36,6 +49,9 @@ module Google
         ListCatalogsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.ListCatalogsRequest").msgclass
         ListCatalogsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.ListCatalogsResponse").msgclass
         UpdateCatalogRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.UpdateCatalogRequest").msgclass
+        SetDefaultBranchRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.SetDefaultBranchRequest").msgclass
+        GetDefaultBranchRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.GetDefaultBranchRequest").msgclass
+        GetDefaultBranchResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.GetDefaultBranchResponse").msgclass
       end
     end
   end

data/lib/google/cloud/retail/v2/catalog_service_services_pb.rb

@@ -38,6 +38,52 @@ module Google
             rpc :ListCatalogs, ::Google::Cloud::Retail::V2::ListCatalogsRequest, ::Google::Cloud::Retail::V2::ListCatalogsResponse
             # Updates the [Catalog][google.cloud.retail.v2.Catalog]s.
             rpc :UpdateCatalog, ::Google::Cloud::Retail::V2::UpdateCatalogRequest, ::Google::Cloud::Retail::V2::Catalog
+            # Set a specified branch id as default branch. API methods such as
+            # [SearchService.Search][google.cloud.retail.v2.SearchService.Search],
+            # [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct],
+            # [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]
+            # will treat requests using "default_branch" to the actual branch id set as
+            # default.
+            #
+            # For example, if `projects/*/locations/*/catalogs/*/branches/1` is set as
+            # default, setting
+            # [SearchRequest.branch][google.cloud.retail.v2.SearchRequest.branch] to
+            # `projects/*/locations/*/catalogs/*/branches/default_branch` is equivalent
+            # to setting
+            # [SearchRequest.branch][google.cloud.retail.v2.SearchRequest.branch] to
+            # `projects/*/locations/*/catalogs/*/branches/1`.
+            #
+            # Using multiple branches can be useful when developers would like
+            # to have a staging branch to test and verify for future usage. When it
+            # becomes ready, developers switch on the staging branch using this API while
+            # keeping using `projects/*/locations/*/catalogs/*/branches/default_branch`
+            # as [SearchRequest.branch][google.cloud.retail.v2.SearchRequest.branch] to
+            # route the traffic to this staging branch.
+            #
+            # CAUTION: If you have live predict/search traffic, switching the default
+            # branch could potentially cause outages if the ID space of the new branch is
+            # very different from the old one.
+            #
+            # More specifically:
+            #
+            # * PredictionService will only return product IDs from branch {newBranch}.
+            # * SearchService will only return product IDs from branch {newBranch}
+            #   (if branch is not explicitly set).
+            # * UserEventService will only join events with products from branch
+            #   {newBranch}.
+            #
+            # This feature is only available for users who have Retail Search enabled.
+            # Contact Retail Support (retail-search-support@google.com) if you are
+            # interested in using Retail Search.
+            rpc :SetDefaultBranch, ::Google::Cloud::Retail::V2::SetDefaultBranchRequest, ::Google::Protobuf::Empty
+            # Get which branch is currently default branch set by
+            # [CatalogService.SetDefaultBranch][google.cloud.retail.v2.CatalogService.SetDefaultBranch]
+            # method under a specified parent catalog.
+            #
+            # This feature is only available for users who have Retail Search enabled.
+            # Contact Retail Support (retail-search-support@google.com) if you are
+            # interested in using Retail Search.
+            rpc :GetDefaultBranch, ::Google::Cloud::Retail::V2::GetDefaultBranchRequest, ::Google::Cloud::Retail::V2::GetDefaultBranchResponse
           end
 
           Stub = Service.rpc_stub_class

data/lib/google/cloud/retail/v2/common_pb.rb

@@ -8,20 +8,56 @@ require 'google/api/field_behavior_pb'
 require 'google/protobuf/timestamp_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/retail/v2/common.proto", :syntax => :proto3) do
+    add_message "google.cloud.retail.v2.Audience" do
+      repeated :genders, :string, 1
+      repeated :age_groups, :string, 2
+    end
+    add_message "google.cloud.retail.v2.ColorInfo" do
+      repeated :color_families, :string, 1
+      repeated :colors, :string, 2
+    end
     add_message "google.cloud.retail.v2.CustomAttribute" do
       repeated :text, :string, 1
       repeated :numbers, :double, 2
+      proto3_optional :searchable, :bool, 3
+      proto3_optional :indexable, :bool, 4
+    end
+    add_message "google.cloud.retail.v2.FulfillmentInfo" do
+      optional :type, :string, 1
+      repeated :place_ids, :string, 2
     end
     add_message "google.cloud.retail.v2.Image" do
       optional :uri, :string, 1
       optional :height, :int32, 2
       optional :width, :int32, 3
     end
+    add_message "google.cloud.retail.v2.Interval" do
+      oneof :min do
+        optional :minimum, :double, 1
+        optional :exclusive_minimum, :double, 2
+      end
+      oneof :max do
+        optional :maximum, :double, 3
+        optional :exclusive_maximum, :double, 4
+      end
+    end
     add_message "google.cloud.retail.v2.PriceInfo" do
       optional :currency_code, :string, 1
       optional :price, :float, 2
       optional :original_price, :float, 3
       optional :cost, :float, 4
+      optional :price_effective_time, :message, 5, "google.protobuf.Timestamp"
+      optional :price_expire_time, :message, 6, "google.protobuf.Timestamp"
+      optional :price_range, :message, 7, "google.cloud.retail.v2.PriceInfo.PriceRange"
+    end
+    add_message "google.cloud.retail.v2.PriceInfo.PriceRange" do
+      optional :price, :message, 1, "google.cloud.retail.v2.Interval"
+      optional :original_price, :message, 2, "google.cloud.retail.v2.Interval"
+    end
+    add_message "google.cloud.retail.v2.Rating" do
+      optional :rating_count, :int32, 1
+      optional :average_rating, :float, 2
+      repeated :rating_histogram, :int32, 3
     end
     add_message "google.cloud.retail.v2.UserInfo" do
       optional :user_id, :string, 1
@@ -29,6 +65,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :user_agent, :string, 3
       optional :direct_user_request, :bool, 4
     end
+    add_message "google.cloud.retail.v2.Promotion" do
+      optional :promotion_id, :string, 1
+    end
   end
 end
 
@@ -36,10 +75,17 @@ module Google
   module Cloud
     module Retail
       module V2
+        Audience = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.Audience").msgclass
+        ColorInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.ColorInfo").msgclass
         CustomAttribute = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.CustomAttribute").msgclass
+        FulfillmentInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.FulfillmentInfo").msgclass
         Image = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.Image").msgclass
+        Interval = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.Interval").msgclass
         PriceInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.PriceInfo").msgclass
+        PriceInfo::PriceRange = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.PriceInfo.PriceRange").msgclass
+        Rating = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.Rating").msgclass
         UserInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.UserInfo").msgclass
+        Promotion = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.Promotion").msgclass
       end
     end
   end