representable 1.1.2 → 1.1.3

data/CHANGES.textile

@@ -1,3 +1,7 @@
+h2. 1.1.3
+
+* Introduced `#compile_fragment` and friends to make it simpler overriding parsing and rendering steps.
+
 h2. 1.1.2
 
 * Allow `Module.hash` to be called without arguments as this seems to be required in Padrino.

data/lib/representable.rb

@@ -45,24 +45,22 @@ module Representable
   end
   
   # Reads values from +doc+ and sets properties accordingly.
-  def update_properties_from(doc, options, format, &block)
+  def update_properties_from(doc, options, format)
     representable_bindings_for(format).each do |bin|
       next if skip_property?(bin, options)
       
-      value = bin.read(doc) || bin.definition.default
-      send(bin.definition.setter, value)
+      uncompile_fragment(bin, doc)
     end
     self
   end
   
 private
   # Compiles the document going through all properties.
-  def create_representation_with(doc, options, format, &block)
+  def create_representation_with(doc, options, format)
     representable_bindings_for(format).each do |bin|
       next if skip_property?(bin, options)
       
-      value = send(bin.definition.getter) || bin.definition.default # DISCUSS: eventually move back to Ref.
-      bin.write(doc, value) if value
+      compile_fragment(bin, doc)
     end
     doc
   end
@@ -74,6 +72,27 @@ private
     options[:include] ? !res : res
   end
   
+  # Retrieve value and write fragment to the doc.
+  def compile_fragment(bin, doc)
+    value = send(bin.definition.getter) || bin.definition.default # DISCUSS: eventually move back to Ref.
+    write_fragment_for(bin, value, doc)
+  end
+  
+  # Parse value from doc and update the model property.
+  def uncompile_fragment(bin, doc)
+    value = read_fragment_for(bin, doc) || bin.definition.default
+    send(bin.definition.setter, value)
+  end
+  
+  def write_fragment_for(bin, value, doc) # DISCUSS: move to Binding?
+    return unless value
+    bin.write(doc, value)
+  end
+  
+  def read_fragment_for(bin, doc) # DISCUSS: move to Binding?
+    bin.read(doc)
+  end
+  
   def representable_attrs
     @representable_attrs ||= self.class.representable_attrs # DISCUSS: copy, or better not?
   end

data/lib/representable/bindings/json_bindings.rb

@@ -62,6 +62,7 @@ module Representable
     
     class HashBinding < JSONBinding
       def serialize_for(value)
+        # requires value to respond to #each with two block parameters.
         {}.tap do |hash|
           value.each { |key, obj| hash[key] = serialize(obj) }
         end

data/lib/representable/version.rb

@@ -1,3 +1,3 @@
 module Representable
-  VERSION = "1.1.2"
+  VERSION = "1.1.3"
 end

metadata

@@ -1,125 +1,101 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: representable
-version: !ruby/object:Gem::Version 
-  prerelease: false
-  segments: 
-  - 1
-  - 1
-  - 2
-  version: 1.1.2
+version: !ruby/object:Gem::Version
+  version: 1.1.3
+  prerelease: 
 platform: ruby
-authors: 
+authors:
 - Nick Sutterer
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2012-03-01 00:00:00 +01:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2012-03-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: nokogiri
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  requirement: &82431430 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :runtime
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: json
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  version_requirements: *82431430
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: &82430990 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :runtime
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
-  name: rake
   prerelease: false
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  version_requirements: *82430990
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &82430300 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id003
-- !ruby/object:Gem::Dependency 
-  name: test_xml
   prerelease: false
-  requirement: &id004 !ruby/object:Gem::Requirement 
+  version_requirements: *82430300
+- !ruby/object:Gem::Dependency
+  name: test_xml
+  requirement: &82429660 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id004
-- !ruby/object:Gem::Dependency 
-  name: minitest
   prerelease: false
-  requirement: &id005 !ruby/object:Gem::Requirement 
+  version_requirements: *82429660
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: &82426770 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 2
-        - 8
-        - 1
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
         version: 2.8.1
   type: :development
-  version_requirements: *id005
-- !ruby/object:Gem::Dependency 
-  name: mocha
   prerelease: false
-  requirement: &id006 !ruby/object:Gem::Requirement 
+  version_requirements: *82426770
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: &82426410 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id006
-- !ruby/object:Gem::Dependency 
-  name: mongoid
   prerelease: false
-  requirement: &id007 !ruby/object:Gem::Requirement 
+  version_requirements: *82426410
+- !ruby/object:Gem::Dependency
+  name: mongoid
+  requirement: &82425780 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id007
-description: Maps representation documents from and to Ruby objects. Includes XML and JSON support, plain properties, collections and compositions.
-email: 
+  prerelease: false
+  version_requirements: *82425780
+description: Maps representation documents from and to Ruby objects. Includes XML
+  and JSON support, plain properties, collections and compositions.
+email:
 - apotonick@gmail.com
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - .gitignore
 - .rspec
 - .travis.yml
@@ -150,37 +126,29 @@ files:
 - test/test_helper.rb
 - test/xml_bindings_test.rb
 - test/xml_test.rb
-has_rdoc: true
 homepage: http://representable.apotomo.de
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.3.7
+rubygems_version: 1.8.10
 signing_key: 
 specification_version: 3
-summary: Maps representation documents from and to Ruby objects. Includes XML and JSON support, plain properties, collections and compositions.
+summary: Maps representation documents from and to Ruby objects. Includes XML and
+  JSON support, plain properties, collections and compositions.
 test_files: []
-