representable 0.13.1 → 1.0.0

data/CHANGES.textile

@@ -1,3 +1,7 @@
+h2. 1.0.0
+
+* 1.0.0 release! Party time!
+
 h2. 0.13.1
 
 * Removed property :@name from @XML@ in favor of @:attribute => true@.

data/README.rdoc

@@ -44,7 +44,7 @@ To use your representer include it in the matching class. Note that you could re
   class Hero
     attr_accessor :forename, :surename
   	
-  	include Representable
+    include Representable
     include HeroRepresenter
   end
 
@@ -215,13 +215,13 @@ Representers roughly follow the {DCI}[http://en.wikipedia.org/wiki/Data,_context
 
 The only difference is that you have to define which representers to use for typed properties.
 
-	module HeroRepresenter
-	  property :forename
-	  property :surename
-	  collection :features
-	  property :origin, :class => Location
-	  collection :friends, :class => Hero, :extend => HeroRepresenter
-	end
+  module HeroRepresenter
+    property :forename
+    property :surename
+    collection :features
+    property :origin, :class => Location
+    collection :friends, :class => Hero, :extend => HeroRepresenter
+  end
 
 There's no need to specify a representer for the +origin+ property since the +Location+ class statically includes its representation. For +friends+, we can use +:extend+ to tell representable which module to mix in dynamically.
 
@@ -250,6 +250,21 @@ Representable allows declaring a document's syntax and structure while having di
 
 The #to_xml method gives us an XML representation of Peter - great!
 
+=== Mapping tag attributes
+
+You can also map properties to tag attributes in representable.
+
+  class Hero
+  	attr_accessor :name
+    include Representable::XML
+    property :name, :attribute => true
+  end
+  
+  Hero.new(:name => "Peter Pan").to_xml
+  #=> <hero name="Peter Pan" />
+
+Naturally, this works for both ways.
+
 
 == More
 

data/lib/representable.rb

@@ -1,5 +1,29 @@
 require 'representable/definition'
 
+# Representable can be used in two ways.
+#
+# == On class level
+#
+# To try out Representable you might include the format module into the represented class directly and then
+# define the properties.
+#
+#   class Hero < ActiveRecord::Base
+#     include Representable::JSON
+#     property :name
+#
+# This will give you to_/from_json for each instance. However, this approach limits your class to one representation.
+#
+# == On module level
+#
+# Modules give you much more flexibility since you can mix them into objects at runtime, roughly following the DCI
+# pattern.
+#
+#   module HeroRepresenter
+#     include Representable::JSON
+#     property :name
+#   end
+#
+#   hero.extend(HeroRepresenter).to_json
 module Representable
   def self.included(base)
     base.class_eval do

data/lib/representable/version.rb

@@ -1,3 +1,3 @@
 module Representable
-  VERSION = "0.13.1"
+  VERSION = "1.0.0"
 end

data/representable.gemspec

@@ -24,6 +24,6 @@ Gem::Specification.new do |s|
   
   s.add_development_dependency "rake"
   s.add_development_dependency "test_xml"
-  s.add_development_dependency "minitest", "~>2.8"
+  s.add_development_dependency "minitest", "=2.8.1"
   s.add_development_dependency "mocha"
 end

metadata

@@ -1,113 +1,91 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: representable
-version: !ruby/object:Gem::Version 
-  prerelease: false
-  segments: 
-  - 0
-  - 13
-  - 1
-  version: 0.13.1
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
 platform: ruby
-authors: 
+authors:
 - Nick Sutterer
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-12-27 00:00:00 +01:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2011-12-27 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: nokogiri
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  requirement: &72760530 !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: *72760530
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: &72760260 !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: *72760260
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &72760000 !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: *72760000
+- !ruby/object:Gem::Dependency
+  name: test_xml
+  requirement: &72759760 !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: *72759760
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: &72759480 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 2
-        - 8
-        version: "2.8"
+    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: *72759480
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: &72759220 !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
-description: Maps representation documents from and to Ruby objects. Includes XML and JSON support, plain properties, collections and compositions.
-email: 
+  prerelease: false
+  version_requirements: *72759220
+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
-- .gitmodules
 - .rspec
 - .travis.yml
 - CHANGES.textile
@@ -130,37 +108,29 @@ files:
 - test/representable_test.rb
 - test/test_helper.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: []
-

data/.gitmodules

@@ -1,3 +0,0 @@
-[submodule "vendor/override_rake_task"]
-	path = vendor/override_rake_task
-	url = git://github.com/Empact/override_rake_task.git