representable 2.1.5 → 2.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 351c7071b33faa1215070024868b2614288915f4
-  data.tar.gz: 9960a2f4c850764bc48ad3db09c84581fb53049a
+  metadata.gz: 8c49b50c08553f95fcf4125c6fecd1a951f9303f
+  data.tar.gz: 1f1236f5bc0b0736f4a042b8cd85b928ab8cec04
 SHA512:
-  metadata.gz: ae7afd058a763a369761633d3375d865d583e7761988665580c6765980b254dc0443cdc3c3b641a5de3f94476f2cecaa23550dc3bc72c0f10e9b2d215fb6c269
-  data.tar.gz: f44ba7ec3298e2d264be42f491561a00dbb1375a3ff347848abdb4ab5a87d603ad86a1f513721752b48864204be89e2fd5ce512b068d5fc0c183c7c1b0aef106
+  metadata.gz: 04b4160bcc81156d193f141167c3f954f30429fd96afdfab08502db8537806937329370794f7067aa207297a85ad70b7fe3e6139f312c76f60b24c515e6b7a5e
+  data.tar.gz: 96ff73a1056aacdffb00a0742dc218c525ab596325042142878a0de6894c5ce459a4e2a5012270eca554f9dae9265b3aa3e6f97c1784f4cc6390465a23cf2fe0

data/CHANGES.md

@@ -1,3 +1,8 @@
+# 2.1.6
+
+* Introducing `Representable::Object` that allows mapping objects to objects. This is way faster than rendering a hash from the source and then writing the hash to the target object.
+* Fixed loading issues when requiring `representable/decorator`, only.
+
 # 2.1.5
 
 * Using `inherit: true` now works even if the parent property hasn't been defined before. It will simply create a new property. This used to crash with `undefined method `merge!' for nil:NilClass`.

data/README.md

@@ -9,7 +9,7 @@ Representable is helpful for all kind of mappings, rendering and parsing workflo
 
 ## Installation
 
-The representable gem runs with all Ruby versions >= 1.8.7.
+The representable gem runs with all Ruby versions >= 1.9.3.
 
 ```ruby
 gem 'representable'
@@ -950,7 +950,7 @@ end
 The `#items` method lets you configure the contained entity representing here.
 
 ```ruby
-[Song.new(title: "Hyper Music"), Song.new(title: "Screenager")].extend(SongsRepresenter).to_json
+[Song.new(title: "Hyper Music"), Song.new(title: "Screenager")].extend(SongsRepresenter.for_collection).to_json
 #=> [{"title":"Hyper Music"},{"title":"Screenager"}]
 ```
 
@@ -1202,7 +1202,7 @@ end
 In a decorator it works alike.
 
 ```ruby
-module SongRepresenter < Representable::Decorator
+class SongRepresenter < Representable::Decorator
   include Representable::JSON
   include Representable::Coercion
 
@@ -1334,6 +1334,28 @@ end
 
 This will give you a behavior close to Rails' `HashWithIndifferentAccess` by stringifying the incoming hash internally.
 
+## Object to Object Mapping
+
+Since Representable 2.1.6 we also allow mapping objects to objects directly. This is extremely fast as the source object is queried for its properties and then values are directly written to the target object.
+
+`````ruby
+require "representable/object"
+
+module SongRepresenter
+  include Representable::Object
+
+  property :title
+end
+```
+
+As always, the source object needs to have readers for all properties and the target writers.
+
+```ruby
+song_copy = OpenStruct.new.extend(SongRepresenter).from_object(song)
+song_copy.title = "Roxanne"
+```
+
+All kind of transformation options can be used as well as nesting.
 
 ## Debugging
 

data/lib/representable/decorator.rb

@@ -1,3 +1,5 @@
+require "representable"
+
 module Representable
   class Decorator
     attr_reader :represented

data/lib/representable/object/binding.rb

@@ -7,7 +7,10 @@ module Representable
       end
 
       def read(hash)
-        hash.send(as) # :getter? no, that's for parsing!
+        fragment = hash.send(as) # :getter? no, that's for parsing!
+
+        return FragmentNotFound if fragment.nil? and typed?
+        fragment
       end
 
       def deserialize_method

data/lib/representable/version.rb

@@ -1,3 +1,3 @@
 module Representable
-  VERSION = "2.1.5"
+  VERSION = "2.1.6"
 end

data/representable.gemspec

@@ -18,6 +18,7 @@ Gem::Specification.new do |s|
   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.require_paths = ["lib"]
+  s.license       = "MIT"
 
   s.add_dependency "nokogiri"
   s.add_dependency "multi_json"

data/test/decorator_test.rb

@@ -15,7 +15,6 @@ class DecoratorTest < MiniTest::Spec
 
   let (:song) { Song.new("Mama, I'm Coming Home") }
   let (:album) { Album.new([song]) }
-  let (:decorator) { AlbumRepresentation.new(album) }
 
   describe "inheritance" do
     let (:inherited_decorator) do
@@ -27,10 +26,14 @@ class DecoratorTest < MiniTest::Spec
     it { inherited_decorator.to_hash.must_equal({"songs"=>[{"name"=>"Mama, I'm Coming Home"}], "best_song"=>"Stand Up"}) }
   end
 
+  let (:decorator) { AlbumRepresentation.new(album) }
+
   it "renders" do
     decorator.to_hash.must_equal({"songs"=>[{"name"=>"Mama, I'm Coming Home"}]})
     album.wont_respond_to :to_hash
     song.wont_respond_to :to_hash # DISCUSS: weak test, how to assert blank slate?
+    # no @representable_attrs in decorated objects
+    song.instance_variable_get(:@representable_attrs).must_equal nil
   end
 
   describe "#from_hash" do
@@ -52,4 +55,21 @@ class DecoratorTest < MiniTest::Spec
       AlbumRepresentation.prepare(album).decorated.must_equal album
     end
   end
+
+
+  describe "inline decorators" do
+    representer!(decorator: true) do
+      collection :songs, :class => Song do
+        property :name
+      end
+    end
+
+    it "does not pollute represented" do
+      representer.new(album).from_hash({"songs"=>[{"name"=>"Atomic Garden"}]})
+
+      # no @representable_attrs in decorated objects
+      song.instance_variable_get(:@representable_attrs).must_equal nil
+      album.instance_variable_get(:@representable_attrs).must_equal nil
+    end
+  end
 end

data/test/object_test.rb

@@ -28,4 +28,12 @@ class ObjectTest < MiniTest::Spec
     target.album.name.must_equal "Ruiner"
     target.album.songs[0].title.must_equal "In Vino Veritas II"
   end
+
+  # ignore nested object when nil
+  it do
+    representer.prepare(Song.new("The King Is Dead")).from_object(Song.new)
+
+    target.title.must_equal nil # scalar property gets overridden when nil.
+    target.album.must_equal nil # nested property stays nil.
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: representable
 version: !ruby/object:Gem::Version
-  version: 2.1.5
+  version: 2.1.6
 platform: ruby
 authors:
 - Nick Sutterer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-02-04 00:00:00.000000000 Z
+date: 2015-05-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -252,7 +252,8 @@ files:
 - test/xml_test.rb
 - test/yaml_test.rb
 homepage: https://github.com/apotonick/representable/
-licenses: []
+licenses:
+- MIT
 metadata: {}
 post_install_message: 
 rdoc_options: []