representable 1.7.5 → 1.7.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 44bab0e189f2c4890389b5e7fbfdea850a4f3279
-  data.tar.gz: 073892bb5e3a2da25b63f467f288e540e268e572
+  metadata.gz: 26bff301d2f96c009077a3675aabf598c4754a49
+  data.tar.gz: 6b21930dea9bf7bd327e536d78d2d4b71cb46110
 SHA512:
-  metadata.gz: 2448f7cda7ea75e85a800fdfe99ffbfa394dc0ff69cdcdab36d02446987ef47c9e627f0477c27e9467558a08fa5d8d31c28bb42c31c1854c4c5d21b0fe33ce72
-  data.tar.gz: 14f0bdb50cd844606957ea6e8ad3555e98f7bb5b2350aa6b3e1767f005ab3f44303d3d54ba6ca9344e20ba2bbeda1fe977771ca3f6da3bda13ac87c8efe510a6
+  metadata.gz: f28a2101a9eeac36b6c93edc4ceae8716b2f95918ed78ee5a9179727883ff42208b0041110f1bafbc3ba5b099e3ff46f547538a0f93e07156283254f7838147a
+  data.tar.gz: d2e5365454d29a47ee40829fbd3fe47bdbe0cccd4067493c26a4b700c50466ddb3ddece6f5e23fbb40d2d7437f928a3c051aab4256a666b1799e42ac2a2f15a8

data/.travis.yml

@@ -3,4 +3,6 @@ notifications:
 matrix:
   include:
     - rvm: 1.9.3
+    - rvm: 2.0.0
+    - rvm: 2.1.0
 

data/CHANGES.md

@@ -7,6 +7,11 @@ h2. 1.8.0
 -> make major steps lambda-able
 -> strategies for deserialization (lambda-able!)
 
+h2. 1.7.6
+
+* Add `::nested` to nest blocks in the document whilst still using the same represented object. Use with `Decorator` only.
+* Fixing a bug (thanks @rsutphin) where inline decorators would inherit the properties from the outer decorator.
+
 h2. 1.7.5
 
 * propagate all options for ::property to ::inline_representer.

data/Gemfile

@@ -3,5 +3,3 @@ source 'https://rubygems.org'
 gemspec
 
 #gem "virtus", :path => "../virtus"
-gem 'rake', "10.1.0"
-#gem 'debugger'

data/README.md

@@ -9,7 +9,7 @@ Representable is helpful for all kind of rendering and parsing workflows. Howeve
 
 ## Installation
 
-The representable gem is almost dependency-free. Almost.
+The representable gem runs with all Ruby versions >= 1.8.7.
 
 ```ruby
 gem 'representable'
@@ -233,6 +233,40 @@ module AlbumRepresenter
   end
 ```
 
+## Document Nesting
+
+Not always does the structure of the desired document map to your objects. The `::nested` method allows you to structure properties in a separate section while still mapping the properties to the outer object.
+
+Imagine the following document.
+
+```json
+{"title": "Roxanne",
+ "details":
+   {"track": 3,
+    "length": "4:10"}
+}
+```
+
+However, both `track` and `length` are properties of the song object `<Song#0x999 title: "Roxanne", track: 3 ...>`, there is no such concept as `details` in the `Song` class. Representable gives you `::nested` to achieve this.
+
+```ruby
+class SongRepresenter < Representable::Decorator
+  include Representable::JSON
+
+  property :title
+
+  nested :details do
+    property :track
+    property :length
+  end
+end
+```
+
+Just use an inline representer or the `extend:` option to define nested properties. Accessors for nested properties will still be called on the outer object (here, `song`). And as always, this works both ways for rendering and parsing.
+
+Note that `nested` works with decorators, only. We might add it for modules soon.
+
+
 ## Decorator vs. Extend
 
 People who dislike `:extend` go use the `Decorator` strategy!
@@ -796,41 +830,44 @@ Coercing values only happens when rendering or parsing a document. Representable
 
 ## Undocumented Features
 
-(Please don't read this section!)
+*(Please don't read this section!)*
+
+### Custom Binding
 
-* If you need a special binding for a property you're free to create it using the `:binding` option.
+If you need a special binding for a property you're free to create it using the `:binding` option.
 
-<!-- here comes some code -->
 ```ruby
 property :title, :binding => lambda { |*args| JSON::TitleBinding.new(*args) }
 ```
 
-* You can use the parsed document fragment directly as a representable instance by returning `nil` in `:class`.
+### Syncing Parsing
+
+You can use the parsed document fragment directly as a representable instance by returning `nil` in `:class`.
 
-<!-- here comes some code -->
 ```ruby
 property :song, :class => lambda { |*| nil }
 ```
 
 This makes sense when your parsing looks like this.
 
-<!-- here comes some code -->
 ```ruby
 hit.from_hash(song: <#Song ..>)
 ```
 
 Representable will not attempt to create a `Song` instance for you but use the provided from the document.
 
-* The same goes the other way when rendering. Just provide an empty `:instance` block.
+Note that this is now the [official option](#syncing-objects) `:parse_strategy`.
+
+### Rendering Without Extend
+
+The same goes the other way when rendering. Just provide an empty `:instance` block.
 
-<!-- here comes some code -->
 ```ruby
 property :song, :instance => lambda { |*| nil }
 ```
 
 This will treat the `song` property instance as a representable object.
 
-<!-- here comes some code -->
 ```ruby
 hit.to_json # this will call hit.song.to_json
 ```

data/lib/representable.rb

@@ -128,7 +128,7 @@ private
       #   collection :products, :from => :item
       #   collection :products, :class => Product
       def collection(name, options={}, &block)
-        options[:collection] = true
+        options[:collection] = true # FIXME: don't override original.
         property(name, options, &block)
       end
 

data/lib/representable/decorator.rb

@@ -7,17 +7,36 @@ module Representable
       new(represented)
     end
 
-    def self.inline_representer(base_module, name, options, &block) # DISCUSS: separate module?
-      Class.new(self) do
-        include base_module
-        instance_exec &block
+    def self.inline_representer(base_module, name, options, &block)
+      # FIXME: it is wrong to inherit from self here as we just want to "inherit" the included modules but nothing else.
+      Class.new(self).tap do |decorator|
+        decorator.class_eval do # Ruby 1.8.7 wouldn't properly execute the block passed to Class.new!
+          # Remove parent's property definitions before defining the inline ones. #FIXME: don't inherit from self, remove those 2 lines.
+          representable_attrs.clear
+          representable_attrs.inheritable_arrays.clear
+
+          include base_module
+          instance_exec &block
+        end
       end
     end
 
+    # Allows you to nest a block of properties in a separate section while still mapping them to the outer object.
+    def self.nested(name, options={}, &block)
+      options = options.merge(
+        :nested   => true,
+        :getter   => lambda { |*| self },
+        :setter   => lambda { |*| },
+        :instance => lambda { |*| self }
+      )
+
+      property(name, options, &block)
+    end
+
     include Representable # include after class methods so Decorator::prepare can't be overwritten by Representable::prepare.
 
     def initialize(represented)
       @represented = represented
     end
   end
-end
+end

data/lib/representable/version.rb

@@ -1,3 +1,3 @@
 module Representable
-  VERSION = "1.7.5"
+  VERSION = "1.7.6"
 end

data/representable.gemspec

@@ -11,8 +11,8 @@ Gem::Specification.new do |s|
   s.authors     = ["Nick Sutterer"]
   s.email       = ["apotonick@gmail.com"]
   s.homepage    = "https://github.com/apotonick/representable/"
-  s.summary     = %q{Maps representation documents from and to Ruby objects. Includes XML and JSON support, plain properties, collections and compositions.}
-  s.description = %q{Maps representation documents from and to Ruby objects. Includes XML and JSON support, plain properties, collections and compositions.}
+  s.summary     = %q{Renders and parses JSON/XML/YAML documents from and to Ruby objects. Includes plain properties, collections, nesting, coercion and more.}
+  s.description = s.summary
 
   s.files         = `git ls-files`.split("\n")
   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")

data/test/generic_test.rb

@@ -21,7 +21,54 @@ class GenericTest < MiniTest::Spec
     it "leaves properties untouched" do
       album.from_hash({})
       # TODO: test property.
-      album.songs.must_equal ["Fuck Armageddon"] # DISCUSS: do we really want this?
+      album.songs.must_equal ["Fuck Armageddon"] # when the collection is not present in the incoming hash, this propery stays untouched.
+    end
+
+
+    # when collection is nil, it doesn't get rendered:
+    for_formats(
+      :hash => [Representable::Hash, {}],
+      :xml  => [Representable::XML, "<open_struct></open_struct>"],
+      :yaml => [Representable::YAML, "--- {}\n"], # FIXME: this doesn't look right.
+    ) do |format, mod, output, input|
+
+      describe "nil collections" do
+        let (:format) { format }
+
+        representer!(:module => mod) do
+          collection :songs
+          self.representation_wrap = :album if format == :xml
+        end
+
+        let (:album) { Album.new.extend(representer) }
+
+        it "doesn't render collection in #{format}" do
+          render(album).must_equal_document output
+        end
+      end
+    end
+
+    # when collection is set but empty, render the empty collection.
+    for_formats(
+      :hash => [Representable::Hash, {"songs" => []}],
+      #:xml  => [Representable::XML, "<open_struct><songs/></open_struct>"],
+      :yaml => [Representable::YAML, "---\nsongs: []\n"],
+    ) do |format, mod, output, input|
+
+      describe "empty collections" do
+        let (:format) { format }
+
+        representer!(:module => mod) do
+          collection :songs
+          self.representation_wrap = :album if format == :xml
+        end
+
+        let (:album) { OpenStruct.new(:songs => []).extend(representer) }
+
+        it "renders empty collection in #{format}" do
+          render(album).must_equal_document output
+        end
+      end
     end
   end
 
@@ -45,13 +92,6 @@ class GenericTest < MiniTest::Spec
     end
   end
 
-  def self.for_formats(formats)
-    formats.each do |format, cfg|
-      mod, output, input = cfg
-      yield format, mod, output, input
-    end
-  end
-
 
   for_formats(
     :hash => [Representable::Hash, {"song"=>{"title"=>"Resist Stance"}}, {"song"=>{"title"=>"Suffer"}}],
@@ -129,27 +169,6 @@ class GenericTest < MiniTest::Spec
     end
   end
 
-  def render(object)
-    AssertableDocument.new(object.send("to_#{format}"), format)
-  end
-
-  def parse(object, input)
-    object.send("from_#{format}", input)
-  end
-
-  class AssertableDocument
-    attr_reader :document
-
-    def initialize(document, format)
-      @document, @format = document, format
-    end
-
-    def must_equal_document(*args)
-      return document.must_equal_xml(*args) if @format == :xml
-      document.must_equal(*args)
-    end
-  end
-
 
   # Lonely Collection
   require "representable/hash/collection"

data/test/inline_test.rb

@@ -0,0 +1,144 @@
+require 'test_helper'
+
+class InlineTest < MiniTest::Spec
+  let (:song)    { Song.new("Alive") }
+  let (:request) { representer.prepare(OpenStruct.new(:song => song)) }
+
+  {
+    :hash => [Representable::Hash, {"song"=>{"name"=>"Alive"}}, {"song"=>{"name"=>"You've Taken Everything"}}],
+    :json => [Representable::JSON, "{\"song\":{\"name\":\"Alive\"}}", "{\"song\":{\"name\":\"You've Taken Everything\"}}"],
+    :xml  => [Representable::XML, "<open_struct>\n  <song>\n    <name>Alive</name>\n  </song>\n</open_struct>", "<open_struct><song><name>You've Taken Everything</name></song>/open_struct>"],
+    :yaml => [Representable::YAML, "---\nsong:\n  name: Alive\n", "---\nsong:\n  name: You've Taken Everything\n"],
+  }.each do |format, cfg|
+    mod, output, input = cfg
+
+    describe "[#{format}] with :class" do
+      representer!(:module => mod) do
+        property :song, :class => Song do
+          property :name
+        end
+      end
+
+      it { request.send("to_#{format}").must_equal output }
+      it { request.send("from_#{format}", input).song.name.must_equal "You've Taken Everything"}
+    end
+  end
+
+  {
+    :hash => [Representable::Hash, {"songs"=>[{"name"=>"Alive"}]}, {"songs"=>[{"name"=>"You've Taken Everything"}]}],
+    :json => [Representable::JSON, "{\"songs\":[{\"name\":\"Alive\"}]}", "{\"songs\":[{\"name\":\"You've Taken Everything\"}]}"],
+    :xml  => [Representable::XML, "<open_struct>\n  <song>\n    <name>Alive</name>\n  </song>\n</open_struct>", "<open_struct><song><name>You've Taken Everything</name></song></open_struct>", { :from => :song }],
+    :yaml => [Representable::YAML, "---\nsongs:\n- name: Alive\n", "---\nsongs:\n- name: You've Taken Everything\n"],
+  }.each do |format, cfg|
+    mod, output, input, collection_options = cfg
+    collection_options ||= {}
+
+    describe "[#{format}] collection with :class" do
+      let (:request) { representer.prepare(OpenStruct.new(:songs => [song])) }
+
+      representer!(:module => mod) do
+        collection :songs, collection_options.merge(:class => Song) do
+          property :name
+        end
+      end
+
+      it { request.send("to_#{format}").must_equal output }
+      it { request.send("from_#{format}", input).songs.first.name.must_equal "You've Taken Everything"}
+    end
+  end
+
+  describe "without :class" do
+    representer! do
+      property :song do
+        property :name
+      end
+    end
+
+    it { request.to_hash.must_equal({"song"=>{"name"=>"Alive"}}) }
+  end
+
+  describe "decorator" do
+    let (:request) { representer.prepare(OpenStruct.new(:song => song, :who => "Josephine")) }
+
+    let (:representer) do
+      Class.new(Representable::Decorator) do
+        include Representable::Hash
+
+        property :who
+
+        property :song, :class => Song do
+          property :name
+        end
+
+        self
+      end
+    end
+
+    it { request.to_hash.must_equal({"who"=>"Josephine", "song"=>{"name"=>"Alive"}}) }
+    it { request.from_hash({"song"=>{"name"=>"You've Taken Everything"}}).song.name.must_equal "You've Taken Everything"}
+
+    it "uses an inline decorator" do
+      request.to_hash
+      song.wont_be_kind_of Representable
+    end
+  end
+
+  # TODO: should be in extend:/decorator: test.
+  # FIXME: this tests :getter{represented}+:extend - represented gets extended twice and the inline decorator overrides original config.
+  # for_formats(
+  #   :hash => [Representable::Hash, {"album" => {"artist" => {"label"=>"Epitaph"}}}],
+  #   # :xml  => [Representable::XML, "<open_struct></open_struct>"],
+  #   #:yaml => [Representable::YAML, "---\nlabel:\n  label: Epitaph\n  owner: Brett Gurewitz\n"]
+  # ) do |format, mod, output, input|
+
+  #   module ArtistRepresenter
+  #     include Representable::JSON
+  #     property :label
+  #   end
+
+  #   describe ":getter with inline representer" do
+  #     let (:format) { format }
+
+  #     representer!(:module => mod) do
+  #       self.representation_wrap = :album
+
+  #       property :artist, :getter => lambda { |args| represented }, :extend => ArtistRepresenter
+  #     end
+
+  #     let (:album) { OpenStruct.new(:label => "Epitaph").extend(representer) }
+
+  #     it "renders nested Album-properties in separate section" do
+  #       render(album).must_equal_document output
+  #     end
+  #   end
+  # end
+
+
+  for_formats({
+      :hash => [Representable::Hash, {"album" => {"artist" => {"label"=>"Epitaph"}}}],
+      # :xml  => [Representable::XML, "<open_struct></open_struct>"],
+      #:yaml => [Representable::YAML, "---\nlabel:\n  label: Epitaph\n  owner: Brett Gurewitz\n"]
+    }) do |format, mod, output, input|
+
+    class ArtistDecorator < Representable::Decorator
+      include Representable::JSON
+      property :label
+    end
+
+    describe ":getter with :decorator" do
+      let (:format) { format }
+
+      representer!(:module => mod) do
+        self.representation_wrap = "album"
+
+        property :artist, :getter => lambda { |args| represented }, :decorator => ArtistDecorator
+      end
+
+      let (:album) { OpenStruct.new(:label => "Epitaph").extend(representer) }
+
+      it "renders nested Album-properties in separate section" do
+        render(album).must_equal_document output
+      end
+    end
+  end
+end

data/test/json_test.rb

@@ -426,7 +426,7 @@ end
 
   class HashTest < MiniTest::Spec
     describe "hash :songs" do
-      representer!(Representable::JSON) do
+      representer!(:module => Representable::JSON) do
         hash :songs
       end
 
@@ -443,7 +443,7 @@ end
     end
 
     describe "hash :songs, :class => Song" do
-      representer!(Representable::JSON) do
+      representer!(:module => Representable::JSON) do
         hash :songs, :extend => Module.new { include Representable::JSON; property :name }, :class => Song
       end
 

data/test/nested_test.rb

@@ -0,0 +1,97 @@
+require 'test_helper'
+
+class NestedTest < MiniTest::Spec
+	Album = Struct.new(:label, :owner)
+
+	for_formats(
+    :hash => [Representable::Hash, {"label" => {"label"=>"Epitaph", "owner"=>"Brett Gurewitz"}}],
+    # :xml  => [Representable::XML, "<open_struct></open_struct>"],
+    :yaml => [Representable::YAML, "---\nlabel:\n  label: Epitaph\n  owner: Brett Gurewitz\n"]
+  ) do |format, mod, output, input|
+
+    # describe "::nested with inline representer" do
+    #   let (:format) { format }
+
+    #   representer!(:module => mod) do
+    #     nested :label do
+    #     	property :label
+    #     	property :owner
+
+    #     	# self.representation_wrap = nil if format == :xml
+    #     end
+
+
+    #     self.representation_wrap = :album if format == :xml
+    #   end
+
+    #   let (:album) { Album.new("Epitaph", "Brett Gurewitz").extend(representer) }
+
+    #   it "renders nested Album-properties in separate section" do
+    #     render(album).must_equal_document output
+    #   end
+
+    #   it "parses nested properties to Album instance" do
+    #   	album = parse(Album.new.extend(representer), output)
+    #   	album.label.must_equal "Epitaph"
+    #   	album.owner.must_equal "Brett Gurewitz"
+    #   end
+    # end
+
+    describe "Decorator ::nested with extend:" do
+      let (:format) { format }
+
+      representer!(:name => :label_rpr) do
+      	include mod
+      	property :label
+        property :owner
+      end
+
+      representer!(:module => mod, :decorator => true, :inject => :label_rpr) do
+        nested :label, :extend => label_rpr
+
+        self.representation_wrap = :album if format == :xml
+      end
+
+      let (:album) { representer.prepare(Album.new("Epitaph", "Brett Gurewitz")) }
+
+      # TODO: shared example with above.
+      it "renders nested Album-properties in separate section" do
+        render(album).must_equal_document output
+      end
+
+      it "parses nested properties to Album instance" do
+      	album = parse(representer.prepare(Album.new), output)
+      	album.label.must_equal "Epitaph"
+      	album.owner.must_equal "Brett Gurewitz"
+      end
+    end
+
+    describe "Decorator ::nested" do
+      let (:format) { format }
+
+      representer!(:module => mod, :decorator => true) do
+        nested :label do
+          property :label
+          property :owner
+
+          # self.representation_wrap = nil if format == :xml
+        end
+
+
+        self.representation_wrap = :album if format == :xml
+      end
+
+      let (:album) { representer.prepare(Album.new("Epitaph", "Brett Gurewitz")) }
+
+      it "renders nested Album-properties in separate section" do
+        render(album).must_equal_document output
+      end
+
+      it "parses nested properties to Album instance" do
+        album = parse(representer.prepare(Album.new), output)
+        album.label.must_equal "Epitaph"
+        album.owner.must_equal "Brett Gurewitz"
+      end
+    end
+  end
+end

data/test/representable_test.rb

@@ -457,86 +457,6 @@ class RepresentableTest < MiniTest::Spec
     end
   end
 
-  describe "inline representers" do
-    let (:song)    { Song.new("Alive") }
-    let (:request) { representer.prepare(OpenStruct.new(:song => song)) }
-
-    {
-      :hash => [Representable::Hash, {"song"=>{"name"=>"Alive"}}, {"song"=>{"name"=>"You've Taken Everything"}}],
-      :json => [Representable::JSON, "{\"song\":{\"name\":\"Alive\"}}", "{\"song\":{\"name\":\"You've Taken Everything\"}}"],
-      :xml  => [Representable::XML, "<open_struct>\n  <song>\n    <name>Alive</name>\n  </song>\n</open_struct>", "<open_struct><song><name>You've Taken Everything</name></song>/open_struct>"],
-      :yaml => [Representable::YAML, "---\nsong:\n  name: Alive\n", "---\nsong:\n  name: You've Taken Everything\n"],
-    }.each do |format, cfg|
-      mod, output, input = cfg
-
-      describe "[#{format}] with :class" do
-        representer!(mod) do
-          property :song, :class => Song do
-            property :name
-          end
-        end
-
-        it { request.send("to_#{format}").must_equal output }
-        it { request.send("from_#{format}", input).song.name.must_equal "You've Taken Everything"}
-      end
-    end
-
-    {
-      :hash => [Representable::Hash, {"songs"=>[{"name"=>"Alive"}]}, {"songs"=>[{"name"=>"You've Taken Everything"}]}],
-      :json => [Representable::JSON, "{\"songs\":[{\"name\":\"Alive\"}]}", "{\"songs\":[{\"name\":\"You've Taken Everything\"}]}"],
-      :xml  => [Representable::XML, "<open_struct>\n  <song>\n    <name>Alive</name>\n  </song>\n</open_struct>", "<open_struct><song><name>You've Taken Everything</name></song></open_struct>", { :from => :song }],
-      :yaml => [Representable::YAML, "---\nsongs:\n- name: Alive\n", "---\nsongs:\n- name: You've Taken Everything\n"],
-    }.each do |format, cfg|
-      mod, output, input, collection_options = cfg
-      collection_options ||= {}
-
-      describe "[#{format}] collection with :class" do
-        let (:request) { representer.prepare(OpenStruct.new(:songs => [song])) }
-
-        representer!(mod) do
-          collection :songs, collection_options.merge(:class => Song) do
-            property :name
-          end
-        end
-
-        it { request.send("to_#{format}").must_equal output }
-        it { request.send("from_#{format}", input).songs.first.name.must_equal "You've Taken Everything"}
-      end
-    end
-
-    describe "without :class" do
-      representer! do
-        property :song do
-          property :name
-        end
-      end
-
-      it { request.to_hash.must_equal({"song"=>{"name"=>"Alive"}}) }
-    end
-
-    describe "decorator" do
-      let (:representer) do
-        Class.new(Representable::Decorator) do
-          include Representable::Hash
-
-          property :song, :class => Song do
-            property :name
-          end
-
-          self
-        end
-      end
-
-      it { request.to_hash.must_equal({"song"=>{"name"=>"Alive"}}) }
-      it { request.from_hash({"song"=>{"name"=>"You've Taken Everything"}}).song.name.must_equal "You've Taken Everything"}
-
-      it "uses an inline decorator" do
-        request.to_hash
-        song.wont_be_kind_of Representable
-      end
-    end
-  end
-
   describe ":if" do
     before do
       @pop = Class.new(PopBand) { attr_accessor :fame }

data/test/test_helper.rb

@@ -49,20 +49,44 @@ MiniTest::Spec.class_eval do
   include AssertJson::Assertions
   include XmlHelper
 
-  def self.representer!(format=Representable::Hash, name=:representer, &block)
-    fmt = format # we need that so the 2nd call to ::let (within a ::describe) remembers the right format.
+  def self.for_formats(formats)
+    formats.each do |format, cfg|
+      mod, output, input = cfg
+      yield format, mod, output, input
+    end
+  end
+
+  def render(object)
+    AssertableDocument.new(object.send("to_#{format}"), format)
+  end
+
+  def parse(object, input)
+    object.send("from_#{format}", input)
+  end
+
+  class AssertableDocument
+    attr_reader :document
 
-    if fmt.is_a?(Hash)
-      name   = fmt[:name] || :representer
-      format = fmt[:module] || Representable::Hash
+    def initialize(document, format)
+      @document, @format = document, format
     end
 
+    def must_equal_document(*args)
+      return document.must_equal_xml(*args) if @format == :xml
+      document.must_equal(*args)
+    end
+  end
+
+  def self.representer!(options={}, &block)
+    fmt = options # we need that so the 2nd call to ::let (within a ::describe) remembers the right format.
+
+    name   = options[:name]   || :representer
+    format = options[:module] || Representable::Hash
+
     let(name) do
-      mod = Module.new
+      mod = options[:decorator] ? Class.new(Representable::Decorator) : Module.new
 
-      if fmt.is_a?(Hash)
-        inject_representer(mod, fmt)
-      end
+      inject_representer(mod, fmt)
 
       mod.module_eval do
         include format

data/test/xml_test.rb

@@ -396,7 +396,7 @@ class CollectionTest < MiniTest::Spec
 
     describe "XML::Collection" do
       describe "with contained objects" do
-        representer!(Representable::XML::Collection)  do
+        representer!(:module => Representable::XML::Collection)  do
           items :class => Song, :extend => SongRepresenter
           self.representation_wrap= :songs
         end
@@ -423,7 +423,7 @@ class CollectionTest < MiniTest::Spec
     end
 
     describe "XML::AttributeHash" do  # TODO: move to HashTest.
-      representer!(Representable::XML::AttributeHash) do
+      representer!(:module => Representable::XML::AttributeHash) do
         self.representation_wrap= :songs
       end
 

metadata

@@ -1,165 +1,165 @@
 --- !ruby/object:Gem::Specification
 name: representable
 version: !ruby/object:Gem::Version
-  version: 1.7.5
+  version: 1.7.6
 platform: ruby
 authors:
 - Nick Sutterer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-12-18 00:00:00.000000000 Z
+date: 2014-02-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: multi_json
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   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: test_xml
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.1.6
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.1.6
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 5.0.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 5.0.0
 - !ruby/object:Gem::Dependency
   name: mocha
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.13.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.13.0
 - !ruby/object:Gem::Dependency
   name: mongoid
   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: virtus
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 0.5.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 0.5.0
 - !ruby/object:Gem::Dependency
   name: yajl-ruby
   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: json
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 1.7.7
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 1.7.7
-description: Maps representation documents from and to Ruby objects. Includes XML
-  and JSON support, plain properties, collections and compositions.
+description: Renders and parses JSON/XML/YAML documents from and to Ruby objects.
+  Includes plain properties, collections, nesting, coercion and more.
 email:
 - apotonick@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
-- .travis.yml
+- ".gitignore"
+- ".travis.yml"
 - CHANGES.md
 - Gemfile
 - LICENSE
@@ -203,8 +203,10 @@ files:
 - test/hash_bindings_test.rb
 - test/hash_test.rb
 - test/inheritance_test.rb
+- test/inline_test.rb
 - test/json_test.rb
 - test/mongoid_test.rb
+- test/nested_test.rb
 - test/representable_test.rb
 - test/test_helper.rb
 - test/test_helper_test.rb
@@ -220,19 +222,38 @@ 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: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.3
+rubygems_version: 2.2.1
 signing_key: 
 specification_version: 4
-summary: Maps representation documents from and to Ruby objects. Includes XML and
-  JSON support, plain properties, collections and compositions.
-test_files: []
+summary: Renders and parses JSON/XML/YAML documents from and to Ruby objects. Includes
+  plain properties, collections, nesting, coercion and more.
+test_files:
+- test/coercion_test.rb
+- test/config_test.rb
+- test/decorator_test.rb
+- test/definition_test.rb
+- test/example.rb
+- test/generic_test.rb
+- test/hash_bindings_test.rb
+- test/hash_test.rb
+- test/inheritance_test.rb
+- test/inline_test.rb
+- test/json_test.rb
+- test/mongoid_test.rb
+- test/nested_test.rb
+- test/representable_test.rb
+- test/test_helper.rb
+- test/test_helper_test.rb
+- test/xml_bindings_test.rb
+- test/xml_test.rb
+- test/yaml_test.rb