Module: Morph

Defined in:
lib/morph.rb

Defined Under Namespace

Modules: ClassMethods, MethodMissing

Constant Summary collapse

VERSION = 
'0.6.0'

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.classes ⇒ Object 



130
131
132
 
# File 'lib/morph.rb', line 130

def classes
  Chas.morph_classes
end

.from_csv(csv, class_name, namespace = Morph) ⇒ Object 



150
151
152
153
154
155
156
157
158
159
160
 
# File 'lib/morph.rb', line 150

def from_csv csv, class_name, namespace=Morph
  objects = []
  CSV.parse(csv, { :headers => true }) do |row|
    object = object_from_name class_name, namespace
    row.each do |key, value|
      object.morph(key, value)
    end
    objects << object
  end
  objects
end

.from_hash(hash, namespace = Morph) ⇒ Object 



190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
 
# File 'lib/morph.rb', line 190

def from_hash hash, namespace=Morph
  if hash.keys.size == 1
    name = hash.keys.first

    case hash[name]
    when Hash
      object_from_hash hash[name], name, namespace
    when Array
      objects_from_array hash[name], name, namespace
    else
      raise 'hash root value must be a Hash or an Array'
    end
  else
    raise 'hash must have single key'
  end
end

.from_json(json, root_key = nil, namespace = Morph) ⇒ Object 



183
184
185
186
187
188
 
# File 'lib/morph.rb', line 183

def from_json json, root_key=nil, namespace=Morph
  require 'json' unless defined? JSON
  hash = JSON.parse json
  hash = { root_key => hash } if root_key
  from_hash hash, namespace
end

.from_tsv(tsv, class_name, namespace = Morph) ⇒ Object 



162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
 
# File 'lib/morph.rb', line 162

def from_tsv tsv, class_name, namespace=Morph
  lines = tsv.split("\n")
  attributes = lines[0].split("\t")
  lines = lines[1..(lines.length-1)]
  objects = []
  lines.each do |line|
    values = line.split("\t")
    object = object_from_name class_name, namespace
    attributes.each_with_index do |attribute, index|
      object.morph(attribute, values[index])
    end
    objects << object
  end
  objects
end

.from_xml(xml, namespace = Morph) ⇒ Object 



178
179
180
181
 
# File 'lib/morph.rb', line 178

def from_xml xml, namespace=Morph
  hash = Hash.from_xml xml
  from_hash hash, namespace
end

.generate_migrations(object, options = {}) ⇒ Object 



142
143
144
145
146
147
148
 
# File 'lib/morph.rb', line 142

def generate_migrations object, options={}
  options[:ignore] ||= []
  options[:belongs_to_id] ||= ''
  migrations = []
  name = object.class.name.demodulize.underscore
  add_migration name, object.morph_attributes, migrations, options
end

.included(base) ⇒ Object 



216
217
218
219
 
# File 'lib/morph.rb', line 216

def included(base)
  base.extend ClassMethods
  base.send(:include, MethodMissing)
end

.register_listener(listener) ⇒ Object 



134
135
136
 
# File 'lib/morph.rb', line 134

def register_listener listener
  Chas.register_listener listener
end

.script_generate(morphed_class, options = {}) ⇒ Object 



207
208
209
210
211
212
213
214
 
# File 'lib/morph.rb', line 207

def script_generate morphed_class, options={}
  name = morphed_class.name.to_s.split('::').last
  name = yield name if block_given?
  generator = options[:generator] || 'model'
  line = ["rails destroy #{generator} #{name}; rails generate #{generator} #{name}"]
  morphed_class.morph_methods.select{|m| not(m =~ /=$/) }.each {|attribute| line << " #{attribute}:string"}
  line.join('')
end

.unregister_listener(listener) ⇒ Object 



138
139
140
 
# File 'lib/morph.rb', line 138

def unregister_listener listener
  Chas.unregister_listener listener
end

Instance Method Details

#morph(attributes_or_label, value = nil) ⇒ Object

Set attribute value(s). Adds accessor methods to class if they are not already present.

Can be called with a string and a value, a symbol and a value, or with a hash of attribute to value pairs. For example.

require 'rubygems'; require 'morph'

class Order; include Morph; end

order = Order.new
order.morph :drink => 'tea', :sugars => 2, 'milk' => 'yes please'
order.morph 'Payment type:', 'will wash dishes'
order.morph :lemon, false

p order # -> #<Order:0x33c50c @lemon=false, @milk="yes please",
             @payment_type="will wash dishes", @sugars=2, @drink="tea">



358
359
360
361
362
363
364
365
 
# File 'lib/morph.rb', line 358

def morph attributes_or_label, value=nil
  if attributes_or_label.is_a? Hash
    attributes_or_label.each { |a, v| morph(a, v) }
  else
    attribute = Chas.convert_to_morph_method_name(attributes_or_label)
    send("#{attribute}=".to_sym, value)
  end
end

#morph_attributes ⇒ Object 



367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
 
# File 'lib/morph.rb', line 367

def morph_attributes
  attributes = self.class.morph_attributes.inject({}) do |hash, attribute|
    unless attribute =~ /=\Z/
      symbol = attribute.to_sym
      value = send(symbol)

      value.each do |key, v|
        value[key] = v.morph_attributes if v.respond_to?(:morph_attributes)
      end if value.is_a? Hash

      value = value.collect {|v| v.respond_to?(:morph_attributes) ? v.morph_attributes : v } if value.is_a? Array
      value = value.morph_attributes if value.respond_to? :morph_attributes

      hash[symbol] = value
    end
    hash
  end
end