Module: Cistern::Attributes::InstanceMethods

Included in:
Model
Defined in:
lib/cistern/attributes.rb

Instance Method Summary collapse

Instance Method Details

#attributes ⇒ Object 



169
170
171
 
# File 'lib/cistern/attributes.rb', line 169

def attributes
  @attributes ||= {}
end

#changed ⇒ Object 



262
263
264
 
# File 'lib/cistern/attributes.rb', line 262

def changed
  @changes ||= {}
end

#clone_attributes ⇒ Object 



128
129
130
 
# File 'lib/cistern/attributes.rb', line 128

def clone_attributes
  Marshal.load Marshal.dump(attributes)
end

#dirty? ⇒ Boolean

Returns:

  • (Boolean) 


254
255
256
 
# File 'lib/cistern/attributes.rb', line 254

def dirty?
  changed.any?
end

#dirty_attributes ⇒ Object 



258
259
260
 
# File 'lib/cistern/attributes.rb', line 258

def dirty_attributes
  changed.inject({}) { |r, (k, (_, v))| r.merge(k => v) }
end

#dirty_request_attributes ⇒ Object 



274
275
276
 
# File 'lib/cistern/attributes.rb', line 274

def dirty_request_attributes
  request_attributes(dirty_attributes)
end

#dup ⇒ Object 



173
174
175
 
# File 'lib/cistern/attributes.rb', line 173

def dup
  super.tap { |m| m.set_attributes attributes.dup }
end

#identity ⇒ Object 



177
178
179
180
181
 
# File 'lib/cistern/attributes.rb', line 177

def identity
  key = self.class.identity

  public_send(key) if key
end

#identity=(new_identity) ⇒ Object 



183
184
185
186
187
188
189
190
191
 
# File 'lib/cistern/attributes.rb', line 183

def identity=(new_identity)
  key = self.class.identity

  if key
    public_send("#{key}=", new_identity)
  else
    fail ArgumentError, 'Identity not specified'
  end
end

#merge_attributes(new_attributes = {}) ⇒ Object Also known as: attributes=

Update model’s attributes. New attributes take precedence over existing attributes.

This is bst called within a Model#save, when #new_attributes represents a recently presented remote resource. #dirty_attributes is cleared after merging.

Parameters:

  • new_attributes (Hash) (defaults to: {}) —

    attributes to merge with current attributes



199
200
201
202
203
204
205
 
# File 'lib/cistern/attributes.rb', line 199

def merge_attributes(new_attributes = {})
  _merge_attributes(new_attributes)

  changed.clear

  self
end

#new_record? ⇒ Boolean

Returns:

  • (Boolean) 


220
221
222
 
# File 'lib/cistern/attributes.rb', line 220

def new_record?
  identity.nil?
end

#read_attribute(name) ⇒ Object 



132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
 
# File 'lib/cistern/attributes.rb', line 132

def read_attribute(name)
  key = name.to_sym

  options = self.class.attributes[key]
  default = options[:default]

  # record the attribute was accessed
  if defined?(Cistern::Coverage) && options[:coverage_hits]
    options[:coverage_hits] += 1
  end

  default = Marshal.load(Marshal.dump(default)) unless default.nil?

  attributes.fetch(key, default)
end

#request_attributes(set = attributes) ⇒ Object 



266
267
268
269
270
271
272
 
# File 'lib/cistern/attributes.rb', line 266

def request_attributes(set = attributes)
  set.inject({}) do |a,(k,v)|
    aliases = self.class.attributes[k.to_sym][:aliases]
    aliases << k if aliases.empty?
    aliases.each_with_object(a) { |n,r| r[n.to_s] = v }
  end
end

#requires(*args) ⇒ Hash

Require specification of certain attributes

Returns:

  • (Hash) —

    of matching attributes

Raises:

  • (ArgumentError) —

    if any requested attribute does not have a value



228
229
230
231
232
233
234
235
236
237
238
 
# File 'lib/cistern/attributes.rb', line 228

def requires(*args)
  missing, required = missing_attributes(args)

  if missing.length == 1
    fail(ArgumentError, "#{missing.keys.first} is required for this operation")
  elsif missing.any?
    fail(ArgumentError, "#{missing.keys[0...-1].join(', ')} and #{missing.keys[-1]} are required for this operation")
  end

  required
end

#requires_one(*args) ⇒ Hash

Require specification of one or more attributes.

Returns:

  • (Hash) —

    of matching attributes

Raises:

  • (ArgumentError) —

    if no requested attributes have values



244
245
246
247
248
249
250
251
252
 
# File 'lib/cistern/attributes.rb', line 244

def requires_one(*args)
  missing, required = missing_attributes(args)

  if missing.length == args.length
    fail(ArgumentError, "#{missing.keys[0...-1].join(', ')} or #{missing.keys[-1]} are required for this operation")
  end

  required
end

#stage_attributes(new_attributes = {}) ⇒ Object

Update model’s attributes. New attributes take precedence over existing attributes.

This is best called within a Model#update, when #new_attributes represents attributes to be presented to a remote service. #dirty_attributes will contain the valid portion of #new_attributes

Parameters:

  • new_attributes (Hash) (defaults to: {}) —

    attributes to merge with current attributes



215
216
217
218
 
# File 'lib/cistern/attributes.rb', line 215

def stage_attributes(new_attributes = {})
  _merge_attributes(new_attributes)
  self
end

#write_attribute(name, value) ⇒ Object 



148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
 
# File 'lib/cistern/attributes.rb', line 148

def write_attribute(name, value)
  options = self.class.attributes[name] || {}

  transform = options[:transform]

  parser = options[:parser]

  transformed = transform.call(name, value, options)

  new_value = parser.call(transformed, options)
  attribute = name.to_s.to_sym

  previous_value = read_attribute(name)

  attributes[attribute] = new_value

  changed!(attribute, previous_value, new_value)

  new_value
end