stretchy-model 0.6.0 → 0.6.6

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/attributes/transformers/keyword_transformer.rb

@@ -1,6 +1,20 @@
 module Stretchy
   module Attributes
     module Transformers
+      # Applies transformations to keyword fields in queries
+      #
+      # ### Examples
+      #
+      # ```ruby
+      # class Goat < StretchyModel
+      #  attribute :name, :keyword
+      #  attribute :age, :integer
+      # end
+      # 
+      # Goat.where(name: 'billy').to_elastic
+      # # => {query: {term: {'name.keyword': 'billy'}}}
+      #
+      # ```
       class KeywordTransformer
 
           KEYWORD_AGGREGATION_KEYS = [:terms, :rare_terms, :significant_terms, :cardinality, :string_stats]
@@ -24,61 +38,53 @@ module Stretchy
             end
           end
           
-          def keyword?(arg)
-            attr = @attribute_types[arg.to_s] 
-            return false unless attr
-            attr.is_a?(Stretchy::Attributes::Type::Keyword)
+          def keyword_available?(arg)
+            attrib = @attribute_types[arg.to_s.split(".").first] 
+            return false unless attrib 
+            attrib.respond_to?(:keyword_field?) && attrib.keyword_field?
+          end
+
+          def keyword_field_for(arg)
+            attrib = @attribute_types[arg.to_s.split(".").first]
+            keyword_field = attrib.respond_to?(:fields) ? attrib.fields.find { |k,d| d[:type].to_sym == :keyword }&.first : nil
+            keyword_field || Stretchy.configuration.default_keyword_field
           end
 
           def protected?(arg)
             return false if arg.nil?
-            Stretchy::Relations::AggregationMethods::AGGREGATION_METHODS.include?(arg.to_sym)
+            Stretchy::Relations::AggregationMethods.registry.include?(arg.to_sym)
           end
           
+          # Add `.keyword` to attributes that have a keyword subfield but aren't `:keywords`
+          # this is for text fields that have a keyword subfield
+          # `:text` and `:string` fields add a `:keyword` subfield to the attribute mapping automatically
           def transform(item, *ignore) 
-            item.each_with_object({}) do |(k, v), new_item|
-              if ignore && ignore.include?(k)
-                new_item[k] = v
+            return item unless Stretchy.configuration.auto_target_keywords
+            if item.is_a?(String)
+              return (!protected?(item) && keyword_available?(item)) ? "#{item}.#{keyword_field_for(item)}" : item 
+            end
+            item.each_with_object({}) do |(key, value), new_item|
+              if ignore && ignore.include?(key)
+                new_item[key] = value
                 next
               end
-              new_key = (!protected?(k) && keyword?(k)) ? "#{k}.keyword" : k
 
-              new_value = v
+              new_key = (!protected?(key) && keyword_available?(key)) ? "#{key}.#{keyword_field_for(key)}" : key
+
+              new_value = value
           
               if new_value.is_a?(Hash)
-                new_value = transform(new_value)
+                new_value = transform(new_value, *ignore)
               elsif new_value.is_a?(Array)
-                new_value = new_value.map { |i| i.is_a?(Hash) ? transform(i) : i }
+                new_value = new_value.map { |i| i.is_a?(Hash) ? transform(i, *ignore) : i }
               elsif new_value.is_a?(String) || new_value.is_a?(Symbol) 
-                new_value = "#{new_value}.keyword" if keyword?(new_value)
+                new_value = "#{new_value}.#{keyword_field_for(new_value)}" if keyword_available?(new_value) && new_value.to_s !~  Regexp.new("\.#{keyword_field_for(new_value)}$")
               end
 
               new_item[new_key] = new_value
             end
           end
 
-          # If terms are used, we assume that the field is a keyword field
-          # and append .keyword to the field name
-          # {terms: {field: 'gender'}}
-          # or nested aggs
-          # {terms: {field: 'gender'}, aggs: {name: {terms: {field: 'position.name'}}}}
-          # should be converted to
-          # {terms: {field: 'gender.keyword'}, aggs: {name: {terms: {field: 'position.name.keyword'}}}}
-          # {date_histogram: {field: 'created_at', interval: 'day'}}
-          # TODO: There may be cases where we don't want to add .keyword to the field and there should be a way to override this
-          def assume_keyword_field(args={}, parent_match=false)
-            if args.is_a?(Hash)
-              args.each do |k, v|
-                if v.is_a?(Hash) 
-                  assume_keyword_field(v, KEYWORD_AGGREGATION_FIELDS.include?(k))
-                else
-                  next unless v.is_a?(String) || v.is_a?(Symbol)
-                  args[k] = ([:field, :fields].include?(k.to_sym) && v !~ /\.keyword$/ && parent_match) ? "#{v}.keyword" : v.to_s
-                end
-              end
-            end
-          end
-
       end
     end
   end

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

@@ -1,5 +1,28 @@
 module Stretchy::Attributes::Type
-  class Array < Stretchy::Attributes::Type::Base # :nodoc:
+  # The Array attribute type
+  #
+  # This class is used to define an array attribute for a model. It provides support for the Elasticsearch array data type, which is a type of data type that can hold multiple values.
+  #
+  # ### Parameters
+  #
+  # - `type:` `:array`.
+  # - `options:` The Hash of options for the attribute.
+  #    - `:data_type:` The Symbol representing the data type for the array. Defaults to `:text`.
+  #    - `:fields:` The Boolean indicating if fields should be included in the mapping. Defaults to `true`.
+  #
+  # ---
+  #
+  # ### Examples
+  #
+  # #### Define an array attribute
+  #
+  # ```ruby
+  #   class MyModel < StretchyModel
+  #     attribute :tags, :array, data_type: :text
+  #   end
+  # ```
+  #
+  class Array < Stretchy::Attributes::Type::Base
     OPTIONS = [:data_type, :fields]
     def type
       :array

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

@@ -5,7 +5,6 @@ module Stretchy
 
               OPTIONS = []
 
-      
               def initialize(**args)
 
                 define_option_methods!
@@ -13,11 +12,16 @@ module Stretchy
                 args.each do |k, v|
                   if self.class::OPTIONS.include?(k)
                     instance_variable_set("@#{k}", v) 
-                    args.delete(k)
                   end
+                  args.delete(k)
                 end
                 super
               end
+
+              def keyword_field?
+                return false unless respond_to? :fields
+                fields.present? && fields.include?(:keyword)
+              end
       
               def mappings(name)
                 options = {type: type_for_database}

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

@@ -1,23 +1,30 @@
-# 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
+            # The Binary attribute type
+            #
+            # This class is used to define a binary attribute for a model. It provides support for the Elasticsearch binary data type, which is a type of data type that can hold binary data.
+            #
+            # ### Parameters
+            #
+            # - `type:` `:binary`.
+            # - `options:` The Hash of options for the attribute.
+            #    - `: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
+            #
+            # #### Define a binary attribute
+            #
+            # ```ruby
+            #   class MyModel < StretchyModel
+            #     attribute :data, :binary, doc_values: true, store: true
+            #   end
+            # ```
+            #
+            class Binary < Stretchy::Attributes::Type::Base
                 OPTIONS = [:doc_values, :store]
                 attr_reader *OPTIONS 
 

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

@@ -1,28 +1,35 @@
-# 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
+      # The Boolean attribute type
+      #
+      # This class is used to define a boolean attribute for a model. It provides support for the Elasticsearch boolean data type, which is a type of data type that can hold true or false values.
+      #
+      # ### Parameters
+      #
+      # - `type:` `:boolean`.
+      # - `options:` The Hash of options for the attribute.
+      #    - `: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
+      #
+      # #### Define a boolean attribute
+      #
+      # ```ruby
+      #   class MyModel < StretchyModel
+      #     attribute :is_active, :boolean, doc_values: true, store: true
+      #   end
+      # ```
+      #
       class Boolean < Stretchy::Attributes::Type::Base
 
         OPTIONS = [:doc_values, :index, :ignore_malformed, :null_value, :on_script_error, :script, :store, :meta]

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

@@ -1,20 +1,28 @@
 module Stretchy::Attributes::Type
-  # Public: Defines a completion attribute for the model.
+  # Completion attribute type for Elasticsearch completion suggester.
   #
-  # 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.
+  # This class is used to define a completion attribute for a model. It provides support for the Elasticsearch completion suggester, which is a type of suggester that provides auto-complete functionality.
   #
-  # Examples
+  # ### Parameters
   #
-  #   class MyModel < Stretchy::Record
+  # - `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
+  #
+  # #### Define a completion attribute
+  #
+  # ```ruby
+  #   class MyModel < StretchyModel
   #     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

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

@@ -1,33 +1,42 @@
 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
+  # The ConstantKeyword attribute type
+  #
+  # This class is used to define a constant_keyword attribute for a model. This field type is a specialization of the keyword field, but it only accepts a single value.
+  #
+  # ### Parameters
+  #
+  # - `type:` `:constant_keyword`.
+  # - `options:` The Hash of options for the attribute.
+  #    - `: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
+  #
+  # #### Define a constant_keyword attribute
+  #
+  # ```ruby
+  #   class MyModel < StretchyModel
   #     attribute :status, :constant_keyword, value: 'active'
   #   end
+  # ```
   #
-  # Returns nothing.
   class ConstantKeyword < Stretchy::Attributes::Type::Keyword
     OPTIONS = OPTIONS + [:value]
     attr_reader *OPTIONS

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

@@ -1,35 +1,96 @@
 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
+  # The DateTime attribute type
+  #
+  # This class is used to define a datetime attribute for a model. It provides support for the Elasticsearch date data type, which is a type of data type that can hold dates.
+  #
+  # ### Parameters
+  #
+  # - `type:` `:datetime`.
+  # - `options:` The Hash of options for the attribute.
+  #    - `:doc_values:` The Boolean indicating if the field should be stored on disk in a column-stride fashion. 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
+  #
+  # #### Define a datetime attribute
+  #
+  # ```ruby
+  #   class MyModel < StretchyModel
   #     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
+    attr_reader *OPTIONS + self.superclass::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
 
+    # Returns the type `:date` for the database.
+    #
     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