You may initialize a Dash with an attributes hash just like you would many other kinds of data objects.
# File lib/hashie/dash.rb, line 104 def initialize(attributes = {}, &block) super(&block) self.class.defaults.each_pair do |prop, value| self[prop] = begin val = value.dup if val.is_a?(Proc) val.arity == 1 ? val.call(self) : val.call else val end rescue TypeError value end end initialize_attributes(attributes) assert_required_attributes_set! end
Retrieve a value from the Dash (will return the property's default value if it hasn't been set).
# File lib/hashie/dash.rb, line 130 def [](property) assert_property_exists! property value = super(property) # If the value is a lambda, proc, or whatever answers to call, eval the thing! if value.is_a? Proc self[property] = value.call # Set the result of the call as a value else yield value if block_given? value end end
Set a value on the Dash in a Hash-like way. Only works on pre-existing properties.
# File lib/hashie/dash.rb, line 144 def []=(property, value) assert_property_required! property, value assert_property_exists! property super(property, value) end
# File lib/hashie/dash.rb, line 203 def assert_property_exists!(property) fail_no_property_error!(property) unless self.class.property?(property) end
# File lib/hashie/dash.rb, line 217 def assert_property_required!(property, value) fail_property_required_error!(property) if value.nil? && required?(property) end
# File lib/hashie/dash.rb, line 213 def assert_property_set!(property) fail_property_required_error!(property) if send(property).nil? && required?(property) end
# File lib/hashie/dash.rb, line 207 def assert_required_attributes_set! self.class.required_properties.each_key do |required_property| assert_property_set!(required_property) end end
# File lib/hashie/dash.rb, line 225 def fail_no_property_error!(property) raise NoMethodError, "The property '#{property}' is not defined for #{self.class.name}." end
# File lib/hashie/dash.rb, line 221 def fail_property_required_error!(property) raise ArgumentError, "The property '#{property}' #{self.class.required_properties[property][:message]}" end
# File lib/hashie/dash.rb, line 188 def initialize_attributes(attributes) return unless attributes cleaned_attributes = attributes.reject { |_attr, value| value.nil? } update_attributes(cleaned_attributes) end
# File lib/hashie/dash.rb, line 150 def merge(other_hash) new_dash = dup other_hash.each do |k, v| new_dash[k] = block_given? ? yield(k, self[k], v) : v end new_dash end
# File lib/hashie/dash.rb, line 158 def merge!(other_hash) other_hash.each do |k, v| self[k] = block_given? ? yield(k, self[k], v) : v end self end
# File lib/hashie/dash.rb, line 165 def replace(other_hash) other_hash = self.class.defaults.merge(other_hash) (keys - other_hash.keys).each { |key| delete(key) } other_hash.each { |key, value| self[key] = value } self end
# File lib/hashie/dash.rb, line 229 def required?(property) return false unless self.class.required?(property) condition = self.class.required_properties[property][:condition] case condition when Proc then !!instance_exec(&condition) when Symbol then !!send(condition) else !!condition end end
# File lib/hashie/dash.rb, line 195 def update_attributes(attributes) return unless attributes attributes.each_pair do |att, value| self[att] = value end end
# File lib/hashie/dash.rb, line 172 def update_attributes!(attributes) update_attributes(attributes) self.class.defaults.each_pair do |prop, value| next unless self[prop].nil? self[prop] = begin value.dup rescue TypeError value end end assert_required_attributes_set! end