stretchy-model 0.5.0 → 0.6.5

data/lib/opensearch/api/actions/machine_learning/models/undeploy.rb

@@ -0,0 +1,31 @@
+module OpenSearch
+  module API
+    module MachineLearning
+	    module Models
+	      module Actions
+	        # Register a model.
+	        #
+	        # @option arguments [String] :id The model id
+	        # @option arguments [Hash] :body The deploy options
+	        #
+          # 
+          # POST /_plugins/_ml/models/<model_id>/_undeploy
+	        def undeploy(arguments = {})
+						raise ArgumentError, "Required argument 'id' missing" unless arguments[:id]
+	          _id = arguments.delete(:id)
+	          arguments = arguments.clone
+            headers = arguments.delete(:headers) || {}
+	
+	          method = OpenSearch::API::HTTP_POST
+	          path   = "_plugins/_ml/models/#{Utils.__listify(_id)}/_undeploy"
+	          params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
+	
+	          body = arguments[:body]
+	          perform_request(method, path, params, body, headers).body
+	        end
+	
+	      end
+	    end
+    end
+  end
+end

data/lib/opensearch/api/actions/machine_learning/models/update_model.rb

@@ -0,0 +1,39 @@
+module OpenSearch
+  module API
+    module MachineLearning
+	    module Models
+	      module Actions
+	        # Returns a model.
+	        #
+	        # @option arguments [String] :id The model id
+	        # @option arguments [Hash] :body The request fields
+	        #
+	        # Example
+	        # update_model(id: 109sdj0asl092, "rate_limiter": {
+          #    "limit": "4",
+          #    "unit": "MINUTES"
+          #  }
+          # )
+          # 
+          # PUT /_plugins/_ml/models/<model_id>
+	        def update_model(arguments = {})
+		        raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
+		        raise ArgumentError, "Required argument 'id' missing" unless arguments[:id]
+		        
+            _id = arguments.delete(:id)
+
+            headers = arguments.delete(:headers) || {}
+
+		        method = OpenSearch::API::HTTP_PUT
+		        path   = "_plugins/_ml/models/#{Utils.__listify(_id)}"
+		        params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
+				
+            body = arguments[:body]
+		        perform_request(method, path, params, body, headers).body
+	        end
+	
+	      end
+	    end
+    end
+  end
+end

data/lib/opensearch/api/namespace/machine_learning/model.rb

@@ -0,0 +1,27 @@
+Dir[File.expand_path('../../actions/**/*.rb', __dir__)].sort.each   { |f| require f }
+
+module OpenSearch
+  module API
+    module MachineLearning
+      module Models
+          module Actions; end
+    
+          # Client for the "machine_learning/models" namespace (includes the {MachineLearning::Models::Actions} methods)
+          #
+          class MachineLearningClient
+            include MachineLearning::Models::Actions
+            include OpenSearch::API::Common::Client::Base
+            include OpenSearch::API::Common::Client
+          end
+    
+          # Proxy method for {MachineLearningModel}, available in the receiving object
+          #
+          def machine_learning
+            @machine_learning ||= MachineLearningClient.new(self)
+          end
+    
+          alias ml machine_learning
+        end
+    end
+  end
+end

data/lib/stretchy/associations.rb

@@ -38,7 +38,7 @@ module Stretchy
     end
 
     def association_reflection(association)
-      Stretchy::Relation.new @@_associations[association], (dirty[association.to_sym] || [])
+      Stretchy::Relation.new @@_associations[association], (dirty[association.to_sym] || {})
     end
 
     def _destroy=(bool)

data/lib/stretchy/attributes/type/array.rb

@@ -1,15 +1,20 @@
-module Stretchy
-    module Attributes
-        module Type
-
-            class Array < ActiveModel::Type::Value # :nodoc:
-
-                def type
-                    :array
-                end
+module Stretchy::Attributes::Type
+  class Array < Stretchy::Attributes::Type::Base # :nodoc:
+    OPTIONS = [:data_type, :fields]
+    def type
+      :array
+    end
 
-            end
+    def type_for_database
+      data_type || :text
+    end
 
-        end
+    def mappings(name)
+      options = {type: type_for_database}
+      self.class::OPTIONS.each { |option| options[option] = send(option) unless send(option).nil? }
+      options.delete(:fields) if fields == false
+      options[:fields] = {keyword: {type: :keyword, ignore_above: 256}} if type_for_database == :text && fields.nil?
+      { name => options }.as_json
     end
+  end
 end

data/lib/stretchy/attributes/type/base.rb

@@ -0,0 +1,42 @@
+module Stretchy
+    module Attributes
+        module Type
+            class Base < ActiveModel::Type::Value
+
+              OPTIONS = []
+
+      
+              def initialize(**args)
+
+                define_option_methods!
+
+                args.each do |k, v|
+                  if self.class::OPTIONS.include?(k)
+                    instance_variable_set("@#{k}", v) 
+                    args.delete(k)
+                  end
+                end
+                super
+              end
+      
+              def mappings(name)
+                options = {type: type_for_database}
+                self.class::OPTIONS.each { |option| options[option] = send(option) unless send(option).nil? }
+                { name => options }.as_json
+              end
+
+              def type_for_database
+                type
+              end
+
+              private
+
+              def define_option_methods!
+                self.class::OPTIONS.each do |option|
+                  define_singleton_method(option.to_sym) { instance_variable_get("@#{option}") }
+                end
+              end
+            end
+        end
+    end
+end

data/lib/stretchy/attributes/type/binary.rb

@@ -0,0 +1,45 @@
+# Public: Defines a binary attribute for the model.
+#
+# name - The Symbol name of the attribute.
+# opts - The Hash options used to refine the attribute (default: {}):
+#        :doc_values - The Boolean indicating if the field should be stored on disk in a column-stride fashion.
+#                      This allows it to be used later for sorting, aggregations, or scripting. Defaults to false.
+#        :store - The Boolean indicating if the field value should be stored and retrievable separately from the _source field. Defaults to false.
+#
+# Examples
+#
+#   class MyModel
+#     include StretchyModel
+#     attribute :name, :binary, doc_values: true, store: true
+#   end
+#
+# Returns nothing.
+module Stretchy
+    module Attributes
+        module Type
+            class Binary < ActiveModel::Type::Value
+                OPTIONS = [:doc_values, :store]
+                attr_reader *OPTIONS 
+
+                def initialize(**args)  
+                  args.each do |k, v|
+                    instance_variable_set("@#{k}", v) if OPTIONS.include?(k)
+                    args.delete(k)
+                  end
+                  super
+                end
+
+                def type
+                    :binary
+                end
+
+
+                def mappings(name) 
+                  options = {type: type}
+                  OPTIONS.each { |_| options[_] = self.send(_) }
+                  { name => options }.as_json
+                end
+            end
+        end
+    end
+end

data/lib/stretchy/attributes/type/boolean.rb

@@ -0,0 +1,48 @@
+# Public: Defines a boolean attribute for the model.
+#
+# name - The Symbol name of the attribute.
+# opts - The Hash options used to refine the attribute (default: {}):
+#        :doc_values - The Boolean indicating if the field should be stored on disk in a column-stride fashion.
+#                      This allows it to be used later for sorting, aggregations, or scripting. Defaults to true.
+#        :index - The Boolean indicating if the field should be quickly searchable. Defaults to true.
+#        :ignore_malformed - The Boolean indicating if exceptions thrown when trying to index the wrong data type into a field should be ignored. Defaults to false.
+#        :null_value - The Boolean value to be substituted for any explicit null values. Defaults to null.
+#        :on_script_error - The String defining what to do if the script defined by the :script parameter throws an error at indexing time. Can be 'fail' or 'continue'.
+#        :script - The String script that will index values generated by this script, rather than reading the values directly from the source.
+#        :store - The Boolean indicating if the field value should be stored and retrievable separately from the _source field. Defaults to false.
+#        :meta - The Hash metadata about the field.
+#
+# Examples
+#
+#   class MyModel
+#     include StretchyModel
+#     attribute :name, :boolean, doc_values: true, store: true
+#   end
+#
+# Returns nothing.
+module Stretchy
+  module Attributes
+    module Type
+      class Boolean < Stretchy::Attributes::Type::Base
+
+        OPTIONS = [:doc_values, :index, :ignore_malformed, :null_value, :on_script_error, :script, :store, :meta]
+        attr_reader *OPTIONS 
+
+        def initialize(**args)  
+          args.each do |k, v|
+            instance_variable_set("@#{k}", v) if OPTIONS.include?(k)
+            args.delete(k)
+          end
+          super
+        end
+
+        def type
+          :boolean
+        end
+
+
+
+      end
+    end
+  end
+end

data/lib/stretchy/attributes/type/completion.rb

@@ -0,0 +1,25 @@
+module Stretchy::Attributes::Type
+  # Public: Defines a completion attribute for the model.
+  #
+  # opts - The Hash options used to refine the attribute (default: {}):
+  #        :analyzer - The String index analyzer to use. Defaults to 'simple'.
+  #        :search_analyzer - The String search analyzer to use. Defaults to the value of :analyzer.
+  #        :preserve_separators - The Boolean indicating if separators should be preserved. Defaults to true.
+  #        :preserve_position_increments - The Boolean indicating if position increments should be enabled. Defaults to true.
+  #        :max_input_length - The Integer limit for the length of a single input. Defaults to 50.
+  #
+  # Examples
+  #
+  #   class MyModel < Stretchy::Record
+  #     attribute :name, :completion, analyzer: 'simple', max_input_length: 100
+  #   end
+  #
+  # Returns nothing.
+  class Completion < Stretchy::Attributes::Type::Base
+    OPTIONS = [:analyzer, :search_analyzer, :preserve_separators, :preserve_position_increments, :max_input_length]
+    attr_reader *OPTIONS
+    def type
+      :completion
+    end
+  end
+end

data/lib/stretchy/attributes/type/constant_keyword.rb

@@ -0,0 +1,38 @@
+module Stretchy::Attributes::Type
+  # Public: Defines a constant_keyword attribute for the model. This field type is a specialization of the keyword field, but it only accepts a single value.
+  #
+  # opts - The Hash options used to refine the attribute (default: {}):
+  #        :doc_values - The Boolean indicating if the field should be stored on disk in a column-stride fashion. Defaults to true.
+  #        :eager_global_ordinals - The Boolean indicating if global ordinals should be loaded eagerly on refresh. Defaults to false.
+  #        :fields - The Hash of multi-fields for the same string value to be indexed in multiple ways.
+  #        :ignore_above - The Integer limit for the length of the string. Strings longer than this limit will not be indexed. Defaults to 2147483647.
+  #        :index - The Boolean indicating if the field should be quickly searchable. Defaults to true.
+  #        :index_options - The String indicating what information should be stored in the index for scoring purposes. Defaults to 'docs'.
+  #        :meta - The Hash metadata about the field.
+  #        :norms - The Boolean indicating if field-length should be taken into account when scoring queries. Defaults to false.
+  #        :null_value - The String value to be substituted for any explicit null values. Defaults to null.
+  #        :on_script_error - The String defining what to do if the script defined by the :script parameter throws an error at indexing time. Can be 'fail' or 'continue'.
+  #        :script - The String script that will index values generated by this script, rather than reading the values directly from the source.
+  #        :store - The Boolean indicating if the field value should be stored and retrievable separately from the _source field. Defaults to false.
+  #        :similarity - The String scoring algorithm or similarity to be used. Defaults to 'BM25'.
+  #        :normalizer - The String pre-processor for the keyword prior to indexing. Defaults to null.
+  #        :split_queries_on_whitespace - The Boolean indicating if full text queries should split the input on whitespace. Defaults to false.
+  #        :time_series_dimension - The Boolean indicating if the field is a time series dimension. Defaults to false.
+  #        :value - The String value to associate with all documents in the index.
+  #
+  # Examples
+  #
+  #   class MyModel
+  #     include StretchyModel
+  #     attribute :status, :constant_keyword, value: 'active'
+  #   end
+  #
+  # Returns nothing.
+  class ConstantKeyword < Stretchy::Attributes::Type::Keyword
+    OPTIONS = OPTIONS + [:value]
+    attr_reader *OPTIONS
+    def type
+      :constant_keyword
+    end
+  end
+end

data/lib/stretchy/attributes/type/date_time.rb

@@ -0,0 +1,85 @@
+module Stretchy::Attributes::Type
+  # Public: Defines a datetime attribute for the model.
+  #
+  # opts - The Hash options used to refine the attribute (default: {}):
+  #        :doc_values - The Boolean indicating if the field should be stored on disk in a column-stride fashion.
+  #                      This allows it to be used later for sorting, aggregations, or scripting. Defaults to true.
+  #        :format - The String date format(s) that can be parsed. Defaults to 'strict_date_optional_time||epoch_millis'.
+  #        :locale - The String locale to use when parsing dates. Defaults to the ROOT locale.
+  #        :ignore_malformed - The Boolean indicating if malformed numbers should be ignored. Defaults to false.
+  #        :index - The Boolean indicating if the field should be quickly searchable. Defaults to true.
+  #        :null_value - The Date value to be substituted for any explicit null values. Defaults to null.
+  #        :on_script_error - The String defining what to do if the script defined by the :script parameter throws an error at indexing time. Can be 'fail' or 'continue'.
+  #        :script - The String script that will index values generated by this script, rather than reading the values directly from the source.
+  #        :store - The Boolean indicating if the field value should be stored and retrievable separately from the _source field. Defaults to false.
+  #        :meta - The Hash metadata about the field.
+  #
+  # Examples
+  #
+  #   class MyModel < Stretchy::Record
+  #     attribute :created_at, :datetime, format: 'strict_date_optional_time||epoch_millis', locale: 'en'
+  #   end
+  #
+  # Returns nothing.
+  class DateTime < Stretchy::Attributes::Type::Base
+    OPTIONS = [:doc_values, :format, :locale, :ignore_malformed, :index, :null_value, :on_script_error, :script, :store, :meta]
+    attr_reader *OPTIONS
+    include ActiveModel::Type::Helpers::Timezone
+    include ActiveModel::Type::Helpers::AcceptsMultiparameterTime.new(
+      defaults: { 4 => 0, 5 => 0 }
+    )
+    include ActiveModel::Type::Helpers::TimeValue
+
+    def initialize(**args)
+      @model_format = args.delete(:model_format)
+      super
+    end
+
+    def type
+      :datetime
+    end
+
+    def type_for_database
+      :date
+    end
+
+    private
+    def cast_value(value)
+      return apply_seconds_precision(value) unless value.is_a?(::String)
+      return if value.empty?
+
+      fast_string_to_time(value) || fallback_string_to_time(value) || custom_string_to_time(value)
+    end
+
+    # '0.123456' -> 123456
+    # '1.123456' -> 123456
+    def microseconds(time)
+      time[:sec_fraction] ? (time[:sec_fraction] * 1_000_000).to_i : 0
+    end
+
+    def custom_string_to_time(string)
+      ::Date.strptime(string, @model_format)
+    end
+
+    def fallback_string_to_time(string)
+      time_hash = begin
+        ::Date._parse(string)
+      rescue ArgumentError => e
+      end
+      return unless time_hash
+
+      time_hash[:sec_fraction] = microseconds(time_hash)
+
+      new_time(*time_hash.values_at(:year, :mon, :mday, :hour, :min, :sec, :sec_fraction, :offset))
+    end
+
+    def value_from_multiparameter_assignment(values_hash)
+      missing_parameters = [1, 2, 3].delete_if { |key| values_hash.key?(key) }
+      unless missing_parameters.empty?
+        raise ArgumentError, "Provided hash #{values_hash} doesn't contain necessary keys: #{missing_parameters}"
+      end
+      super
+    end
+
+  end
+end

data/lib/stretchy/attributes/type/dense_vector.rb

@@ -0,0 +1,59 @@
+# Public: Defines a dense vector attribute for the model.
+#
+# name - The Symbol name of the attribute.
+# opts - The Hash options used to refine the attribute (default: {}):
+#        :element_type - The String data type used to encode vectors. Can be 'float' or 'byte'.
+#                        'float' indexes a 4-byte floating-point value per dimension.
+#                        'byte' indexes a 1-byte integer value per dimension.
+#                        Vectors using 'byte' require dimensions with integer values between -128 to 127.
+#        :dims - The Integer number of vector dimensions. Can’t exceed 4096.
+#                If not specified, it will be set to the length of the first vector added to the field.
+#        :index - The Boolean indicating if you can search this field using the kNN search API (default: true).
+#        :similarity - The String vector similarity metric to use in kNN search. Can be 'l2_norm', 'dot_product', 'cosine', or 'max_inner_product'.
+#                      This parameter can only be specified when :index is true.
+#        :index_options - The Hash that configures the kNN indexing algorithm. Can only be specified when :index is true.
+#                         :type - The String type of kNN algorithm to use. Can be either 'hnsw' or 'int8_hnsw'.
+#                         :m - The Integer number of neighbors each node will be connected to in the HNSW graph.
+#                         :ef_construction - The Integer number of candidates to track while assembling the list of nearest neighbors for each new node.
+#                         :confidence_interval - The Float confidence interval to use when quantizing the vectors. Only applicable to 'int8_hnsw' index types.
+#
+# Examples
+#
+#   class MyModel
+#     include StretchyModel
+#     attribute :vector_embeddings, :dense_vector, element_type: 'float', dims: 3
+#   end
+#
+# Returns nothing.
+module Stretchy
+  module Attributes
+      module Type
+          class DenseVector < Stretchy::Attributes::Type::Base
+              OPTIONS = [:element_type, :dims, :index, :similarity, :index_options]
+              attr_reader *OPTIONS 
+
+              def initialize(**args)  
+                args.each do |k, v|
+                  instance_variable_set("@#{k}", v) if OPTIONS.include?(k)
+                  args.delete(k)
+                end
+                super
+              end
+
+              def type
+                :dense_vector
+              end
+
+              def mappings(name) 
+                options = {type: type}
+                OPTIONS.each { |_| options[_] = self.send(_) }
+                {
+                  properties: {
+                    "#{name}.tokens": options
+                  }
+                }.as_json
+              end
+          end
+      end
+  end
+end

data/lib/stretchy/attributes/type/flattened.rb

@@ -0,0 +1,31 @@
+module Stretchy::Attributes::Type
+  # Public: Defines a flattened attribute for the model.
+  #
+  # opts - The Hash options used to refine the attribute (default: {}):
+  #        :depth_limit - The Integer maximum allowed depth of the flattened object field. Defaults to 20.
+  #        :doc_values - The Boolean indicating if the field should be stored on disk in a column-stride fashion. Defaults to true.
+  #        :eager_global_ordinals - The Boolean indicating if global ordinals should be loaded eagerly on refresh. Defaults to false.
+  #        :ignore_above - The Integer limit for the length of leaf values. Values longer than this limit will not be indexed. By default, there is no limit.
+  #        :index - The Boolean indicating if the field should be searchable. Defaults to true.
+  #        :index_options - The String indicating what information should be stored in the index for scoring purposes. Defaults to 'docs'.
+  #        :null_value - The String value to be substituted for any explicit null values. Defaults to null.
+  #        :similarity - The String scoring algorithm or similarity to be used. Defaults to 'BM25'.
+  #        :split_queries_on_whitespace - The Boolean indicating if full text queries should split the input on whitespace. Defaults to false.
+  #        :time_series_dimensions - The Array of Strings indicating the fields inside the flattened object that are dimensions of the time series.
+  #
+  # Examples
+  #
+  #   class MyModel
+  #     include StretchyModel
+  #     attribute :metadata, :flattened, depth_limit: 10, index_options: 'freqs'
+  #   end
+  #
+  # Returns nothing.
+  class Flattened < Stretchy::Attributes::Type::Base
+    OPTIONS = [:depth_limit, :doc_values, :eager_global_ordinals, :ignore_above, :index, :index_options, :null_value, :similarity, :split_queries_on_whitespace, :time_series_dimensions]
+
+    def type
+      :flattened
+    end
+  end
+end

data/lib/stretchy/attributes/type/geo_point.rb

@@ -0,0 +1,27 @@
+module Stretchy::Attributes::Type
+  # Public: Defines a geo_point attribute for the model.
+  #
+  # opts - The Hash options used to refine the attribute (default: {}):
+  #        :ignore_malformed - The Boolean indicating if malformed geopoints should be ignored. Defaults to false.
+  #        :ignore_z_value - The Boolean indicating if three dimension points should be accepted but only latitude and longitude values should be indexed. Defaults to true.
+  #        :index - The Boolean indicating if the field should be quickly searchable. Defaults to true.
+  #        :null_value - The GeoPoint value to be substituted for any explicit null values. Defaults to null.
+  #        :on_script_error - The String defining what to do if the script defined by the :script parameter throws an error at indexing time. Can be 'fail' or 'continue'.
+  #        :script - The String script that will index values generated by this script, rather than reading the values directly from the source.
+  #
+  # Examples
+  #
+  #   class MyModel
+  #     include StretchyModel
+  #     attribute :location, :geo_point, ignore_malformed: true
+  #   end
+  #
+  # Returns nothing.
+  class GeoPoint < Stretchy::Attributes::Type::Base
+    OPTIONS = [:ignore_malformed, :ignore_z_value, :index, :null_value, :on_script_error, :script]
+
+    def type
+      :geo_point
+    end
+  end
+end

data/lib/stretchy/attributes/type/geo_shape.rb

@@ -0,0 +1,27 @@
+module Stretchy::Attributes::Type
+  # Public: Defines a geo_shape attribute for the model.
+  #
+  # opts - The Hash options used to refine the attribute (default: {}):
+  #        :orientation - The String default orientation for the field’s WKT polygons. Can be 'right', 'counterclockwise', 'ccw', 'left', 'clockwise', or 'cw'. Defaults to 'right'.
+  #        :ignore_malformed - The Boolean indicating if malformed GeoJSON or WKT shapes should be ignored. Defaults to false.
+  #        :ignore_z_value - The Boolean indicating if three dimension points should be accepted but only latitude and longitude values should be indexed. Defaults to true.
+  #        :coerce - The Boolean indicating if unclosed linear rings in polygons should be automatically closed. Defaults to false.
+  #        :index - The Boolean indicating if the field should be quickly searchable. Defaults to true.
+  #        :doc_values - The Boolean indicating if the field should be stored on disk in a column-stride fashion. Defaults to true.
+  #
+  # Examples
+  #
+  #   class MyModel
+  #     include StretchyModel
+  #     attribute :boundary, :geo_shape, orientation: 'left', coerce: true
+  #   end
+  #
+  # Returns nothing.
+  class GeoShape < Stretchy::Attributes::Type::Base
+    OPTIONS = [:orientation, :ignore_malformed, :ignore_z_value, :coerce, :index, :doc_values]
+
+    def type
+      :geo_shape
+    end
+  end
+end

data/lib/stretchy/attributes/type/hash.rb

@@ -1,17 +1,40 @@
-module Stretchy
-    module Attributes
-        module Type
-            class Hash < ActiveModel::Type::Value # :nodoc:
-                def type
-                    :hash
-                end
+module Stretchy::Attributes::Type
+  # Public: Defines a hash attribute for the model.
+  #
+  # opts - The Hash options used to refine the attribute (default: {}):
+  #        :dynamic - The String indicating if new properties should be added dynamically to an existing object. Can be 'true', 'runtime', 'false', or 'strict'. Defaults to 'true'.
+  #        :enabled - The Boolean indicating if the JSON value for the object field should be parsed and indexed. Defaults to true.
+  #        :subobjects - The Boolean indicating if the object can hold subobjects. Defaults to true.
+  #        :properties - The Hash of fields within the object, which can be of any data type, including object.
+  #
+  # Examples
+  #
+  #   class MyModel < Stretchy::Record
+  #     attribute :metadata, :hash, dynamic: 'strict', subobjects: false
+  #   end
+  #
+  # Returns nothing.
+  class Hash < Stretchy::Attributes::Type::Base
+    OPTIONS = [:dynamic, :enabled, :subobjects, :properties]
 
-                private
+    def type
+      :hash
+    end
+
+    def type_for_database
+      :object
+    end
+
+    def mappings(name)
+      options = {}
+      OPTIONS.each { |option| options[option] = send(option) unless send(option).nil? }
+      { name => options }.as_json
+    end
+
+    private
 
-                def cast_value(value)
-                    Elasticsearch::Model::HashWrapper[value]
-                end
-            end
-        end
+    def cast_value(value)
+      Elasticsearch::Model::HashWrapper[value]
     end
+  end
 end

data/lib/stretchy/attributes/type/histogram.rb

@@ -0,0 +1,7 @@
+module Stretchy::Attributes::Type
+    class Histogram < Stretchy::Attributes::Type::Base
+        def type
+            :histogram
+        end
+    end
+end