morph 0.3.7 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c12c6f354c52dd3e39c28ea48a9a6aaac2dea6b3
-  data.tar.gz: a56834d98a549d7a5e7b8a218bda2d0adb7a3acc
+  metadata.gz: dba2306af06acc1d857bb2a18f239d9e91a60adb
+  data.tar.gz: e27fce32e999fb4a2ba9909f037ab5e6820b91a8
 SHA512:
-  metadata.gz: 521c12953766c73f27ef1409264b448d5fe76df0b236ecd9a6e6a1dc6cd2cf3bf6094e3f179f19d63f5ffbae1b17db785b5f372f19eab764fbe62f109382f5f6
-  data.tar.gz: e049d3f4e85e0510602886c090cc37ede43b8fdd1f1d18756f7cc110488c68afa1f7d2e3955b7934e88307377cedf18ee1d62ac6a85cfbc71279432701f28c6a
+  metadata.gz: 46b5e3356b1ce4dda6b611fe005c2393ffb2f1df0856eb8dc844e4f4623eba96b8dc84e227e6885cabea9e42a6de21ca890e61c9fa33e5837e7133a04041b3e8
+  data.tar.gz: 812b34cc1a12d5985619becf42f8a1ed7bdc6dbe7b80883830cf67149eaf61fa8734023b49b1e34365ff014897476b0b09babe090a5d1a8b84dffa9684d58db8

data/CHANGELOG

@@ -1,3 +1,5 @@
+v0.4.0. add from_json() and register_listener() methods
+
 v0.3.7. don't mix in private methods when Morph is included
 
 v0.3.6. call to_time() on XMLRPC::DateTime when setting it as an attribute value
@@ -6,7 +8,7 @@ v0.3.5. retain morph_methods when inheriting class and parent both include Morph
 
 v0.3.4. return instance morph_attributes ordered by original addition of attribute
 
-v0.3.3. removed show_ruby() method; updated script_generate() to utilise new rails commands
+v0.3.3. remove show_ruby() method; updated script_generate() to utilise new rails commands
 
 v0.3.2. from_hash() can now handle keys that are symbols
 
@@ -14,9 +16,9 @@ v0.3.1. only show fastercsv install message if Morph.from_csv() called
 
 v0.3.0. modifications for ruby 1.9.2 compatibility
 
-v0.2.9. added from_csv(); require fastercsv; added morph_attributes() class method
+v0.2.9. add from_csv(); require fastercsv; add morph_attributes() class method
 
-v0.2.8. added from_xml() and from_tsv(); updated for active_support; fixed from_hash() when hash root is an array
+v0.2.8. add from_xml() and from_tsv(); updated for active_support; fix from_hash() when hash root is an array
 
 v0.2.7. handle dash when converting to method name, reported by danwrong
 
@@ -26,21 +28,21 @@ v0.2.5. camelize names for classes in from_hash()
 
 v0.2.4. from_hash() creates classes in Morph namespace and handles arrays of hashes
 
-v0.2.3. added Morph.from_hash method
+v0.2.3. add Morph.from_hash method
 
-v0.2.2. changed rubygem requirement to be >= 1.2 instead of = 1.2
+v0.2.2. change rubygem requirement to be >= 1.2 instead of = 1.2
 
 v0.2.1. better accomodation of unicode method names
 
-v0.2.0. added script_generate method; fixed bug occurring when two morph classes exist
+v0.2.0. add script_generate method; fix bug occurring when two morph classes exist
 
-v0.1.5. added morph_attributes instance method
+v0.1.5. add morph_attributes instance method
 
 v0.1.4. can now pass code block to customize the dynamically added methods
 
 v0.1.3. can now set hash of attributes via morph method
 
-v0.1.2. fixed problems in packaging of v0.1.1 gem
+v0.1.2. fix problems in packaging of v0.1.1 gem
 
 v0.1.1. calling unknown reader method no longer adds accessor methods to class
 

data/LICENSE

@@ -1,18 +1,21 @@
-Copyright 2008 Rob McKinnon
+The MIT License (MIT)
+
+Copyright (c) 2016 Rob McKinnon
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to
-deal in the Software without restriction, including without limitation the
-rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
-sell copies of the Software, and to permit persons to whom the Software is
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
 furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
-THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
-IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
-CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,295 @@
+Morph allows you to emerge Ruby class definitions from data or by calling assignment methods.
+
+[![Build Status](https://travis-ci.org/robmckinnon/morph.svg?branch=master)](https://travis-ci.org/robmckinnon/morph)
+
+## Installing Morph
+
+    gem install morph
+
+To use Morph:
+
+    require 'morph'
+
+Tested to work with Ruby 1.8 - 2.3, JRuby 9, and Rubinius 3.
+
+## Morph creating classes `from_json`
+
+Here's an example showing Morph creating classes and objects from JSON:
+
+    json = '{
+      "id": "3599110793",
+      "type": "PushEvent",
+      "actor": {
+        "id": 3447,
+        "login": "robmckinnon",
+        "url": "https://api.github.com/users/robmckinnon"
+      },
+      "repo": {
+        "id": 5092,
+        "name": "robmckinnon/morph",
+        "url": "https://api.github.com/repos/robmckinnon/morph"
+      }
+    }'
+
+    module Github; end
+
+    type = :push_event
+    namespace = Github
+
+    event = Morph.from_json json, type, namespace
+
+    # => <Github::PushEvent @id="3599110793", @type="PushEvent",
+        @actor=#<Github::Actor:0x007faa0c86b790 @id=3447, @login="robmckinnon",
+          @url="https://api.github.com/users/robmckinnon">,
+        @repo=#<Github::Repo:0x007faa0c869198 @id=5092, @name="robmckinnon/morph",
+          @url="https://api.github.com/repos/robmckinnon/morph">
+      >
+
+    event.class
+
+    # => Github::PushEvent
+
+    event.class.morph_attributes
+
+    # => [:id, :type, :actor, :repo]
+
+    event.actor.class
+
+    # => Github::Actor
+
+    event.repo.class
+
+    # => Github::Repo
+
+If namespace module not provided, new classes are created in Morph module.
+
+    event = Morph.from_json json, type, namespace
+
+    event.class
+
+    # => Morph::PushEvent
+
+## Morph creating classes `from_csv`
+
+Here's an example showing Morph playing with CSV (comma-separated values):
+
+    csv = %Q[name,party\nTed Roe,red\nAli Davidson,blue\nSue Smith,green]
+
+    people = Morph.from_csv(csv, 'person')
+
+    # => [#<Morph::Person @name="Ted Roe", @party="red">,
+       #<Morph::Person @name="Ali Davidson", @party="blue">,
+       #<Morph::Person @name="Sue Smith", @party="green">]
+
+    people.last.party
+
+    # => "green"
+
+## Morph creating classes `from_tsv`
+
+Here's example code showing Morph playing with TSV (tab-separated values):
+
+    tsv = %Q[name\tparty\nTed Roe\tred\nAli Davidson\tblue\nSue Smith\tgreen]
+
+    people = Morph.from_tsv(tsv, 'person')
+
+    # => [#<Morph::Person @name="Ted Roe", @party="red">,
+       #<Morph::Person @name="Ali Davidson", @party="blue">,
+       #<Morph::Person @name="Sue Smith", @party="green">]
+
+    people.last.party
+
+    # => "green"
+
+## Morph creating classes `from_xml`
+
+Here's example code showing Morph playing with XML:
+
+    xml = %Q[<?xml version="1.0" encoding="UTF-8"?>
+      <councils type="array">
+        <council code='1'>
+          <name>Aberdeen City Council</name>
+        </council>
+        <council code='2'>
+          <name>Allerdale Borough Council</name>
+        </council>
+      </councils>]
+
+    councils = Morph.from_xml(xml)
+
+    # => [#<Morph::Council @code="1", @name="Aberdeen City Council">,
+       #<Morph::Council @code="2", @name="Allerdale Borough Council">]
+
+    councils.first.name
+
+    # => "Aberdeen City Council"
+
+## Registering a listener to new class / methods via `register_listener`
+
+You can use `register_listener` to get callbacks when new methods on a class are
+created.
+
+For example given Morph used as a mixin:
+
+    class Project; include Morph; end
+    project = Project.new
+
+Register listener:
+
+    listener = -> (klass, method) do
+      puts "class: #{klass.to_s} --- method: #{method}"
+    end
+    Morph.register_listener listener
+
+Callback prints string as new methods are created via assignment calls:
+
+    project.deadline = "11 11 2075"
+    # class: Project --- method: deadline
+
+    project.completed = true
+    # class: Project --- method: completed
+
+To unregister a listener use `unregister_listener`:
+
+    Morph.unregister_listener listener
+
+For an example of Morph's `register_listener` being used to
+[create a Github API](https://github.com/robmckinnon/hubbit/blob/master/lib/hubbit.rb)
+see the [Hubbit module](https://github.com/robmckinnon/hubbit/blob/master/lib/hubbit.rb).
+
+## Morph making sample Active Record line via `script_generate`
+
+Time to generate an Active Record model? Get a sample script line like this:
+
+    Morph.script_generate(Project)
+    #=> "rails destroy model Project;
+    #    rails generate model Project completed:string deadline:string
+
+or specify the generator:
+
+    Morph.script_generate(Hubbit, :generator => 'rspec_model')
+    #=> "rails destroy rspec_model Project;
+    #    rails generate rspec_model Project completed:string deadline:string
+
+You'll have to edit this as it currently sets all data types to be string, and
+doesn't understand associations.
+
+
+## Morph setting hash of attributes via `morph`
+
+    class Order; include Morph; end
+    order = Order.new
+
+How about adding a hash of attribute values?
+
+    order.morph :drink => 'tea', :spoons_of_sugar => 2, :milk => 'prefer soya thanks'
+
+Looks like we got 'em:
+
+    order.drink  # => "tea"
+    order.spoons_of_sugar  # => 2
+    order.milk  # => "prefer soya thanks"
+
+
+## Morph obtaining hash of attributes via `morph_attributes`
+
+Create an item:
+
+    class Item; include Morph; end
+    item = Item.new
+    item.morph :name => 'spinach', :cost => 0.50
+
+Now an order:
+
+    class Order; include Morph; end
+    order = Order.new
+    order.no = 123
+    order.items = [item]
+
+Want to retrieve all that as a nested hash of values? No problem:
+
+    order.morph_attributes
+
+    # => {:items=>[{:name=>"spinach", :cost=>0.5}], :no=>123}
+
+
+## Last bits
+
+See LICENSE for the terms of this software.
+
+    .                                                     ,
+    .                                                 ?7+~::+II~
+    .                                                ?7:     ,:+7
+    .                             777IIII777?        7:         :?7
+    .                          =I=           I:      7?          ,+7
+    .                         I?         ,,   77      7:           :I
+    .                        =  ?7777   77  7   7      7+,          :7
+    .                       7   777777 ~77+=77  I+      I?          ,7
+    .                      :7  77  ~77  I   I7   7       ?:          ?
+    .                      I   77   7,  7    7   :I       I          ?
+    .                      7   ?77=7~    77777    7      ~+          ,+
+    .                      7~                     7  :I7?~            7
+    .                      =?                     7 ?I    ~I77=       I=
+    .                       7    ?          :,   7  I7777,     7       7
+    .                        ?    777?~~7777+    7              7~      7
+    .                        ?7    ,777777=,   ,7                7      ,7
+    .                          7=      ,      =7                 7:      7
+    .                            +7         :7                    7      ,I
+    .                             :7        ?~                   7?       7
+    .                              7         7              ~II7~,        7
+    .                              7         7  ,  =7777777?+,,,         I=
+    .                            :7,          ~==,                       7
+    .                       II~,,                                     77~
+    .                    ,I?                                      +777
+    .                   7+,                                 ~7777:
+    .                 ==                               :77
+    .               :7:                              ,7I
+    .             7I                                 7
+    .            I          ,7,                      7
+    .          =7          77=7                      7
+    .        ,7          7I   7                      7
+    .        I,        I7     7                      7
+    .       ?,       ,7       7,                     7
+    .       7       7~        7,                     7
+    .       7      ,7I        7                      7
+    .       =+       =7       7                      ~=
+    .        =7        7,     7                       7
+    .         ,7,       ~7IIII7+,                     7
+    .           +:              II                    I
+    .            ?7              I?                   +~
+    .              II,           +I                    7
+    .                ~7          ,I                    7
+    .                  7=        ~7                    7
+    .                   ?7,     ~7+                    ?~
+    .                     ~7777I=                      ,7
+    .                         7:                        7
+    .                         I                         7
+    .                         I          ,:77I          7
+    .                         I          :7             I
+    .                         I                         =~
+    .                         7               ,         ,7
+    .                         +,         7    :         ,7
+    .                          +         7    +          7
+    .                          +         7    +         ,7
+    .                          7         I    ?         ,7
+    .                          7         +:   7         ,7
+    .                          7         =+   7         ,7
+    .                          7         :I   I         ,7
+    .                          7         :I   7          7
+    .                          7         :I   I          7
+    .                          I,        ,7   I:         7
+    .                          =+        ,7    ?         7
+    .                          :?,       ,7    7,        7
+    .                          I:        ,7    7,        ?
+    .                         :7         ,7    7,        ,
+    .                        +I,         :     ?         ,=
+    .                       +=           ~     =~         7
+    .                    :II,,           =      I         ?
+    .                =I=                 ?      7,        :7
+    .              II~                   I      7,         ,II
+    .            7~                      ~7     7            ,=7
+    .            =                       =7     I,             ::
+    .            77II?==?II777777777777777      7~              7
+    .                                            77+,,          7:
+    .                                               777777+:,~777
+    .

data/lib/morph.rb

@@ -17,10 +17,136 @@ rescue Exception => e
   end
 end
 
+module Chas
+  @adding_morph_method = Hash.new {|hash,klass| hash[klass] = false } unless defined?(@adding_morph_method)
+  @morph_methods = Hash.new {|hash,klass| hash[klass] = {} } unless defined?(@morph_methods)
+  @morph_attributes = Hash.new {|hash,klass| hash[klass] = [] } unless defined?(@morph_attributes)
+  @listeners = {}
+
+  def self.register_listener listener
+    @listeners[listener.object_id] = listener
+  end
+
+  def self.unregister_listener listener
+    @listeners.delete(listener.object_id) if @listeners.has_key?(listener.object_id)
+  end
+
+  def self.morph_classes
+    @morph_attributes.keys
+  end
+
+  def self.add_method klass, symbol
+    if adding_morph_method?(klass)
+      @morph_methods[klass][symbol] = true
+      is_writer = symbol.to_s =~ /=$/
+      unless is_writer
+        @morph_attributes[klass] << symbol
+        @listeners.values.each { |l| l.call klass, symbol }
+      end
+    end
+  end
+
+  def self.remove_method klass, symbol
+    if @morph_methods[klass].has_key? symbol
+      @morph_methods[klass].delete symbol
+      is_writer = symbol.to_s =~ /=$/
+      @morph_attributes[klass].delete(symbol) unless is_writer
+    end
+  end
+
+  def self.morph_attributes klass
+    if klass.superclass.respond_to?(:morph_attributes)
+      @morph_attributes[klass] + klass.superclass.morph_attributes
+    else
+      @morph_attributes[klass] + []
+    end
+  end
+
+  def self.morph_methods klass
+    methods = if RUBY_VERSION >= "1.9"
+      @morph_methods[klass].keys.sort
+    else
+      @morph_methods[klass].keys.map(&:to_s).sort
+    end
+
+    if klass.superclass.respond_to?(:morph_attributes)
+      methods += klass.superclass.morph_methods
+    end
+    methods
+  end
+
+  private
+  def self.adding_morph_method? klass
+    @adding_morph_method[klass]
+  end
+
+  public
+  def self.start_adding_morph_method klass
+    @adding_morph_method[klass] = true
+  end
+
+  def self.finish_adding_morph_method klass
+    @adding_morph_method[klass] = false
+  end
+
+  def self.add_morph_attribute klass, attribute
+    start_adding_morph_method(klass)
+    klass.send(:attr_accessor, attribute)
+    finish_adding_morph_method(klass)
+  end
+
+  def self.morph_method_missing object, symbol, *args
+    attribute = symbol.to_s.chomp '='
+    if RUBY_VERSION >= "1.9"
+      attribute = attribute.to_sym
+    end
+
+    if Object.instance_methods.include?(attribute)
+      raise "'#{attribute}' is an instance_method on Object, cannot create accessor methods for '#{attribute}'"
+    elsif argument_provided? args
+      base = object.class
+      add_morph_attribute base, attribute
+      object.send(symbol, *args)
+    end
+  end
+
+  def self.argument_provided? args
+    args.size > 0 && !args[0].nil? && !(args[0].is_a?(String) && args[0].strip.size == 0)
+  end
+
+  def self.convert_to_morph_class_name label
+    name = label.to_s + ''
+    name.tr!(',.:"\'/()\-*\\',' ')
+    name.gsub!('%','percentage')
+    name.strip!
+    name.gsub!(/^(\d)/, '_\1')
+    name.gsub!(/\s/,'_')
+    name.squeeze!('_')
+    name
+  end
+
+  def self.convert_to_morph_method_name label
+    convert_to_morph_class_name label.to_s.downcase
+  end
+
+end
+
 module Morph
-  VERSION = "0.3.7" unless defined? Morph::VERSION
+  VERSION = '0.4.0' unless defined? Morph::VERSION
 
   class << self
+    def classes
+      Chas.morph_classes
+    end
+
+    def register_listener listener
+      Chas.register_listener listener
+    end
+
+    def unregister_listener listener
+      Chas.unregister_listener listener
+    end
+
     def generate_migrations object, options={}
       options[:ignore] ||= []
       options[:belongs_to_id] ||= ''
@@ -72,19 +198,22 @@ module Morph
       from_hash hash, namespace
     end
 
+    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
+
     def from_hash hash, namespace=Morph
       if hash.keys.size == 1
-        key = hash.keys.first
-
-        if hash[key].is_a? Hash
-          attributes = hash[key]
-          object = object_from_name(key, namespace)
-          add_to_object object, attributes, namespace
-          object
-        elsif hash[key].is_a? Array
-          array = hash[key]
-          name = key.to_s.singularize
-          objects_from_array(array, name, namespace)
+        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
@@ -104,7 +233,6 @@ module Morph
 
     def included(base)
       base.extend ClassMethods
-      base.send(:include, InstanceMethods)
       base.send(:include, MethodMissing)
     end
 
@@ -142,7 +270,7 @@ module Morph
       end
 
       def object_from_name name, namespace
-        name = name.to_s.camelize
+        name = Chas.convert_to_morph_class_name(name).camelize
         begin
           type = class_constant namespace, name
         rescue NameError => e
@@ -160,7 +288,8 @@ module Morph
 
       def objects_from_array array, name, namespace
         if array.size > 0 && array.collect(&:class).uniq == [Hash]
-          array.map! { |hash| object_from_hash(hash, name.singularize, namespace) }
+          name = name.to_s.singularize
+          array.map! { |hash| object_from_hash(hash, name, namespace) }
         else
           array
         end
@@ -195,144 +324,81 @@ module Morph
 
   module ClassMethods
 
-    @@adding_morph_method = Hash.new {|hash,klass| hash[klass] = false } unless defined?(@@adding_morph_method)
-    @@morph_methods = Hash.new {|hash,klass| hash[klass] = {} } unless defined?(@@morph_methods)
-    @@morph_attributes = Hash.new {|hash,klass| hash[klass] = [] } unless defined?(@@morph_attributes)
-
     def morph_attributes
-      if superclass.respond_to?(:morph_attributes)
-        @@morph_attributes[self] + superclass.morph_attributes
-      else
-        @@morph_attributes[self] + []
-      end
+      Chas.morph_attributes(self)
     end
 
     def morph_methods
-      methods = if RUBY_VERSION >= "1.9"
-        @@morph_methods[self].keys.sort.map(&:to_sym)
-      else
-        @@morph_methods[self].keys.sort
-      end
-
-      if superclass.respond_to?(:morph_attributes)
-        methods += superclass.morph_methods
-      end
-      methods
-    end
-
-    def add_morph_attribute attribute, *args
-      @@adding_morph_method[self] = true
-      class_eval "attr_accessor :#{attribute}"
-      @@adding_morph_method[self] = false
+      Chas.morph_methods(self)
     end
 
     protected
 
-      def method_added symbol
-        if @@adding_morph_method[self]
-          @@morph_methods[self][symbol.to_s] = true
-          is_writer = symbol.to_s =~ /=$/
-          @@morph_attributes[self] << symbol unless is_writer
-        end
-      end
-
-      def method_removed symbol
-        if @@morph_methods[self].has_key? symbol.to_s
-          @@morph_methods[self].delete symbol.to_s
-          is_writer = symbol.to_s =~ /=$/
-          @@morph_attributes[self].delete(symbol) unless is_writer
-        end
-      end
+    def method_added symbol
+      Chas.add_method self, symbol
+    end
 
+    def method_removed symbol
+      Chas.remove_method self, symbol
+    end
   end
 
   module MethodMissing
     def method_missing symbol, *args
       is_writer = symbol.to_s =~ /=$/
       if is_writer
-        Morph::InstanceMethods::Helper.morph_method_missing(self, symbol, *args)
+        Chas.morph_method_missing(self, symbol, *args)
       else
         super
       end
     end
   end
 
-  module InstanceMethods
-
-    #
-    # 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">
-    #
-    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 = Helper.convert_to_morph_method_name(attributes_or_label)
-        send("#{attribute}=".to_sym, value)
-      end
-    end
-
-    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
+  #
+  # 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">
+  #
+  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
 
-    module Helper
+  def morph_attributes
+    attributes = self.class.morph_attributes.inject({}) do |hash, attribute|
+      unless attribute =~ /=\Z/
+        symbol = attribute.to_sym
+        value = send(symbol)
 
-      def self.morph_method_missing object, symbol, *args
-        attribute = symbol.to_s.chomp '='
-        if RUBY_VERSION >= "1.9"
-          attribute = attribute.to_sym
-        end
+        value.each do |key, v|
+          value[key] = v.morph_attributes if v.respond_to?(:morph_attributes)
+        end if value.is_a? Hash
 
-        if Object.instance_methods.include?(attribute)
-          raise "'#{attribute}' is an instance_method on Object, cannot create accessor methods for '#{attribute}'"
-        elsif Helper.argument_provided? args
-          base = object.class
-          base.add_morph_attribute attribute
-          object.send(symbol, *args)
-        end
-      end
+        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
 
-      def self.argument_provided? args
-        args.size > 0 && !args[0].nil? && !(args[0].is_a?(String) && args[0].strip.size == 0)
-      end
-
-      def self.convert_to_morph_method_name label
-        name = label.to_s.downcase.tr('()\-*',' ').gsub("'",' ').gsub('/',' ').gsub('%','percentage').strip.chomp(':').strip.gsub(/\s/,'_').squeeze('_')
-        name = '_'+name if name =~ /^\d/
-        name
+        hash[symbol] = value
       end
+      hash
     end
   end
+
 end

metadata

@@ -1,104 +1,79 @@
 --- !ruby/object:Gem::Specification
 name: morph
 version: !ruby/object:Gem::Version
-  version: 0.3.7
+  version: 0.4.0
 platform: ruby
 authors:
 - Rob McKinnon
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-02-24 00:00:00.000000000 Z
+date: 2016-02-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 2.0.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 2.0.2
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: echoe
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-description: |
-  Morph mixin allows you to emerge Ruby class definitions from data via calling assignment methods.
-email:
-- rob ~@nospam@~ rubyforge.org
+description: 
+email: rob ~@nospam@~ rubyforge.org
 executables: []
 extensions: []
 extra_rdoc_files:
-- CHANGELOG
-- LICENSE
-- README
+- README.md
 files:
 - CHANGELOG
-- lib/morph.rb
 - LICENSE
-- README
-- Manifest
-- morph.gemspec
-- Rakefile
+- README.md
+- lib/morph.rb
 homepage: https://github.com/robmckinnon/morph
-licenses: []
+licenses:
+- MIT
 metadata: {}
-post_install_message: 'Read usage examples at: https://github.com/robmckinnon/morph#readme'
+post_install_message: 
 rdoc_options:
-- --line-numbers
-- --inline-source
-- --title
-- Morph
-- --main
-- README
-- --inline-source
+- "--main"
+- README.md
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '1.2'
+      version: '0'
 requirements: []
-rubyforge_project: morph
-rubygems_version: 2.0.3
+rubyforge_project: 
+rubygems_version: 2.5.2
 signing_key: 
 specification_version: 4
-summary: Morph mixin allows you to emerge class definitions via calling assignment
-  methods.
+summary: Morph mixin allows you to emerge class definitions via assignment method
+  calls.
 test_files: []

data/Manifest

@@ -1,5 +0,0 @@
-CHANGELOG
-lib/morph.rb
-LICENSE
-README
-Manifest

data/README

@@ -1,287 +0,0 @@
-Morph mixin allows you to emerge Ruby class definitions from data via calling assignment methods.
-
-
-== Installing Morph
-
- gem install morph
-
-To use Morph:
-
- require 'morph'
-
-== Morph creating classes +from_csv+
-
-Here's example code showing Morph playing with CSV (comma-separated values):
-
- csv = %Q[name,party\nTed Roe,red\nAli Davidson,blue\nSue Smith,green]
-
- people = Morph.from_csv(csv, 'person')
-
- # => [#<Morph::Person @name="Ted Roe", @party="red">,
-       #<Morph::Person @name="Ali Davidson", @party="blue">,
-       #<Morph::Person @name="Sue Smith", @party="green">]
-
- people.last.party
-
- # => "green"
-
-== Morph creating classes +from_tsv+
-
-Here's example code showing Morph playing with TSV (tab-separated values):
-
- tsv = %Q[name\tparty\nTed Roe\tred\nAli Davidson\tblue\nSue Smith\tgreen]
-
- people = Morph.from_tsv(tsv, 'person')
-
- # => [#<Morph::Person @name="Ted Roe", @party="red">,
-       #<Morph::Person @name="Ali Davidson", @party="blue">,
-       #<Morph::Person @name="Sue Smith", @party="green">]
-
- people.last.party
-
- # => "green"
-
-== Morph creating classes +from_xml+
-
-Here's example code showing Morph playing with XML:
-
- xml = %Q[<?xml version="1.0" encoding="UTF-8"?>
- <councils type="array">
-   <council code='1'>
-     <name>Aberdeen City Council</name>
-   </council>
-   <council code='2'>
-     <name>Allerdale Borough Council</name>
-   </council>
- </councils>]
-
- councils = Morph.from_xml(xml)
-
- # => [#<Morph::Council @code="1", @name="Aberdeen City Council">,
-       #<Morph::Council @code="2", @name="Allerdale Borough Council">]
-
- councils.first.name
-
- # => "Aberdeen City Council"
-
-== Morph playing with +Nokogiri+
-
-Here's example code showing Morph playing with Nokogiri in Ruby 1.9.2:
-
- require 'morph'; require 'nokogiri'; require 'open-uri'
-
-
- class Hubbit
-   include Morph  # allows class to morph
-
-   def initialize name
-     doc = Nokogiri::HTML open("https://github.com/#{name}")
-
-     profile_fields = doc.search('.vcard dt')
-
-     profile_fields.each do |node|
-       label = node.inner_text
-       value = node.next_element.inner_text.strip
-
-       morph(label, value)  # morph magic adds accessor methods!
-     end
-   end
-
-   def member_since_date
-     Date.parse member_since
-   end
- end
-
- def Hubbit name; Hubbit.new name; end
-
-The model emerges from the data. Let's start by looking up 'why':
-
- why = Hubbit 'why'
-
-What new methods do we have?
-
- Hubbit.morph_methods.map {|m| m.to_s}
-
- #=> ["location", "location=", "member_since", "member_since=", "name", "name="]
-
-Ah-ha, so we have a name attribute now:
-
- why.name # => "Squatting until _why gets home."
-
-We wrote a +member_since_date+ method in our class, let's call that now:
-
- why.member_since_date # => Wed, 19 Aug 2009
-
-
-Let's add some of why's projects:
-
- why.projects = %w[shoes hacketyhack camping hoodwinkd hpricot
-                  markaby mousehole parkplace poignant sandbox]
-
-That why's a productive fellow! Note new accessor methods have been added:
-
- Hubbit.morph_methods.map {|m| m.to_s}
-
- #=> ["location", "location=", "member_since", "member_since=", "name", "name=",
- #    "projects", "projects="]
-
-
-Let's do some more morphing:
-
- dhh = Hubbit 'dhh'
-
-Do we have more methods now?
-
- Hubbit.morph_methods.map {|m| m.to_s}
-
- #=> ["company", "company=", "email", "email=", "location", "location=",
- #    "member_since", "member_since=", "name", "name=", "projects", "projects=",
- #    "website_blog", "website_blog="]
-
-So, a new company method has appeared:
-
- dhh.company #=> "37signals"
-
-
-== Morph making sample Active Record line via +script_generate+
-
-Time to generate an Active Record model? Get a sample script line like this:
-
- Morph.script_generate(Hubbit)
-
- #=> "rails destroy model Hubbit;
- #    rails generate model Hubbit company:string email:string location:string
- #          member_since:string name:string projects:string website_blog:string"
-
-or specify the generator:
-
- Morph.script_generate(Hubbit, :generator => 'rspec_model')
-
- #=> "rails destroy rspec_model Hubbit;
- #    rails generate rspec_model Hubbit company:string email:string
- #          location:string member_since:string name:string projects:string
- #          website_blog:string"
-
-You'll have to edit this as it currently sets all data types to be string, and
-doesn't understand associations.
-
-
-== Morph setting hash of attributes via +morph+
-
- class Order; include Morph; end
- order = Order.new
-
-How about adding a hash of attribute values?
-
- order.morph :drink => 'tea', :spoons_of_sugar => 2, :milk => 'prefer soya thanks'
-
-Looks like we got 'em:
-
- order.drink  # => "tea"
- order.spoons_of_sugar  # => 2
- order.milk  # => "prefer soya thanks"
-
-
-== Morph obtaining hash of attributes via +morph_attributes+
-
-Create an item:
-
- class Item; include Morph; end
- item = Item.new
- item.morph :name => 'spinach', :cost => 0.50
-
-Now an order:
-
- class Order; include Morph; end
- order = Order.new
- order.no = 123
- order.items = [item]
-
-Want to retrieve all that as a nested hash of values? No problem:
-
- order.morph_attributes
-
- # => {:items=>[{:name=>"spinach", :cost=>0.5}], :no=>123}
-
-
-== Last bits
-
-See examples/ directory for some example code.
-See LICENSE for the terms of this software.
-
- .                                                     ,
- .                                                 ?7+~::+II~
- .                                                ?7:     ,:+7
- .                             777IIII777?        7:         :?7
- .                          =I=           I:      7?          ,+7
- .                         I?         ,,   77      7:           :I
- .                        =  ?7777   77  7   7      7+,          :7
- .                       7   777777 ~77+=77  I+      I?          ,7
- .                      :7  77  ~77  I   I7   7       ?:          ?
- .                      I   77   7,  7    7   :I       I          ?
- .                      7   ?77=7~    77777    7      ~+          ,+
- .                      7~                     7  :I7?~            7
- .                      =?                     7 ?I    ~I77=       I=
- .                       7    ?          :,   7  I7777,     7       7
- .                        ?    777?~~7777+    7              7~      7
- .                        ?7    ,777777=,   ,7                7      ,7
- .                          7=      ,      =7                 7:      7
- .                            +7         :7                    7      ,I
- .                             :7        ?~                   7?       7
- .                              7         7              ~II7~,        7
- .                              7         7  ,  =7777777?+,,,         I=
- .                            :7,          ~==,                       7
- .                       II~,,                                     77~
- .                    ,I?                                      +777
- .                   7+,                                 ~7777:
- .                 ==                               :77
- .               :7:                              ,7I
- .             7I                                 7
- .            I          ,7,                      7
- .          =7          77=7                      7
- .        ,7          7I   7                      7
- .        I,        I7     7                      7
- .       ?,       ,7       7,                     7
- .       7       7~        7,                     7
- .       7      ,7I        7                      7
- .       =+       =7       7                      ~=
- .        =7        7,     7                       7
- .         ,7,       ~7IIII7+,                     7
- .           +:              II                    I
- .            ?7              I?                   +~
- .              II,           +I                    7
- .                ~7          ,I                    7
- .                  7=        ~7                    7
- .                   ?7,     ~7+                    ?~
- .                     ~7777I=                      ,7
- .                         7:                        7
- .                         I                         7
- .                         I          ,:77I          7
- .                         I          :7             I
- .                         I                         =~
- .                         7               ,         ,7
- .                         +,         7    :         ,7
- .                          +         7    +          7
- .                          +         7    +         ,7
- .                          7         I    ?         ,7
- .                          7         +:   7         ,7
- .                          7         =+   7         ,7
- .                          7         :I   I         ,7
- .                          7         :I   7          7
- .                          7         :I   I          7
- .                          I,        ,7   I:         7
- .                          =+        ,7    ?         7
- .                          :?,       ,7    7,        7
- .                          I:        ,7    7,        ?
- .                         :7         ,7    7,        ,
- .                        +I,         :     ?         ,=
- .                       +=           ~     =~         7
- .                    :II,,           =      I         ?
- .                =I=                 ?      7,        :7
- .              II~                   I      7,         ,II
- .            7~                      ~7     7            ,=7
- .            =                       =7     I,             ::
- .            77II?==?II777777777777777      7~              7
- .                                            77+,,          7:
- .                                               777777+:,~777
- .

data/Rakefile

@@ -1,37 +0,0 @@
-require 'rubygems'
-require './lib/morph'
-
-begin
-  require 'rspec'
-rescue LoadError
-  puts "\nYou need to install the rspec gem to perform meta operations on this gem"
-  puts "  gem install rspec\n"
-end
-
-begin
-  require 'echoe'
-
-  Echoe.new("morph") do |m|
-    m.author = ["Rob McKinnon"]
-    m.email = ["rob ~@nospam@~ rubyforge.org"]
-    m.summary = 'Morph mixin allows you to emerge class definitions via calling assignment methods.'
-    m.description = File.readlines("README").first
-    m.url = 'https://github.com/robmckinnon/morph'
-    m.install_message = 'Read usage examples at: https://github.com/robmckinnon/morph#readme'
-    m.version = Morph::VERSION
-    m.project = "morph"
-    m.rdoc_options << '--inline-source'
-    m.rdoc_pattern = ["README", "CHANGELOG", "LICENSE"]
-    m.runtime_dependencies = ["activesupport >=2.0.2"]
-    m.development_dependencies = ['rspec','echoe']
-  end
-
-rescue LoadError
-  puts "\nYou need to install the echoe gem to perform meta operations on this gem"
-  puts "  gem install echoe\n\n"
-end
-
-desc "Open an irb session preloaded with this library"
-task :console do
-  sh "irb -rubygems -r ./lib/morph.rb"
-end

data/morph.gemspec

@@ -1,39 +0,0 @@
-# -*- encoding: utf-8 -*-
-
-Gem::Specification.new do |s|
-  s.name = "morph"
-  s.version = "0.3.7"
-
-  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Rob McKinnon"]
-  s.date = "2014-02-24"
-  s.description = "Morph mixin allows you to emerge Ruby class definitions from data via calling assignment methods.\n"
-  s.email = ["rob ~@nospam@~ rubyforge.org"]
-  s.extra_rdoc_files = ["CHANGELOG", "LICENSE", "README"]
-  s.files = ["CHANGELOG", "lib/morph.rb", "LICENSE", "README", "Manifest", "morph.gemspec", "Rakefile"]
-  s.homepage = "https://github.com/robmckinnon/morph"
-  s.post_install_message = "Read usage examples at: https://github.com/robmckinnon/morph#readme"
-  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Morph", "--main", "README", "--inline-source"]
-  s.require_paths = ["lib"]
-  s.rubyforge_project = "morph"
-  s.rubygems_version = "2.0.3"
-  s.summary = "Morph mixin allows you to emerge class definitions via calling assignment methods."
-
-  if s.respond_to? :specification_version then
-    s.specification_version = 4
-
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<activesupport>, [">= 2.0.2"])
-      s.add_development_dependency(%q<rspec>, [">= 0"])
-      s.add_development_dependency(%q<echoe>, [">= 0"])
-    else
-      s.add_dependency(%q<activesupport>, [">= 2.0.2"])
-      s.add_dependency(%q<rspec>, [">= 0"])
-      s.add_dependency(%q<echoe>, [">= 0"])
-    end
-  else
-    s.add_dependency(%q<activesupport>, [">= 2.0.2"])
-    s.add_dependency(%q<rspec>, [">= 0"])
-    s.add_dependency(%q<echoe>, [">= 0"])
-  end
-end