transcriber 0.0.3 → 0.0.4

data/README.md

@@ -91,7 +91,7 @@ Just define your `User` class like this:
 
 ## Embedding other resources
 
-### [`embeds_one`](https://github.com/rodrigues/transcriber/tree/master/examples/embeds_one)
+### [embeds_one](https://github.com/rodrigues/transcriber/tree/master/examples/embeds_one)
 
     class Customer < Transcriber::Resource
       id field: 'cust_id'
@@ -116,7 +116,7 @@ Just define your `User` class like this:
       href:  "http://app/api/users/1938713897398"
     }
 
-### [`embeds_many`](https://github.com/rodrigues/transcriber/tree/master/examples/embeds_many)
+### [embeds_many](https://github.com/rodrigues/transcriber/tree/master/examples/embeds_many)
 
     class OrderItems < Transcriber::Resource
       property :item_id,    id: true      # default serialization: String
@@ -150,7 +150,9 @@ Just define your `User` class like this:
 
 ## Relations
 
-### `has_one`, `has_many` and `belongs_to`
+### has_one
+### has_many
+### belongs_to
 
     class User < Transcriber::Resource
       id
@@ -163,7 +165,7 @@ Just define your `User` class like this:
     {
       id:    19837139879,
       login: 'jsmith180',
-      links: [
+      link: [
         {
           rel:  'avatar',
           href: 'http://app/api/users/19837139879/avatar'
@@ -195,7 +197,7 @@ If you want your api to handle `http://app/api/users/19371897318937?include[]=av
       guilda: {
         name: 'K1ll3rs'
       },
-      links: [
+      link: [
         {
           rel:  'achievements',
           href: 'http://app/api/users/19837139879/achievements'

data/examples/all.rb

@@ -1,14 +1,10 @@
 $:.push 'lib'; require 'transcriber'
 
 Dir["examples/*/**.rb"].each do |file|
-  [:Root, :Item, :Customer, :Entry].each do |klass|
+  [:Root, :Item, :Customer, :Entry, :Service].each do |klass|
     Object.send(:remove_const, klass) if Object.const_defined? klass
   end
 
-  puts
-  puts
-  p "example file: #{file}"
-  puts
-  puts
+  puts "\n\nexample file: #{file}\n\n"
   load file
 end

data/examples/embeds_many/simple.rb

@@ -1,14 +1,14 @@
 $:.push 'lib'; require 'transcriber'
 
 class Item < Transcriber::Resource
-  property :id
+  property :id, type: Integer
 end
 
 class Root < Transcriber::Resource
   embeds_many :items
 end
 
-@root = Root.parse({"items" => [{"id" => 2000}]}).first
+@root = Root.parse({"items" => [{"id" => 2000}, {"id" => 2001}]}).first
 
 puts "root:     #{@root.inspect}"
 puts "resource: #{@root.resource}"

data/examples/embeds_many/with_class_name.rb

@@ -1,14 +1,14 @@
 $:.push 'lib'; require 'transcriber'
 
 class Entry < Transcriber::Resource
-  property :id
+  property :id, type: Integer
 end
 
 class Root < Transcriber::Resource
   embeds_many :items, class_name: :entry
 end
 
-root = Root.parse({"items" => [{"id" => 2000}]}).first
+@root = Root.parse({"items" => [{"id" => 2000}]}).first
 
-puts "root:     #{root.inspect}"
-puts "resource: #{root.resource}"
+puts "root:     #{@root.inspect}"
+puts "resource: #{@root.resource}"

data/examples/embeds_many/with_if.rb

@@ -9,13 +9,13 @@ class Root < Transcriber::Resource
   embeds_many :items, if: proc {id == "10"}
 end
 
-root = Root.parse({"id" => 10, "items" => [{"id" => 2000}]}).first
+@root_with_items = Root.parse({"id" => 10, "items" => [{"id" => 2000}]}).first
 
-puts "root:     #{root.inspect}"
-puts "resource: #{root.resource}"
+puts "root:     #{@root_with_items.inspect}"
+puts "resource: #{@root_with_items.resource}"
 
 
-root = Root.parse({"id" => 1, "items" => [{"id" => 2000}]}).first
+@root_without_items = Root.parse({"id" => 1, "items" => [{"id" => 2000}]}).first
 
-puts "root:     #{root.inspect}"
-puts "resource: #{root.resource}"
+puts "root:     #{@root_without_items.inspect}"
+puts "resource: #{@root_without_items.resource}"

data/examples/embeds_many/with_start_key.rb

@@ -10,8 +10,8 @@ class Root < Transcriber::Resource
   embeds_many :items, start_key: 'detalhe.itens'
 end
 
-root = Root.parse({"detalhe" => {"itens" => [{"item_id" => 2000}]}}).first
+@root = Root.parse({"detalhe" => {"itens" => [{"item_id" => 2000}]}}).first
 
-puts "root:     #{root.inspect}"
-puts "resource: #{root.resource}"
-puts "to_json:  #{root.resource.to_json}"
+puts "root:     #{@root.inspect}"
+puts "resource: #{@root.resource}"
+puts "to_json:  #{@root.resource.to_json}"

data/examples/embeds_one/simple.rb

@@ -8,7 +8,7 @@ class Item < Transcriber::Resource
   property :id
 end
 
-root = Root.parse({"item" => {"id" => 2000}}).first
+@root = Root.parse({"item" => {"id" => 2000}}).first
 
-puts "root:     #{root.inspect}"
-puts "resource: #{root.resource}"
+puts "root:     #{@root.inspect}"
+puts "resource: #{@root.resource}"

data/examples/embeds_one/with_class_name.rb

@@ -8,7 +8,7 @@ class Root < Transcriber::Resource
   embeds_one :item, class_name: :entry
 end
 
-root = Root.parse({"item" => {"id" => 2000}}).first
+@root = Root.parse({"item" => {"id" => 2000}}).first
 
-puts "root:     #{root.inspect}"
-puts "resource: #{root.resource}"
+puts "root:     #{@root.inspect}"
+puts "resource: #{@root.resource}"

data/examples/embeds_one/with_if.rb

@@ -9,13 +9,13 @@ class Item < Transcriber::Resource
   property :id
 end
 
-root = Root.parse({"id"=> 1, "item" => {"id" => 2000}}).first
+@root_with_item = Root.parse({"id"=> 1, "item" => {"id" => 2000}}).first
 
-puts "root:     #{root.inspect}"
-puts "resource: #{root.resource}"
+puts "root:     #{@root_with_item.inspect}"
+puts "resource: #{@root_with_item.resource}"
 
 
-root = Root.parse({"id"=> 100, "item" => {"id" => 2000}}).first
+@root_without_item = Root.parse({"id"=> 100, "item" => {"id" => 2000}}).first
 
-puts "root:     #{root.inspect}"
-puts "resource: #{root.resource}"
+puts "root:     #{@root_without_item.inspect}"
+puts "resource: #{@root_without_item.resource}"

data/examples/embeds_one/with_start_key.rb

@@ -8,7 +8,7 @@ class Item < Transcriber::Resource
   property :id
 end
 
-root = Root.parse({"ugly_nesting_key" => {"id" => 2000}}).first
+@root = Root.parse({"ugly_nesting_key" => {"id" => 2000}}).first
 
-puts "root:     #{root.inspect}"
-puts "resource: #{root.resource}"
+puts "root:     #{@root.inspect}"
+puts "resource: #{@root.resource}"

data/examples/has_many/simple.rb

@@ -16,14 +16,14 @@ class Developer < Transcriber::Resource
 end
 
 class Customer < Transcriber::Resource
-  id field: :customer_id
+  id field: :customer_id, type: Integer
   property :login
   has_many :services
   has_one :billing
-  has_one :devopada, class_name: :developer
+  has_one :devops, class_name: :developer
 end
 
-@root = Customer.parse({"customer_id" => 123, "login" => 2000}).first
+@root = Customer.parse({"customer_id" => 123, "login" => 'jackiechan2010'}).first
 
 puts "root:     #{@root.inspect}"
 puts "resource: #{@root.resource}"

data/examples/properties/collections.rb

@@ -0,0 +1,12 @@
+$:.push 'lib'; require 'transcriber'
+
+class Customer < Transcriber::Resource
+  property :login
+end
+
+@customers = Customer.parse([{"login" => "jackiechan2010"},
+                             {"login" => "brucelee"},
+                             {"login" => "vcr2"}])
+
+puts "root:     #{@customers.inspect}"
+puts "resource: #{Customer.resources @customers}"

data/examples/properties/simple.rb

@@ -4,7 +4,7 @@ class Customer < Transcriber::Resource
   property :login
 end
 
-root = Customer.parse({"login" => 2000}).first
+@root = Customer.parse({"login" => 'jackiechan2010'}).first
 
-puts "root:     #{root.inspect}"
-puts "resource: #{root.resource}"
+puts "root:     #{@root.inspect}"
+puts "resource: #{@root.resource}"

data/examples/properties/with_field.rb

@@ -4,7 +4,7 @@ class Customer < Transcriber::Resource
   property :login, field: :customer_login
 end
 
-root = Customer.parse({"customer_login" => 2000}).first
+@root = Customer.parse({"customer_login" => 'jackiechan2010'}).first
 
-puts "root:     #{root.inspect}"
-puts "resource: #{root.resource}"
+puts "root:     #{@root.inspect}"
+puts "resource: #{@root.resource}"

data/examples/properties/with_field_path.rb

@@ -4,7 +4,7 @@ class Customer < Transcriber::Resource
   property :login, field: 'hidden.login'
 end
 
-root = Customer.parse({"hidden" => {"login" => 2000}}).first
+@root = Customer.parse({"hidden" => {"login" => 'jackiechan2010'}}).first
 
-puts "root:     #{root.inspect}"
-puts "resource: #{root.resource}"
+puts "root:     #{@root.inspect}"
+puts "resource: #{@root.resource}"

data/examples/properties/with_id.rb

@@ -4,7 +4,7 @@ class Customer < Transcriber::Resource
   id
 end
 
-root = Customer.parse({"id" => 2000}).first
+@root = Customer.parse({"id" => 2000}).first
 
-puts "root:     #{root.inspect}"
-puts "resource: #{root.resource}"
+puts "root:     #{@root.inspect}"
+puts "resource: #{@root.resource}"

data/examples/properties/with_if.rb

@@ -3,17 +3,23 @@ $:.push 'lib'; require 'transcriber'
 class Customer < Transcriber::Resource
   property :login
   property :password
-  property :some_text, if: proc {password == "abc"}
+  property :description, if: proc {password == "abc"}
 end
 
-root = Customer.parse({"login" => 2000, "password" => "abc", "some_text" => "some text"}).first
+@root_with_description = Customer.parse({
+  "login" => 2000,
+  "password" => "abc",
+  "description" => "description"}).first
 
 
-puts "root:     #{root.inspect}"
-puts "resource: #{root.resource}"
+puts "root:     #{@root_with_description.inspect}"
+puts "resource: #{@root_with_description.resource}"
 
 
-root = Customer.parse({"login" => 2000, "password" => "abcd", "some_text" => "some text II"}).first
+@root_without_description = Customer.parse({
+  "login" => 2000,
+  "password" => "abcd",
+  "description" => "some text II"}).first
 
-puts "root:     #{root.inspect}"
-puts "resource: #{root.resource}"
+puts "root:     #{@root_without_description.inspect}"
+puts "resource: #{@root_without_description.resource}"

data/examples/properties/with_key_converter.rb

@@ -14,7 +14,7 @@ class Customer < Transcriber::Resource
   property :login
 end
 
-root = Customer.parse({"LOGIN" => 2000}).first
+@root = Customer.parse({"LOGIN" => 'jackiechan2010'}).first
 
-puts "root:     #{root.inspect}"
-puts "resource: #{root.resource}"
+puts "root:     #{@root.inspect}"
+puts "resource: #{@root.resource}"

data/examples/properties/with_two_key_converters.rb

@@ -0,0 +1,29 @@
+$:.push 'lib'; require 'transcriber'
+
+module Upcasing
+  def self.call(keys)
+    keys.map {|key| key.to_s.upcase}
+  end
+end
+
+module Camelizing
+  def self.call(keys)
+    keys.map {|key| key.to_s.camelize}
+  end
+end
+
+class Customer < Transcriber::Resource
+  convert_input_keys Upcasing
+  property :login
+  embeds_one :product
+end
+
+class Product < Transcriber::Resource
+  convert_input_keys Camelizing
+  property :unit_price, type: Float
+end
+
+@root = Customer.parse({"LOGIN" => 'jackiechan2010', "PRODUCT" => {"UnitPrice" => 29.9}}).first
+
+puts "root:     #{@root.inspect}"
+puts "resource: #{@root.resource}"

data/examples/summarization/simple.rb

@@ -0,0 +1,27 @@
+$:.push 'lib'; require 'transcriber'
+
+module AsDefined
+  def self.call(keys)
+    keys
+  end
+end
+
+class Customer < Transcriber::Resource
+  convert_input_keys AsDefined
+  id
+  properties :login, :name, :postal_code, :email, :secondary_email
+  summarizes :id, :login
+end
+
+input = {
+  id:               138911938,
+  login:           'jackiechan2010',
+  name:            'jackie chan',
+  postal_code:     '05492-092',
+  email:           'jachan@gmail.com',
+  secondary_email: 'jackiepeligroso@yahoo.com'
+}
+
+@root = Customer.transcribe(input)
+
+puts "resources: #{@root.inspect}"

data/lib/transcriber.rb

@@ -1,5 +1,6 @@
 require 'date'
 require 'active_support/inflector'
+require 'active_support/concern'
 require 'active_support/core_ext/class/attribute_accessors'
 require 'active_support/core_ext/object/try'
 require 'active_support/core_ext/array/wrap'
@@ -19,14 +20,17 @@ require 'transcriber/resource/parser/embeddable'
 require 'transcriber/resource/response/property'
 require 'transcriber/resource/response/embeddable'
 require 'transcriber/resource/response/relation'
+require 'transcriber/resource/response/href'
 require 'transcriber/resource/key/property'
 require 'transcriber/resource/key/association'
 require 'transcriber/resource/key/relation'
 require 'transcriber/resource/key/embeddable'
+require 'transcriber/resource/key/href'
 require 'transcriber/resource/builder/keys'
 require 'transcriber/resource/builder/relations'
 require 'transcriber/resource/builder/embeddables'
 require 'transcriber/resource/builder/properties'
+require 'transcriber/resource/builder/summarizations'
 require 'transcriber/resource/builder'
 require 'transcriber/resource'
 require 'transcriber/configuration'
@@ -39,4 +43,8 @@ module Transcriber
   def self.configure
     yield configuration if block_given?
   end
+
+  def self.host
+    configuration.host
+  end
 end

data/lib/transcriber/configuration.rb

@@ -1,5 +1,7 @@
 module Transcriber
   class Configuration
+    attr_accessor :host
+
     DefaultHandler = lambda {|keys| keys.map(&:to_s)}
 
     def convert_input_keys

data/lib/transcriber/resource.rb

@@ -2,7 +2,7 @@ module Transcriber
   class Resource
     extend  Builder
     extend  Parser
-    extend  Response
+    include Response
     include Serialization
 
     cattr_accessor :id_key
@@ -16,6 +16,10 @@ module Transcriber
       @keys ||= []
     end
 
+    def self.summarized_keys
+      @summarized_keys ||= []
+    end
+
     def self.relations
       @keys.find_all {|k| k.kind_of?(Relation)}
     end
@@ -24,24 +28,13 @@ module Transcriber
       @resource_name ||= custom_name or to_s.demodulize.tableize
     end
 
-    def resource_id
-      __send__(id_key.name)
-    end
-
-    def resource(options = {})
-      root = options.fetch(:root, true)
-      {}.tap do |resource|
-        self.class.keys.inject(resource) {|buffer, key| buffer.merge!(key.to_resource(self))}
-        resource.merge!({links: links}) if root and self.class.relations.any?
-      end
-    end
-
-    def links
-      self.class.relations.map {|key| key.to_relation(self)}
+    def self.convert_input_keys(converter = nil)
+      @convert_input_keys = converter if converter
+      @convert_input_keys
     end
 
-    def self.transcribe(input, options = {})
-      normalize(parse(input, options), options)
+    def resource_id
+      __send__(id_key.name)
     end
 
     def self.method_added(method_name)
@@ -50,7 +43,7 @@ module Transcriber
     end
 
     def self.not_allowed_names
-      ["resource_id", "resource", "links"]
+      ["resource_id", "resource", "link"]
     end
   end
 end

data/lib/transcriber/resource/builder.rb

@@ -5,6 +5,7 @@ module Transcriber
       include Relations
       include Embeddables
       include Properties
+      include Summarizations
     end
   end
 end

data/lib/transcriber/resource/builder/keys.rb

@@ -4,6 +4,7 @@ module Transcriber
       module Keys
         def key(key)
           fail "you can't define a key with name '#{key.name}'" if not_allowed?(key)
+          key.model = self
           attr_accessor key.name
           self.keys  << key
           self.id_key = key if key.options[:id]

data/lib/transcriber/resource/builder/summarizations.rb

@@ -1,11 +1,11 @@
 module Transcriber
   class Resource
     module Builder
-      module Summarization
-        def summarizes(*args = [])
+      module Summarizations
+        def summarizes(*args)
           args.each do |name|
             key = keys.find {|key| key.name == name}
-            key.summarize = true if key
+            summarized_keys << key if key
           end
         end
       end

data/lib/transcriber/resource/key.rb

@@ -2,6 +2,7 @@ module Transcriber
   class Resource
     class Key
       attr_accessor :name
+      attr_accessor :model
       attr_accessor :options
       attr_accessor :summarize
 
@@ -31,7 +32,8 @@ module Transcriber
       end
 
       def convert_input_keys
-        options.fetch(:convert_input_keys, Transcriber.configuration.convert_input_keys)
+        options.fetch(:convert_input_keys, model.try(:convert_input_keys) ||
+                      Transcriber.configuration.convert_input_keys)
       end
     end
   end

data/lib/transcriber/resource/key/href.rb

@@ -0,0 +1,11 @@
+module Transcriber
+  class Resource
+    class Href < Key
+      include Response::Href
+
+      def initialize
+        super(:href)
+      end
+    end
+  end
+end

data/lib/transcriber/resource/parser.rb

@@ -1,8 +1,14 @@
 module Transcriber
   class Resource
     module Parser
+      def parse!(input, options = {})
+        parse(input, options.merge(fail: true))
+      end
+
       def parse(input, options = {})
-        prepare_entries(input, options).collect &method(:parse_item)
+        prepare_entries(input, options).collect do |item|
+          parse_item(item, options)
+        end
       end
 
       private
@@ -12,11 +18,15 @@ module Transcriber
         Array.wrap digg(input, path)
       end
 
-      def parse_item(item)
+      def parse_item(item, options)
         self.new.tap do |resource|
           keys.each do |key|
             value = digg(item, key.input_path)
-            resource.__send__("#{key.name}=", key.parse(value, resource)) if key.present?(resource)
+            begin
+              resource.__send__("#{key.name}=", key.parse(value, resource)) if key.present?(resource)
+            rescue => exception
+              raise exception if options[:fail]
+            end
           end
         end
       end

data/lib/transcriber/resource/response.rb

@@ -1,12 +1,44 @@
 module Transcriber
   class Resource
     module Response
-      def normalize(model, options = {})
-        model.kind_of?(Enumerable) ?
-          {entries: model.map(&:resource)}
-         : model.resource
+      extend ActiveSupport::Concern
+
+      def resource(options = {})
+        root = options.fetch(:root, true)
+        {}.tap do |resource|
+          resource_keys(options).inject(resource) do |buffer, key|
+            buffer.merge!(key.to_resource(self))
+          end
+          resource.merge!({link: link}) if root and self.class.relations.any?
+        end
+      end
+
+      def link
+        self.class.relations.map {|key| key.to_relation(self)}
+      end
+
+      def resource_keys(options)
+        return self.class.keys unless summarize?(options)
+        self.class.summarized_keys + [Resource::Href.new]
+      end
+
+      def summarize?(options)
+        options[:summarize] and self.class.summarized_keys.any?
+      end
+
+      module ClassMethods
+        def normalize(model, options = {})
+          model.kind_of?(Enumerable) ?
+            {entries: model.map {|m| m.resource(options.merge(summarize: true))}}
+           : model.resource(options)
+        end
+
+        alias :resources :normalize
+
+        def transcribe(input, options = {})
+          normalize(parse(input, options), options)
+        end
       end
-      alias :resources :normalize
     end
   end
 end

data/lib/transcriber/resource/response/href.rb

@@ -0,0 +1,12 @@
+module Transcriber
+  class Resource
+    module Response
+      module Href
+        def to_resource(parent)
+          id_key = parent.class.id_key.name
+          {name => "#{Transcriber.host}/#{parent.class.resource_name}/#{parent.send(id_key)}"}
+        end
+      end
+    end
+  end
+end

data/lib/transcriber/resource/response/relation.rb

@@ -9,7 +9,7 @@ module Transcriber
         end
 
         def to_relation(parent)
-          {:rel => name, :href => href(parent)}
+          {rel: name, href: href(parent)}
         end
 
         private
@@ -29,9 +29,10 @@ module Transcriber
         end
 
         def href(parent)
+          id_key = parent.class.id_key.name
           has? ?
-            "/#{parent.class.resource_name}/#{parent.id}/#{relation_name(parent)}"
-          : "/#{relation_name(parent).to_s.pluralize}/#{parent.id}/#{parent.class.resource_name}"
+            "#{Transcriber.host}/#{parent.class.resource_name}/#{parent.send(id_key)}/#{relation_name(parent)}"
+          : "#{Transcriber.host}/#{relation_name(parent).to_s.pluralize}/#{parent.send(id_key)}/#{parent.class.resource_name}"
         end
       end
     end

data/lib/transcriber/version.rb

@@ -1,3 +1,3 @@
 module Transcriber
-  VERSION = "0.0.3"
+  VERSION = "0.0.4"
 end

data/spec/integration/embeds_many_spec.rb

@@ -0,0 +1,50 @@
+require 'spec_helper'
+
+describe_example 'embeds_many/simple' do
+  it 'parses first embedded item' do
+    root.items[0].id.should == 2000
+  end
+
+  it 'parses second embedded item' do
+    root.items[1].id.should == 2001
+  end
+end
+
+
+describe_example 'embeds_many/invisible' do
+  it 'parses invisible item correctly' do
+    root.locale.should == 'pt-BR'
+  end
+
+  it "doesn't show embedded items in resource" do
+    root.resource.should_not have_key('locale')
+  end
+end
+
+describe_example 'embeds_many/with_class_name' do
+  it 'parses embedded item' do
+    root.items[0].id.should == 2000
+  end
+end
+
+describe_example 'embeds_many/with_if' do
+  context 'when an embeddable has a conditional proc (:if)' do
+    context 'and it evaluates to true' do
+      it 'parses embedded item' do
+        root_with_items.items.first.id.should == "2000"
+      end
+    end
+
+    context 'and it evaluates to false' do
+      it "doesn't parse embedded item" do
+        root_without_items.items.should_not be
+      end
+    end
+  end
+end
+
+describe_example 'embeds_many/with_start_key' do
+  it 'parses embedded items' do
+    root.items.first.id.should == "2000"
+  end
+end

data/spec/integration/embeds_one_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+
+describe_example "embeds_one/simple" do
+  it 'parses embedded item' do
+    root.item.id.should == "2000"
+  end
+end
+
+describe_example "embeds_one/with_class_name" do
+  context 'when a different class name is used for embeddable' do
+    it 'parses embedded item' do
+      root.item.id.should == "2000"
+    end
+  end
+end
+
+describe_example "embeds_one/with_if" do
+  context 'when an embeddable has a conditional proc (:if)' do
+    context 'and it evaluates to true' do
+      it 'parses embedded item' do
+        root_with_item.id.should == "1"
+        root_with_item.item.id.should == "2000"
+      end
+    end
+
+    context 'and it evaluates to false' do
+      it "doesn't parse embedded item" do
+        root_without_item.id.should == "100"
+        root_without_item.item.should_not be
+      end
+    end
+  end
+end
+
+describe_example "embeds_one/with_start_key" do
+  context 'when there is a start key to parse input' do
+    it 'parses embedded item' do
+      root.item.id.should == "2000"
+    end
+  end
+end

data/spec/integration/has_many_spec.rb

@@ -1,9 +1,27 @@
 require 'spec_helper'
 
-describe "has many" do
-  context_from_example "has_many/simple" do
-    it "sets root" do
-      root.resource.should be_a(Hash)
+describe_example "has_many/simple" do
+  it 'parses properly' do
+    root.id.should == 123
+    root.login.should == 'jackiechan2010'
+  end
+
+  describe "#resource" do
+    subject {root.resource}
+
+    it 'has a link' do
+      subject[:link].should be_an(Array)
+    end
+
+    [:services, :billing, :devops].each do |rel|
+      it "has a #{rel} relation" do
+        subject[:link].any? {|l| l[:rel] == rel}.should be_true
+      end
+
+      it "has a href for #{rel} relation" do
+        link = subject[:link].find {|l| l[:rel] == rel}
+        link[:href].should =~ %r{/customers/123/#{rel}}
+      end
     end
   end
 end

data/spec/integration/property_spec.rb

@@ -0,0 +1,69 @@
+require 'spec_helper'
+
+def it_parses_property
+  it 'parses property' do
+    root.login.should == 'jackiechan2010'
+  end
+end
+
+describe_example 'properties/simple' do
+  it_parses_property
+end
+
+describe_example 'properties/with_field' do
+  context 'when input has a different name for the property' do
+    it_parses_property
+  end
+end
+
+describe_example 'properties/with_field_path' do
+  context 'when input has a different path for the property' do
+    it_parses_property
+  end
+end
+
+describe_example 'properties/with_id' do
+  context 'when property is an id' do
+    it 'parses id' do
+      root.id.should == "2000"
+    end
+  end
+end
+
+describe_example 'properties/with_if' do
+  context 'when a property has a conditional proc (:if)' do
+    context 'and it evaluates to true' do
+      it 'parses property' do
+        root_with_description.description.should == "description"
+      end
+    end
+
+    context 'and it evaluates to false' do
+      it "doesn't parse property" do
+        root_without_description.description.should_not be
+      end
+    end
+  end
+end
+
+describe_example 'properties/with_key_converter' do
+  after do
+    Transcriber.configure do |c|
+      c.convert_input_keys = nil
+    end
+  end
+
+  context 'when a diferent key converter is configured on transcriber' do
+    it_parses_property
+  end
+end
+
+describe_example 'properties/with_two_key_converters' do
+  context 'when key converters are configured for each class' do
+    it_parses_property
+
+    it 'parses other property with different key converter' do
+      root.product.unit_price.should == 29.9
+    end
+  end
+end

data/spec/integration/summarization_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+
+describe_example 'summarization/simple' do
+
+  subject {root[:entries].first}
+
+  it 'summarizes resources' do
+    subject.keys.count.should == 3
+    subject[:id].should    == '138911938'
+    subject[:login].should == 'jackiechan2010'
+    subject[:href].should  == 'http://example.com/customers/138911938'
+  end
+end

data/spec/spec_helper.rb

@@ -10,7 +10,7 @@ require 'support/examples'
 require 'support/out'
 
 RSpec.configure do |config|
-  config.before(:each) do
+  config.before do
     [:Example, :ExampleChild].each do |klass|
       Object.send(:remove_const, klass) if Object.const_defined? klass
     end
@@ -20,3 +20,7 @@ end
 include Transcriber
 include Output
 include Examples
+
+Transcriber.configure do |c|
+  c.host = 'http://example.com'
+end

data/spec/support/examples.rb

@@ -1,6 +1,10 @@
 module Examples
-  def context_from_example(file, &block)
-    context "example #{file}" do
+  def describe_example(file, &block)
+    describe "example #{file}" do
+      [:Root, :Item, :Customer, :Entry].each do |klass|
+        Examples.send(:remove_const, klass) if Examples.const_defined?(klass)
+      end
+
       silently {eval File.read("examples/#{file}.rb")}
 
       variables = instance_variables.reject {|var| var.to_s =~ /metadata$/}

data/spec/unit/input_path_spec.rb

@@ -53,13 +53,7 @@ describe Resource::InputPath do
     end
 
     context "and there is a custom keys input converter" do
-      let(:options) do
-        {
-          start_key:          'yay.upcase.path',
-          convert_input_keys: Upcasing
-        }
-      end
-
+      let(:options) {{start_key: 'yay.upcase.path', convert_input_keys: Upcasing}}
       subject {Resource::Key.new(:name, options)}
       let(:path) {['YAY', 'UPCASE', 'PATH']}
       it_behaves_like "an input path"

data/spec/unit/resource/response/relation_spec.rb

@@ -44,7 +44,7 @@ describe Resource::Response do
     subject {Example.keys[1]}
 
     let(:example) {Example.new(id: 100)}
-    let(:result)  {{rel: :example_child, href: "/examples/100/example_child"}}
+    let(:result)  {{rel: :example_child, href: "http://example.com/examples/100/example_child"}}
 
     it_behaves_like "a relation"
   end
@@ -65,7 +65,7 @@ describe Resource::Response do
     subject {Example.keys[1]}
 
     let(:example) {Example.new(id: 200)}
-    let(:result)  {{rel: :example_children, href: "/examples/200/example_children"}}
+    let(:result)  {{rel: :example_children, href: "http://example.com/examples/200/example_children"}}
 
     it_behaves_like "a relation"
   end
@@ -86,7 +86,7 @@ describe Resource::Response do
     subject {ExampleChild.keys[1]}
 
     let(:example) {ExampleChild.new(id: 200)}
-    let(:result)  {{rel: :example, href: "/examples/200/example_children"}}
+    let(:result)  {{rel: :example, href: "http://example.com/examples/200/example_children"}}
 
     it_behaves_like "a relation"
   end

data/spec/unit/resource_spec.rb

@@ -17,7 +17,7 @@ describe Resource do
   end
 
   context "when using not allowed names" do
-    [:resource_id, :resource, :links].each do |unallowed|
+    [:resource_id, :resource, :link].each do |unallowed|
       it "warns when method #{unallowed} is redefined" do
         output = out do
           eval <<-RUBY

data/transcriber.gemspec

@@ -18,7 +18,7 @@ Gem::Specification.new do |s|
   s.require_paths = ["lib"]
 
   s.add_dependency "activesupport", "~> 3.0"
-  s.add_dependency "i18n",          "~> 0.6"
+  s.add_dependency "i18n",          ">= 0.5"
   s.add_development_dependency "rspec",       "~> 2.6"
   s.add_development_dependency "guard",       "~> 0.5"
   s.add_development_dependency "guard-rspec", "~> 0.4"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: transcriber
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
   prerelease: 
 platform: ruby
 authors:
@@ -11,11 +11,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-08-15 00:00:00.000000000Z
+date: 2011-08-23 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
-  requirement: &70342384534920 !ruby/object:Gem::Requirement
+  requirement: &70173958045380 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -23,21 +23,21 @@ dependencies:
         version: '3.0'
   type: :runtime
   prerelease: false
-  version_requirements: *70342384534920
+  version_requirements: *70173958045380
 - !ruby/object:Gem::Dependency
   name: i18n
-  requirement: &70342384534420 !ruby/object:Gem::Requirement
+  requirement: &70173958044880 !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ~>
+    - - ! '>='
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.5'
   type: :runtime
   prerelease: false
-  version_requirements: *70342384534420
+  version_requirements: *70173958044880
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70342384533960 !ruby/object:Gem::Requirement
+  requirement: &70173958044420 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -45,10 +45,10 @@ dependencies:
         version: '2.6'
   type: :development
   prerelease: false
-  version_requirements: *70342384533960
+  version_requirements: *70173958044420
 - !ruby/object:Gem::Dependency
   name: guard
-  requirement: &70342384533500 !ruby/object:Gem::Requirement
+  requirement: &70173958043920 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -56,10 +56,10 @@ dependencies:
         version: '0.5'
   type: :development
   prerelease: false
-  version_requirements: *70342384533500
+  version_requirements: *70173958043920
 - !ruby/object:Gem::Dependency
   name: guard-rspec
-  requirement: &70342384533040 !ruby/object:Gem::Requirement
+  requirement: &70173958043460 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -67,10 +67,10 @@ dependencies:
         version: '0.4'
   type: :development
   prerelease: false
-  version_requirements: *70342384533040
+  version_requirements: *70173958043460
 - !ruby/object:Gem::Dependency
   name: growl
-  requirement: &70342384532580 !ruby/object:Gem::Requirement
+  requirement: &70173958043000 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -78,7 +78,7 @@ dependencies:
         version: '1.0'
   type: :development
   prerelease: false
-  version_requirements: *70342384532580
+  version_requirements: *70173958043000
 description: ''
 email:
 - victorcrodrigues@gmail.com
@@ -104,12 +104,15 @@ files:
 - examples/embeds_one/with_if.rb
 - examples/embeds_one/with_start_key.rb
 - examples/has_many/simple.rb
+- examples/properties/collections.rb
 - examples/properties/simple.rb
 - examples/properties/with_field.rb
 - examples/properties/with_field_path.rb
 - examples/properties/with_id.rb
 - examples/properties/with_if.rb
 - examples/properties/with_key_converter.rb
+- examples/properties/with_two_key_converters.rb
+- examples/summarization/simple.rb
 - lib/transcriber.rb
 - lib/transcriber/configuration.rb
 - lib/transcriber/resource.rb
@@ -123,6 +126,7 @@ files:
 - lib/transcriber/resource/key.rb
 - lib/transcriber/resource/key/association.rb
 - lib/transcriber/resource/key/embeddable.rb
+- lib/transcriber/resource/key/href.rb
 - lib/transcriber/resource/key/property.rb
 - lib/transcriber/resource/key/relation.rb
 - lib/transcriber/resource/parser.rb
@@ -130,6 +134,7 @@ files:
 - lib/transcriber/resource/parser/property.rb
 - lib/transcriber/resource/response.rb
 - lib/transcriber/resource/response/embeddable.rb
+- lib/transcriber/resource/response/href.rb
 - lib/transcriber/resource/response/property.rb
 - lib/transcriber/resource/response/relation.rb
 - lib/transcriber/resource/serialization/boolean.rb
@@ -138,8 +143,11 @@ files:
 - lib/transcriber/resource/serialization/integer.rb
 - lib/transcriber/resource/serialization/string.rb
 - lib/transcriber/version.rb
+- spec/integration/embeds_many_spec.rb
+- spec/integration/embeds_one_spec.rb
 - spec/integration/has_many_spec.rb
 - spec/integration/property_spec.rb
+- spec/integration/summarization_spec.rb
 - spec/spec_helper.rb
 - spec/support/examples.rb
 - spec/support/out.rb
@@ -194,8 +202,11 @@ signing_key:
 specification_version: 3
 summary: ''
 test_files:
+- spec/integration/embeds_many_spec.rb
+- spec/integration/embeds_one_spec.rb
 - spec/integration/has_many_spec.rb
 - spec/integration/property_spec.rb
+- spec/integration/summarization_spec.rb
 - spec/spec_helper.rb
 - spec/support/examples.rb
 - spec/support/out.rb