stretchy-model 0.4.0 → 0.6.0

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

@@ -0,0 +1,40 @@
+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]
+
+    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

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

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

@@ -0,0 +1,29 @@
+module Stretchy::Attributes::Type
+  # Public: Defines an IP 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. Defaults to true.
+  #        :ignore_malformed - The Boolean indicating if malformed IP addresses should be ignored. Defaults to false.
+  #        :index - The Boolean indicating if the field should be quickly searchable. Defaults to true.
+  #        :null_value - The String IPv4 or IPv6 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 'reject' or 'ignore'.
+  #        :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.
+  #        :time_series_dimension - The Boolean indicating if the field is a time series dimension. Defaults to false.
+  #
+  # Examples
+  #
+  #   class MyModel
+  #     include StretchyModel
+  #     attribute :ip_address, :ip, ignore_malformed: true, time_series_dimension: true
+  #   end
+  #
+  # Returns nothing.
+  class IP < Stretchy::Attributes::Type::Base
+    OPTIONS = [:doc_values, :ignore_malformed, :index, :null_value, :on_script_error, :script, :store, :time_series_dimension]
+
+    def type
+      :ip
+    end
+  end
+end

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

@@ -0,0 +1,22 @@
+module Stretchy::Attributes::Type
+  # Public: Defines a join attribute for the model.
+  #
+  # opts - The Hash options used to define the parent/child relation within documents of the same index (default: {}):
+  #        :relations - The Hash defining a set of possible relations within the documents, each relation being a parent name and a child name.
+  #
+  # Examples
+  #
+  #   class MyModel
+  #     include StretchyModel
+  #     attribute :relation, :join, relations: { question: :answer }
+  #   end
+  #
+  # Returns nothing.
+  class Join < Stretchy::Attributes::Type::Base
+    OPTIONS = [:relations]
+
+    def type
+      :join
+    end
+  end
+end

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

@@ -1,11 +1,37 @@
-module Stretchy
-    module Attributes
-        module Type
-            class Keyword < ActiveModel::Type::String # :nodoc:
-                def type
-                    :keyword
-                end
-            end
-        end
+module Stretchy::Attributes::Type
+    # Public: Defines a keyword 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. 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.
+    #
+    # Examples
+    #   class MyModel
+    #     include StretchyModel
+    #     attribute :tag, :keyword, ignore_above: 256, time_series_dimension: true
+    #   end
+    #
+    # Returns nothing.
+    class Keyword < Stretchy::Attributes::Type::Base
+      OPTIONS = [:doc_values, :eager_global_ordinals, :fields, :ignore_above, :index, :index_options, :meta, :norms, :null_value, :on_script_error, :script, :store, :similarity, :normalizer, :split_queries_on_whitespace, :time_series_dimension]
+  
+      def type
+        :keyword
+      end
     end
-end
+  end

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

@@ -0,0 +1,8 @@
+# a space-optimized variant of text that disables scoring and performs slower on queries that need positions. It is best suited for indexing log messages.
+module Stretchy::Attributes::Type
+  class MatchOnlyText < Stretchy::Attributes::Type::Text
+    def type
+      :match_only_text
+    end
+  end
+end

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

@@ -0,0 +1,25 @@
+module Stretchy::Attributes::Type
+  # Public: Defines a nested 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 nested object. Can be 'true', 'false', or 'strict'. Defaults to 'true'.
+  #        :properties - The Hash of fields within the nested object, which can be of any data type, including nested.
+  #        :include_in_parent - The Boolean indicating if all fields in the nested object are also added to the parent document as standard fields. Defaults to false.
+  #        :include_in_root - The Boolean indicating if all fields in the nested object are also added to the root document as standard fields. Defaults to false.
+  #
+  # Examples
+  #
+  #   class MyModel
+  #     include StretchyModel
+  #     attribute :metadata, :nested, dynamic: 'strict', include_in_parent: true
+  #   end
+  #
+  # Returns nothing.
+  class Nested < Stretchy::Attributes::Type::Base
+    OPTIONS = [:dynamic, :properties, :include_in_parent, :include_in_root]
+
+    def type
+      :nested
+    end
+  end
+end

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

@@ -0,0 +1,32 @@
+module Stretchy::Attributes::Type::Numeric
+  # Public: Defines a numeric attribute for the model. This is a base class for numeric types.
+  #
+  # opts - The Hash options used to refine the attribute (default: {}):
+  #        :coerce - The Boolean indicating if strings should be converted to numbers and fractions truncated for integers. Defaults to true.
+  #        :doc_values - The Boolean indicating if the field should be stored on disk in a column-stride fashion. Defaults to true.
+  #        :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.
+  #        :meta - The Hash metadata about the field.
+  #        :null_value - The Numeric 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.
+  #        :time_series_dimension - The Boolean indicating if the field is a time series dimension. Defaults to false.
+  #        :time_series_metric - The String indicating if the field is a time series metric. Can be 'counter', 'gauge', or 'null'.
+  #
+  # Examples
+  #
+  #   class MyModel
+  #     include StretchyModel
+  #     attribute :age, :integer, coerce: false, time_series_dimension: true
+  #   end
+  #
+  # Returns nothing.
+  class Base < Stretchy::Attributes::Type::Base
+    OPTIONS = [:coerce, :doc_values, :ignore_malformed, :index, :meta, :null_value, :on_script_error, :script, :store, :time_series_dimension, :time_series_metric]
+
+    def type
+      raise NotImplementedError, "You must use one of the numeric types: integer, long, short, byte, double, float, half_float, scaled_float."
+    end
+  end
+end

data/lib/stretchy/attributes/type/numeric/byte.rb

@@ -0,0 +1,7 @@
+module Stretchy::Attributes::Type::Numeric
+  class Byte < Base
+    def type
+      :byte
+    end
+  end
+end

data/lib/stretchy/attributes/type/numeric/double.rb

@@ -0,0 +1,7 @@
+module Stretchy::Attributes::Type::Numeric
+  class Double < Base
+    def type
+      :double
+    end
+  end
+end

data/lib/stretchy/attributes/type/numeric/float.rb

@@ -0,0 +1,7 @@
+module Stretchy::Attributes::Type::Numeric
+  class Float < Base
+    def type
+      :float
+    end
+  end
+end

data/lib/stretchy/attributes/type/numeric/half_float.rb

@@ -0,0 +1,7 @@
+module Stretchy::Attributes::Type::Numeric
+  class HalfFloat < Base
+    def type
+      :half_float
+    end
+  end
+end

data/lib/stretchy/attributes/type/numeric/integer.rb

@@ -0,0 +1,7 @@
+module Stretchy::Attributes::Type::Numeric
+  class Integer < Stretchy::Attributes::Type::Base # :nodoc:
+    def type
+      :integer
+    end
+  end
+end

data/lib/stretchy/attributes/type/numeric/long.rb

@@ -0,0 +1,7 @@
+module Stretchy::Attributes::Type::Numeric
+  class Long < Base
+    def type
+      :long
+    end
+  end
+end

data/lib/stretchy/attributes/type/numeric/scaled_float.rb

@@ -0,0 +1,23 @@
+module Stretchy::Attributes::Type::Numeric
+
+  # Public: Defines a scaled_float attribute for the model.
+  #
+  # opts - The Hash options used to refine the attribute (default: {}):
+  #        :scaling_factor - The Integer scaling factor to use when encoding values. This parameter is required.
+  #
+  # Examples
+  #
+  #   class MyModel
+  #     include StretchyModel
+  #     attribute :rating, :scaled_float, scaling_factor: 10
+  #   end
+  #
+  # Returns nothing.
+  class ScaledFloat < Base
+    OPTIONS = Base::OPTIONS + [:scaling_factor]
+
+    def type
+      :scaled_float
+    end
+  end
+end

data/lib/stretchy/attributes/type/numeric/short.rb

@@ -0,0 +1,7 @@
+module Stretchy::Attributes::Type::Numeric
+  class Short < Base
+    def type
+      :short
+    end
+  end
+end

data/lib/stretchy/attributes/type/numeric/unsigned_long.rb

@@ -0,0 +1,7 @@
+module Stretchy::Attributes::Type::Numeric
+  class UnsignedLong < Stretchy::Attributes::Type::Numeric::Base
+    def type
+      :unsigned_long
+    end
+  end
+end

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

@@ -0,0 +1,23 @@
+module Stretchy::Attributes::Type
+  # Public: Defines a percolator attribute for the model.
+  #
+  # The percolator field type parses a JSON structure into a native query and stores that query,
+  # so that the percolate query can use it to match provided documents.
+  #
+  # Any field that contains a JSON object can be configured to be a percolator field.
+  # The percolator field type has no settings. Just configuring the percolator field type
+  # is sufficient to instruct Elasticsearch to treat a field as a query.
+  #
+  # Examples
+  #
+  #   class MyModel < Stretchy::Record
+  #     attribute :query, :percolator
+  #   end
+  #
+  # Returns nothing.
+  class Percolator < Stretchy::Attributes::Type::Base
+    def type
+      :percolator
+    end
+  end
+end

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

@@ -0,0 +1,24 @@
+module Stretchy::Attributes::Type
+  # Public: Defines a point attribute for the model.
+  #
+  # opts - The Hash options used to refine the attribute (default: {}):
+  #        :ignore_malformed - The Boolean indicating if malformed points should be ignored. Defaults to false.
+  #        :ignore_z_value - The Boolean indicating if the z value of three dimension points should be ignored. Defaults to true.
+  #        :null_value - The Point value to be substituted for any explicit null values. Defaults to null.
+  #
+  # Examples
+  #
+  #   class MyModel
+  #     include StretchyModel
+  #     attribute :location, :point, ignore_malformed: true
+  #   end
+  #
+  # Returns nothing.
+  class Point < Stretchy::Attributes::Type::Base
+    OPTIONS = [:ignore_malformed, :ignore_z_value, :null_value]
+
+    def type
+      :point
+    end
+  end
+end

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

@@ -0,0 +1,9 @@
+module Stretchy::Attributes::Type::Range
+  class Base < Stretchy::Attributes::Type::Base
+    OPTIONS = [:coerce, :index, :store]
+
+    def type
+      raise NotImplementedError, "You must use one of the range types: integer_range, float_range, long_range, double_range, date_range, or ip_range."
+    end
+  end
+end

data/lib/stretchy/attributes/type/range/date_range.rb

@@ -0,0 +1,17 @@
+module Stretchy::Attributes::Type::Range
+  # Public: Defines a date_range attribute for the model.
+  #
+  # Examples
+  #
+  #   class MyModel < Stretchy::Record
+  #     attribute :birth_date_range, :date_range
+  #   end
+  #
+  # Returns nothing.
+  class DateRange < Base
+
+    def type
+      :date_range
+    end
+  end
+end

data/lib/stretchy/attributes/type/range/double_range.rb

@@ -0,0 +1,17 @@
+module Stretchy::Attributes::Type::Range
+  # Public: Defines a double_range attribute for the model.
+  #
+  # Examples
+  #
+  #   class MyModel < Stretchy::Record
+  #     attribute :weight_range, :double_range
+  #   end
+  #
+  # Returns nothing.
+  class DoubleRange < Base
+
+    def type
+      :double_range
+    end
+  end
+end

data/lib/stretchy/attributes/type/range/float_range.rb

@@ -0,0 +1,16 @@
+module Stretchy::Attributes::Type::Range
+  # Public: Defines a float_range attribute for the model.
+  #
+  # Examples
+  #
+  #   class MyModel < Stretchy::Record
+  #     attribute :rating_range, :float_range
+  #   end
+  #
+  # Returns nothing.
+  class FloatRange < Base
+    def type
+      :float_range
+    end
+  end
+end

data/lib/stretchy/attributes/type/range/integer_range.rb

@@ -0,0 +1,16 @@
+module Stretchy::Attributes::Type::Range
+  # Public: Defines an integer_range attribute for the model.
+  #
+  # Examples
+  #
+  #   class MyModel < Stretchy::Record
+  #     attribute :age_range, :integer_range
+  #   end
+  #
+  # Returns nothing.
+  class IntegerRange < Base
+    def type
+      :integer_range
+    end
+  end
+end

data/lib/stretchy/attributes/type/range/ip_range.rb

@@ -0,0 +1,16 @@
+module Stretchy::Attributes::Type::Range
+  # Public: Defines an ip_range attribute for the model.
+  #
+  # Examples
+  #
+  #   class MyModel < Stretchy::Record
+  #     attribute :ip_range, :ip_range
+  #   end
+  #
+  # Returns nothing.
+  class IpRange < Base
+    def type
+      :ip_range
+    end
+  end
+end

data/lib/stretchy/attributes/type/range/long_range.rb

@@ -0,0 +1,16 @@
+module Stretchy::Attributes::Type::Range
+  # Public: Defines a long_range attribute for the model.
+  #
+  # Examples
+  #
+  #   class MyModel < Stretchy::Record
+  #     attribute :population_range, :long_range
+  #   end
+  #
+  # Returns nothing.
+  class LongRange < Base
+    def type
+      :long_range
+    end
+  end
+end

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

@@ -0,0 +1,21 @@
+module Stretchy::Attributes::Type
+  # Public: Defines a rank_feature attribute for the model.
+  #
+  # opts - The Hash options used to refine the attribute (default: {}):
+  #        :positive_score_impact - The Boolean indicating if features correlate positively with the score. If set to false, the score decreases with the value of the feature instead of increasing. Defaults to true.
+  #
+  # Examples
+  #
+  #   class MyModel < Stretchy::Record
+  #     attribute :url_length, :rank_feature, positive_score_impact: false
+  #   end
+  #
+  # Returns nothing.
+  class RankFeature < Stretchy::Attributes::Type::Base
+    OPTIONS = [:positive_score_impact]
+
+    def type
+      :rank_feature
+    end
+  end
+end