Class: Hashie::Dash
- Includes:
- Extensions::PrettyInspect
- Defined in:
- lib/hashie/dash.rb
Overview
A Dash is a 'defined' or 'discrete' Hash, that is, a Hash that has a set of defined keys that are accessible (with optional defaults) and only those keys may be set or read.
Dashes are useful when you need to create a very simple lightweight data object that needs even fewer options and resources than something like a DataMapper resource.
It is preferrable to a Struct because of the in-class API for defining properties as well as per-property defaults.
Direct Known Subclasses
Class Attribute Summary collapse
-
.defaults ⇒ Object
readonly
Returns the value of attribute defaults.
-
.properties ⇒ Object
readonly
Returns the value of attribute properties.
-
.required_properties ⇒ Object
readonly
Returns the value of attribute required_properties.
Class Method Summary collapse
- .inherited(klass) ⇒ Object
-
.property(property_name, options = {}) ⇒ Object
Defines a property on the Dash.
-
.property?(name) ⇒ Boolean
Check to see if the specified property has already been defined.
-
.required?(name) ⇒ Boolean
Check to see if the specified property is required.
Instance Method Summary collapse
-
#[](property) ⇒ Object
Retrieve a value from the Dash (will return the property's default value if it hasn't been set).
-
#[]=(property, value) ⇒ Object
Set a value on the Dash in a Hash-like way.
-
#initialize(attributes = {}, &block) ⇒ Dash
constructor
You may initialize a Dash with an attributes hash just like you would many other kinds of data objects.
- #merge(other_hash) ⇒ Object
- #merge!(other_hash) ⇒ Object
- #replace(other_hash) ⇒ Object
- #update_attributes!(attributes) ⇒ Object
Methods included from Extensions::PrettyInspect
Methods inherited from Hash
Methods included from Extensions::StringifyKeys
#stringify_keys, #stringify_keys!
Constructor Details
#initialize(attributes = {}, &block) ⇒ Dash
You may initialize a Dash with an attributes hash just like you would many other kinds of data objects.
82 83 84 85 86 87 88 89 90 91 92 93 94 95 |
# File 'lib/hashie/dash.rb', line 82 def initialize(attributes = {}, &block) super(&block) self.class.defaults.each_pair do |prop, value| self[prop] = begin value.dup rescue TypeError value end end initialize_attributes(attributes) assert_required_attributes_set! end |
Class Attribute Details
.defaults ⇒ Object (readonly)
Returns the value of attribute defaults.
53 54 55 |
# File 'lib/hashie/dash.rb', line 53 def defaults @defaults end |
.properties ⇒ Object (readonly)
Returns the value of attribute properties.
53 54 55 |
# File 'lib/hashie/dash.rb', line 53 def properties @properties end |
.required_properties ⇒ Object (readonly)
Returns the value of attribute required_properties.
54 55 56 |
# File 'lib/hashie/dash.rb', line 54 def required_properties @required_properties end |
Class Method Details
.inherited(klass) ⇒ Object
60 61 62 63 64 65 66 |
# File 'lib/hashie/dash.rb', line 60 def self.inherited(klass) super (@subclasses ||= Set.new) << klass klass.instance_variable_set('@properties', properties.dup) klass.instance_variable_set('@defaults', defaults.dup) klass.instance_variable_set('@required_properties', required_properties.dup) end |
.property(property_name, options = {}) ⇒ Object
Defines a property on the Dash. Options are as follows:
:default - Specify a default value for this property, to be returned before a value is set on the property in a new Dash.
:required - Specify the value as required for this property, to raise an error if a value is unset in a new or existing Dash.
31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 |
# File 'lib/hashie/dash.rb', line 31 def self.property(property_name, = {}) properties << property_name if .key?(:default) defaults[property_name] = [:default] elsif defaults.key?(property_name) defaults.delete property_name end unless instance_methods.map { |m| m.to_s }.include?("#{property_name}=") define_method(property_name) { |&block| self.[](property_name, &block) } property_assignment = property_name.to_s.concat('=').to_sym define_method(property_assignment) { |value| self.[]=(property_name, value) } end if defined? @subclasses @subclasses.each { |klass| klass.property(property_name, ) } end required_properties << property_name if .delete(:required) end |
.property?(name) ⇒ Boolean
Check to see if the specified property has already been defined.
70 71 72 |
# File 'lib/hashie/dash.rb', line 70 def self.property?(name) properties.include? name end |
.required?(name) ⇒ Boolean
Check to see if the specified property is required.
76 77 78 |
# File 'lib/hashie/dash.rb', line 76 def self.required?(name) required_properties.include? name end |
Instance Method Details
#[](property) ⇒ Object
Retrieve a value from the Dash (will return the property's default value if it hasn't been set).
103 104 105 106 107 108 109 110 111 112 113 |
# File 'lib/hashie/dash.rb', line 103 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 |
#[]=(property, value) ⇒ Object
Set a value on the Dash in a Hash-like way. Only works on pre-existing properties.
117 118 119 120 121 |
# File 'lib/hashie/dash.rb', line 117 def []=(property, value) assert_property_required! property, value assert_property_exists! property super(property, value) end |
#merge(other_hash) ⇒ Object
123 124 125 126 127 128 129 |
# File 'lib/hashie/dash.rb', line 123 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 |
#merge!(other_hash) ⇒ Object
131 132 133 134 135 136 |
# File 'lib/hashie/dash.rb', line 131 def merge!(other_hash) other_hash.each do |k, v| self[k] = block_given? ? yield(k, self[k], v) : v end self end |
#replace(other_hash) ⇒ Object
138 139 140 141 142 143 |
# File 'lib/hashie/dash.rb', line 138 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 |
#update_attributes!(attributes) ⇒ Object
145 146 147 148 149 150 151 152 153 154 155 156 |
# File 'lib/hashie/dash.rb', line 145 def update_attributes!(attributes) initialize_attributes(attributes) self.class.defaults.each_pair do |prop, value| self[prop] = begin value.dup rescue TypeError value end if self[prop].nil? end assert_required_attributes_set! end |