restfulie 0.8.1 → 0.9.1

data/Gemfile

@@ -23,4 +23,6 @@ group :test do
   gem "sinatra"
 	gem "state_machine"
   gem "test-unit", "= 1.2.3"
+	gem "rails", "= 2.3.5"
+	gem "fakeweb"
 end  

data/README.textile

@@ -1,7 +1,7 @@
 h1. Web site
 
-Restfulie's website can be found at "http://restfulie.caelum.com.br":http://restfulie.caelum.com.br
-Mikyung's, a REST agent framework built on top of Restfulie can be seen at "http://github.com/caelum/mikyung":http://github.com/caelum/mikyung.
+Restfulie's website can be found at "http://restfulie.caelumobjects.com":http://restfulie.caelumobjects.com
+From there you can see some videos and read the "Restfulie from Scratch guide":http://restfulie.caelumobjects.com/caelumobjects-restful-rails.pdf.
 
 h1. Quit pretending
 
@@ -17,15 +17,6 @@ h2. Why would I use restfulie?
 #  HATEOAS --> consumed resources will not affect your software whenever they change their flow
 #  Adaptability --> clients are able to adapt to your changes
  
-h2. Documentation
-
-Appart from the simple server and client examples provided here, you can find the following links useful:
-
-* "RDocs":http://rdoc.info/projects/caelum/restfulie
-* "Official website":http://restfulie.caelumobjects.com
-* "How-tos":http://restfulie.caelumobjects.com/rails
-* "Buying through Rest: Rest to the enterprise (video)":guilhermesilveira.wordpress.com/2010/04/13/buying-through-rest-applying-rest-to-the-enterprise/
-
 h2. Simple server example
 
 In the server side, all you need to do is notify inherited_resources which media types you are able to represent your resource:
@@ -75,11 +66,20 @@ puts receipt.id
 
 In order to create a full REST client, "watch this video":http://guilhermesilveira.wordpress.com.
 
-h2. Download source example
+h2. Full examples
 
 You can view an entire application running Restfulie under *spec/integration/order/server* and *spec/integration/order/client* in this git repository.
 
-"You can also download a full example of a REST based agent and server":http://github.com/caelum/mikyung using Restfulie and Mikyung, according to the Rest Architecture Maturity Model.
+"You can also download a full example of a REST based agent and server":http://github.com/caelum/full-restfulie-examples using Restfulie, according to the Rest Architecture Maturity Model.
+
+h2. Documentation
+
+Appart from the simple server and client examples provided here, you can find the following links useful:
+
+* "RDocs":http://rdoc.info/projects/caelum/restfulie
+* "Official website":http://restfulie.caelumobjects.com
+* "How-tos":http://restfulie.caelumobjects.com/caelumobjects-restful-rails.pdf
+* "Buying through Rest: Rest to the enterprise (video)":http://guilhermesilveira.wordpress.com/2010/04/13/buying-through-rest-applying-rest-to-the-enterprise/
 
 h2. Installing
 
@@ -114,3 +114,25 @@ try {
 var pageTracker = _gat._getTracker("UA-11770776-1");
 pageTracker._trackPageview();
 } catch(err) {}</script>
+
+h2. Contributions
+
+Restfulie was created and is maintained by "http://caelumobjects.com":Caelum, and has received enormous contributions from all those developers:
+
+Project Leader
+Guilherme Silveira, "http://caelum.com.br":Caelum
+
+Caue Guerra, caelum
+George Guimaraes, abril and plataforma
+Fabio Akita
+Diego Carrion
+Leandro Silva
+Gavin-John Noonan
+Antonio Marques
+Luis Cipriani, abril
+Everton Ribeiro, abril
+Paulo Ahagon, abril
+Elomar França
+Thomas Stefano
+"http://www.caelum.com.br":"David Paniz"
+"http://www.caikesouza.com/blog":Caike Souza

data/Rakefile

@@ -15,7 +15,6 @@ AUTHOR   = "Guilherme Silveira, Caue Guerra, Luis Cipriani, Everton Ribeiro, Geo
 EMAIL    = "guilherme.silveira@caelum.com.br"
 HOMEPAGE = "http://restfulie.caelumobjects.com"
 
-
 spec = Gem::Specification.new do |s|
   s.name = GEM
   s.version = GEM_VERSION
@@ -34,22 +33,40 @@ spec = Gem::Specification.new do |s|
   s.homepage = HOMEPAGE
 end
 
-namespace :test do
-  def execute_process(name)
-    sh "ruby ./spec/units/client/#{name}.rb &"
-    sleep 15
-    %x(ps -ef | grep #{name}).split[1]  
-  end
-  def process(name)
-    %x(ps -ef | grep #{name} | grep -v grep).split[1] || execute_process(name)
-  end
-  def start_server_and_invoke_test(task_name)
-    pid = process "fake_server"
-    puts "fake_server pid >>>> #{pid}"
+# optionally loads a task if the required gems exist
+def optionally
+  begin
+    yield
+  rescue LoadError; end
+end
+
+def start_server_and_invoke_test(task_name)
+  IO.popen("ruby ./spec/units/client/fake_server.rb") do |pipe|
+    wait_server(4567)
     Rake::Task[task_name].invoke
-    sh "kill -9 #{pid}"
+    Process.kill 'INT', pipe.pid
   end
+end
+
+def wait_server(port=3000)
+  (1..15).each do 
+    begin
+      Net::HTTP.get(URI.parse("http://localhost:#{port}/"))
+      return
+    rescue
+      sleep 1
+    end
+  end
+  raise "Waited for the server but it did not finish"
+end
 
+desc 'Start server'
+task :server do
+  process 'fake_server' 
+end
+
+namespace :test do
+  
   desc "Execute integration Order tests"
   task :integration do
     integration_path = "spec/integration/order/server"
@@ -99,6 +116,7 @@ namespace :test do
       start_server_and_invoke_test('test:spec:all')
       puts "Execution integration tests... (task test:integration)"
       Rake::Task["test:integration"].invoke()
+      Rake::Task["test:examples"].invoke()
     end
     task :common do
       start_server_and_invoke_test('test:spec:common')
@@ -113,6 +131,22 @@ namespace :test do
       start_server_and_invoke_test('test:rcov:rcov')
     end
   end
+
+  desc "runs all example tests"
+  task :examples do
+    Rake::Task["install"].invoke()
+
+    target_dir = "full-examples/rest_from_scratch/part_3"
+    system "cd #{target_dir} && rake db:reset db:seed"
+
+    IO.popen("ruby #{target_dir}/script/server") do |pipe|
+      wait_server
+      system "cd #{target_dir} && rake spec"
+      Process.kill 'INT', pipe.pid
+    end
+
+  end
+
 end
 
 Rake::GemPackageTask.new(spec) do |pkg|
@@ -121,16 +155,14 @@ end
 
 Rake::RDocTask.new("rdoc") do |rdoc|
    rdoc.options << '--line-numbers' << '--inline-source'
-#   rdoc.rdoc_files.include('lib/**/**/*.rb')
 end
 
-begin
+optionally do
   require 'yard'
   YARD::Rake::YardocTask.new do |t|
-    t.files   = ['lib/restfulie/**/*.rb', 'README.textile']   # optional
-    # t.options = ['--any', '--extra', '--opts'] # optional
+    t.files   = ['lib/restfulie/**/*.rb', 'README.textile']
   end
-rescue LoadError; end
+end
 
 desc "Install the gem locally"
 task :install => [:package] do

data/lib/restfulie.rb

@@ -7,7 +7,8 @@ require 'restfulie/server'
 # Shortcut to Restfulie::Client::EntryPoint
 module Restfulie
   extend Restfulie::Client::EntryPoint
-  
+
+  # creates a new entry point for executing requests
   def self.at(uri)
     Object.new.send(:extend, Restfulie::Client::EntryPoint).at(uri)
   end

data/lib/restfulie/client.rb

@@ -7,6 +7,13 @@ module Restfulie
     autoload :EntryPoint, 'restfulie/client/entry_point'
     autoload :Base, 'restfulie/client/base'
     autoload :Mikyung, 'restfulie/client/mikyung'
+    autoload :Cache, 'restfulie/client/cache'
+    
+    mattr_accessor :cache_provider, :cache_store
+
+    Restfulie::Client.cache_store = ActiveSupport::Cache::MemoryStore.new
+    Restfulie::Client.cache_provider = Restfulie::Client::Cache::Basic.new
+
   end
 end
 

data/lib/restfulie/client/cache.rb

@@ -0,0 +1,11 @@
+module Restfulie
+  module Client
+    module Cache
+      autoload :Basic, 'restfulie/client/cache/basic'
+      autoload :Fake, 'restfulie/client/cache/fake'
+      autoload :Restrictions, 'restfulie/client/cache/restrictions'
+    end
+  end
+end
+require 'restfulie/client/cache/http_ext'
+

data/lib/restfulie/client/cache/basic.rb

@@ -0,0 +1,75 @@
+# Basic cache implementation for restfulie.
+#
+# It uses the request headers and uri to store it in memory.
+# This cache might not be optimal for long running clients, which should use a memcached based one.
+# Use Restfulie::Client.cache_provider to change the provider
+module Restfulie::Client::Cache
+  class Basic
+
+    def put(key, req, response)
+      if Restfulie::Client::Cache::Restrictions.may_cache?(response)
+        Restfulie::Common::Logger.logger.debug "caching #{key} #{response}"
+        cache_add(key, req, response)
+      end
+      response
+    end
+
+    def get(key, request, verb)
+
+      # debugger
+      response = cache_get(key, request, verb)
+      return nil if response.nil?
+
+      if response.has_expired_cache?
+        remove(key)
+      else
+        Restfulie::Common::Logger.logger.debug "RETURNING cache #{key}"
+        cache_hit response
+      end
+
+    end
+    
+    # removes all elements from the cache
+    def clear
+      cache.clear
+    end
+
+  private
+
+    # allows response enhancement when the cache was hit with it
+    def cache_hit(response)
+      response
+    end
+
+    def cache_add(key, req, response)
+      values = (cache.read(key) || []).dup
+      values << [req, response]
+      cache.write(key, values)
+    end
+
+    def cache_get(key, req, verb)
+      return nil unless cache.exist?(key)
+      found = cache.read(key).find do |cached|
+        old_req = cached.first
+        old_response = cached.last
+        if old_response.vary_headers_for(old_req) == old_response.vary_headers_for(req) &&
+          old_response.method == verb
+          old_response
+        else
+          false
+        end
+      end
+      found ? found.last : nil
+    end
+
+    def remove(key)
+      cache.delete(key)
+      nil
+    end
+
+    def cache
+      Restfulie::Client.cache_store
+    end
+
+  end
+end

data/lib/restfulie/client/cache/fake.rb

@@ -0,0 +1,15 @@
+# Fake cache that does not cache anything
+# Use Restfulie::Client.cache_provider = Restfulie::Client::Cache::Fake.new
+module Restfulie::Client::Cache
+  class Fake
+    def put(url, req, response)
+      response
+    end
+
+    def get(url, req)
+    end
+
+    def clear
+    end
+  end
+end

data/lib/restfulie/client/cache/http_ext.rb

@@ -0,0 +1,121 @@
+require 'time'
+
+# an extesion to http responses
+module Restfulie::Client::HTTP::ResponseStatus
+  
+  attr_accessor :previous
+        
+  # determines if this response code was successful (according to http specs: 200~299)
+  def is_successful?
+    code.to_i >= 200 && code.to_i <= 299
+  end
+    
+  # determines if this response code was successful (according to http specs: 100~199)
+  def is_informational?
+    code.to_i >= 100 && code.to_i <= 199
+  end
+    
+  # determines if this response code was successful (according to http specs: 300~399)
+  def is_redirection?
+    code.to_i >= 300 && code.to_i <= 399
+  end
+    
+  # determines if this response code was successful (according to http specs: 400~499)
+  def is_client_error?
+    code.to_i >= 400 && code.to_i <= 499
+  end
+    
+  # determines if this response code was successful (according to http specs: 500~599)
+  def is_server_error?
+    code.to_i >= 500 && code.to_i <= 599
+  end
+  
+  def etag
+    self['Etag']
+  end
+
+  def last_modified
+    self['Last-Modified']
+  end
+  
+end
+  
+module Restfulie::Client::HTTP::ResponseCacheCheck
+
+  def cache_max_age
+    val = header_value_from('cache-control', /^\s*max-age=(\d+)/)
+    if val
+      val.to_i
+    else
+      0
+    end
+  end
+  
+  def header_value_from(header, expression)
+    h = value_for(headers[header], expression)
+    return nil if h.nil?
+    h.match(expression)[1]
+  end
+  
+  def has_expired_cache?
+    return true if headers['date'].nil?
+    max_time = Time.rfc2822(headers['date']) + cache_max_age.seconds
+    Time.now > max_time
+  end
+
+  # checks if the header's max-age is available and no no-store if available.
+  def may_cache?
+    may_cache_field?(headers['cache-control'])
+  end
+  
+  # Returns whether this cache control field allows caching
+  #
+  # may_cache_field(['max-age=2000', 'no-store']) == false
+  # may_cache_field('max-age=2000,no-store') == false
+  # may_cache_field('max-age=2000') == true
+  def may_cache_field?(field)
+    return false if field.nil?
+    
+    if field.kind_of? Array
+      field.each do |f|
+        return false if !may_cache_field?(f)
+      end
+      return true
+    end
+
+    max_age_header = value_for(field, /^max-age=(\d+)/)
+    return false if max_age_header.nil?
+    
+    if value_for(field, /^no-store/)
+      false
+    else
+      true
+    end
+  end
+
+  # extracts the header value for an specific expression, which can be located at the start or in the middle
+  # of the expression
+  def value_for(value, expression)
+    value.split(",").find { |obj| obj.strip =~ expression }
+  end
+  
+  # extracts all header values related to the Vary header from this response, in order
+  # to implement Vary support from the HTTP Specification
+  # 
+  # example
+  # if the response Vary header is 'Accept','Accept-Language', we have
+  # vary_headers_for({'Accept'=>'application/xml', 'Date' =>'...', 'Accept-Language'=>'de'}) == ['application/xml', 'de']
+  # vary_headers_for({'Date' => '...', 'Accept-Language'=>'de'}) == [nil, 'de']
+  def vary_headers_for(request)
+    return nil if headers['vary'].nil?
+    headers['vary'].split(',').map do |key|
+      request[key.strip]
+    end
+  end
+    
+end
+
+class Restfulie::Client::HTTP::Response
+  include Restfulie::Client::HTTP::ResponseStatus
+  include Restfulie::Client::HTTP::ResponseCacheCheck
+end

data/lib/restfulie/client/cache/restrictions.rb

@@ -0,0 +1,18 @@
+module Restfulie::Client::Cache
+  module Restrictions
+    class << self
+
+      # checks whether this request verb and its cache headers allow caching
+      def may_cache?(response)
+        may_cache_method?(response.method) && response.may_cache?
+      end
+
+      # only Post and Get requests are cacheable so far
+      def may_cache_method?(verb)
+        verb == :get || verb == :post
+      end
+
+    end
+
+  end
+end

data/lib/restfulie/client/http/link_request_builder.rb

@@ -3,6 +3,7 @@ module Restfulie
     module HTTP
       module LinkRequestBuilder
         include RequestMarshaller
+        include RequestFollow
 
         def path#:nodoc:
           at(href)

data/lib/restfulie/client/http/request_adapter.rb

@@ -125,7 +125,7 @@ module Restfulie
         def request(method, path, *args)
           request!(method, path, *args) 
         rescue Error::RESTError => se
-          se.response
+          [[@host, path], nil, se.response]
         end
 
         # Executes a request against your server and return a response instance.
@@ -142,14 +142,18 @@ module Restfulie
 
           ::Restfulie::Common::Logger.logger.info(request_to_s(method, path, *args)) if ::Restfulie::Common::Logger.logger
           begin
-            response = ResponseHandler.handle(method, path, get_connection_provider.send(method, path, *args))
+            http_request = get_connection_provider
+            response = Restfulie::Client.cache_provider.get([@host, path], http_request, method)
+            return [[@host, path], http_request, response] if response
+            response = ResponseHandler.handle(method, path, http_request.send(method, path, *args))
           rescue Exception => e
+            Restfulie::Common::Logger.logger.error(e)
             raise Error::ServerNotAvailableError.new(self, Response.new(method, path, 503, nil, {}), e )
           end 
 
           case response.code
           when 100..299
-            response 
+            [[@host, path], http_request, response]
           when 300..399
             raise Error::Redirection.new(self, response)
           when 400

data/lib/restfulie/client/http/request_builder.rb

@@ -1,3 +1,5 @@
+require 'uri'
+
 module Restfulie
   module Client
     module HTTP #:nodoc:
@@ -48,8 +50,8 @@ module Restfulie
           host.path
         end
 
-        def get
-          request(:get, path, headers)
+        def get(params = {})
+          request(:get, add_querystring(path, params), headers)
         end
 
         def head
@@ -71,9 +73,9 @@ module Restfulie
         def delete
           request(:delete, path, headers)
         end
-
-        def get!
-          request!(:get, path, headers)
+        
+        def get!(params = {})
+          request!(:get, add_querystring(path, params), headers)
         end
 
         def head!
@@ -97,6 +99,11 @@ module Restfulie
         end
 
         protected
+        
+        def add_querystring(path, params)
+          params = params.map { |param, value| "#{param}=#{value}"}.join("&")
+          params.blank? ? path : URI.escape("#{path}?#{params}")
+        end
 
         def headers=(h)
           @headers = h

data/lib/restfulie/client/http/request_history.rb

@@ -14,12 +14,14 @@ module Restfulie
       module RequestHistory
         include RequestBuilder
 
-        attr_accessor_with_default :max_to_remind, 10
-
         def snapshots
           @snapshots ||= []
         end
 
+        def max_to_remind
+          10
+        end
+        
         def request!(method=nil, path=nil, *args)#:nodoc:
           if method == nil || path == nil 
             raise 'History not selected' unless @snapshot
@@ -37,7 +39,7 @@ module Restfulie
         def request(method=nil, path=nil, *args)#:nodoc:
           request!(method, path, *args) 
         rescue Error::RESTError => se
-          se.response
+          [[@host, path], nil, se.response]
         end
 
         def history(number)

data/lib/restfulie/client/http/request_marshaller.rb

@@ -60,7 +60,9 @@ module Restfulie
             args = add_representation_headers(method, path, unmarshaller, *args)
           end
     
-          response = super(method, path, *args) 
+          key, req, response = super(method, path, *args) 
+          Restfulie::Client.cache_provider.put(key, req, response)
+
           parse_response(response)
         end
     

data/lib/restfulie/common/representation.rb

@@ -4,7 +4,7 @@ module Restfulie
       autoload :Atom, 'restfulie/common/representation/atom'
       autoload :Generic, 'restfulie/common/representation/generic'
       autoload :Json, 'restfulie/common/representation/json'
-      autoload :XmlD, 'restfulie/common/representation/xml'
+      autoload :Links, 'restfulie/common/representation/links'
     end
   end
 end

data/lib/restfulie/common/representation/atom/base.rb

@@ -63,7 +63,16 @@ module Restfulie
           def updated=(value)
             set_text("updated", value)
           end
-      
+
+          def published
+            value = text("published")
+            Time.parse(value) unless value.nil?
+          end
+
+          def published=(value)
+            set_text("published", value)
+          end
+
           # text
           def rights
             text("rights")

data/lib/restfulie/common/representation/links.rb

@@ -0,0 +1,11 @@
+module Restfulie
+  module Common
+    module Representation
+      module Links
+        def self.extract_link_header(links)
+          links.collect {|link| "<#{link.href}>; rel=#{link.rel}"}.join(', ')
+        end
+      end
+    end
+  end
+end

data/lib/restfulie/server.rb

@@ -12,3 +12,9 @@ end
 
 require 'restfulie/server/core_ext'
 Restfulie::Server::ActionView::TemplateHandlers.activate!
+
+class ActionController::Base
+  def self.restfulie
+    include Restfulie::Server::ActionController::Base
+  end
+end

data/lib/restfulie/server/action_controller.rb

@@ -3,6 +3,8 @@ module Restfulie
     module ActionController #:nodoc:
       if defined?(::ActionController) || defined?(::ApplicationController)
         autoload :ParamsParser, 'restfulie/server/action_controller/params_parser'
+        autoload :CacheableResponder, 'restfulie/server/action_controller/cacheable_responder'
+        autoload :CreatedResponder, 'restfulie/server/action_controller/created_responder'
         autoload :RestfulResponder, 'restfulie/server/action_controller/restful_responder'
         autoload :Base, 'restfulie/server/action_controller/base'
       end

data/lib/restfulie/server/action_controller/base.rb

@@ -25,7 +25,7 @@ module Restfulie
           end
 
           def include_restfulie?
-            defined?(Restfulie::Server::ActionController::Base) && controller_class_name.constantize.include?(Restfulie::Server::ActionController::Base)
+            defined?(Restfulie::Server::ActionController::Base) && self.include?(Restfulie::Server::ActionController::Base)
           end
         end
 
@@ -45,9 +45,3 @@ module Restfulie
     end
   end
 end
-
-class ActionController::Base
-  def self.acts_as_restfulie
-    include Restfulie::Server::ActionController::Base
-  end
-end

data/lib/restfulie/server/action_controller/cacheable_responder.rb

@@ -0,0 +1,71 @@
+class Expires
+  def do_http_cache(responder)
+    if responder.options[:expires_in]
+      responder.controller.send :expires_in,responder.options[:expires_in]
+      true
+    else
+      false
+    end
+  end
+end
+
+class LastModifieds
+  # default implementation that will check whether caching can be applied
+  def do_http_cache?(responder)
+    responder.resources.flatten.select do |resource|
+      resource.respond_to?(:updated_at)
+    end &&
+      responder.controller.response.last_modified.nil? &&
+      !new_record?(responder)
+  end
+
+    def do_http_cache(responder)
+      return false unless do_http_cache?(responder)
+      
+      timestamp = responder.resources.flatten.select do |resource|
+        resource.respond_to?(:updated_at)
+      end.map do |resource|
+        (resource.updated_at || Time.now).utc
+      end.max
+
+      responder.controller.response.last_modified = timestamp if timestamp
+    end
+
+    def new_record?(responder)
+      responder.resource.respond_to?(:new_record?) && responder.resource.new_record?
+    end
+    
+end
+
+module Restfulie
+  module Server
+    module ActionController
+      module CacheableResponder
+        
+        CACHES = [::Expires.new, ::LastModifieds.new]
+        
+        def to_format
+          cached = CACHES.inject(false) do |cached, cache|
+            cached || cache.do_http_cache(self)
+          end
+          if ::ActionController::Base.perform_caching && !cached.nil?
+            set_public_cache_control!
+            head :not_modified if fresh = request.fresh?(controller.response)
+            fresh
+          else
+            super
+          end
+        end
+          
+        def set_public_cache_control!
+          cache_control = controller.response.headers["Cache-Control"].split(",").map {|k| k.strip }
+          cache_control.delete("private")
+          cache_control.delete("no-cache")
+          cache_control << "public"
+          controller.response.headers["Cache-Control"] = cache_control.join(', ')
+        end
+
+      end
+    end
+  end
+end

data/lib/restfulie/server/action_controller/created_responder.rb

@@ -0,0 +1,19 @@
+module Restfulie
+  module Server
+    module ActionController
+      
+      # Adds support to answering as a 201 when the resource has been just created
+      module CreatedResponder
+
+        def to_format
+          if [201, :created].include? options[:status]
+            head :status => 201, :location => controller.url_for(resource)
+          else
+            super
+          end
+        end
+
+      end
+    end
+  end
+end

data/lib/restfulie/server/action_controller/restful_responder.rb

@@ -2,45 +2,10 @@ module Restfulie
   module Server
     module ActionController
       class RestfulResponder < ::ActionController::Responder
-        def to_format
-          return if do_http_cache? && do_http_cache!
-          super
-        end
-          
-        protected
-          def do_http_cache!
-            timestamp = resources.flatten.select do |resource|
-              resource.respond_to?(:updated_at)
-            end.map do |resource|
-              (resource.updated_at || Time.now).utc
-            end.max
-      
-            controller.response.last_modified = timestamp if timestamp
-            set_public_cache_control!
-      
-            head :not_modified if fresh = request.fresh?(controller.response)
-            fresh
-          end
-      
-          def do_http_cache?
-            get? && 
-              @http_cache != false && 
-              ::ActionController::Base.perform_caching &&
-              !new_record? && 
-              controller.response.last_modified.nil?
-          end
-      
-          def new_record?
-            resource.respond_to?(:new_record?) && resource.new_record?
-          end
-          
-          def set_public_cache_control!
-            cache_control = controller.response.headers["Cache-Control"].split(",").map {|k| k.strip }
-            cache_control.delete("private")
-            cache_control.delete("no-cache")
-            cache_control << "public"
-            controller.response.headers["Cache-Control"] = cache_control.join(', ')
-        end
+        
+        include CacheableResponder
+        include CreatedResponder
+
       end
     end
   end

data/lib/restfulie/server/action_view/template_handlers/tokamak.rb

@@ -11,10 +11,11 @@ module Restfulie
             "extend Restfulie::Server::ActionView::Helpers; " +
             "code_block = lambda { #{template.source} };" + 
             "builder = code_block.call; " +
+            "self.response.headers['Link'] = Restfulie::Common::Representation::Links.extract_link_header(builder.links) if builder.respond_to?(:links); " +
             "builder.to_s"
           end
         end
       end
     end
   end
-end
+end

data/lib/restfulie/server/core_ext/array.rb

@@ -12,8 +12,9 @@ class Array
     feed = Restfulie::Common::Representation::Atom::Feed.new
     # TODO: Define better feed attributes
     # Array#to_s can return a very long string
-    feed.title = "Collection of #{map {|i| i.class.name }.uniq.to_sentence}"
-    feed.updated = updated_at
+    feed.title      = "Collection of #{map {|i| i.class.name }.uniq.to_sentence}"
+    feed.updated    = updated_at
+    feed.published  = published_at
     # TODO: this id does not comply with Rest standards yet
     feed.id = hash
     
@@ -43,4 +44,8 @@ class Array
   def updated_at(field = :updated_at)
     map { |item| item.send(field) if item.respond_to?(field) }.compact.max || Time.now
   end
+
+  def published_at(field = :published_at)
+    map { |item| item.send(field) if item.respond_to?(field) }.compact.min || Time.now
+  end
 end

data/lib/restfulie/version.rb

@@ -1,7 +1,7 @@
 module Restfulie
   module VERSION #:nodoc:
     MAJOR = 0
-    MINOR = 8
+    MINOR = 9
     TINY  = 1
 
     STRING = [MAJOR, MINOR, TINY].join('.')

metadata

@@ -1,12 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: restfulie
 version: !ruby/object:Gem::Version 
+  hash: 57
   prerelease: false
   segments: 
   - 0
-  - 8
+  - 9
   - 1
-  version: 0.8.1
+  version: 0.9.1
 platform: ruby
 authors: 
 - Guilherme Silveira, Caue Guerra, Luis Cipriani, Everton Ribeiro, George Guimaraes, Paulo Ahagon
@@ -14,16 +15,18 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-06-03 00:00:00 -03:00
+date: 2010-08-22 00:00:00 -03:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: nokogiri
   prerelease: false
   requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 3
         segments: 
         - 1
         - 4
@@ -35,9 +38,11 @@ dependencies:
   name: actionpack
   prerelease: false
   requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 7
         segments: 
         - 2
         - 3
@@ -49,9 +54,11 @@ dependencies:
   name: activesupport
   prerelease: false
   requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 7
         segments: 
         - 2
         - 3
@@ -63,9 +70,11 @@ dependencies:
   name: responders_backport
   prerelease: false
   requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
+        hash: 27
         segments: 
         - 0
         - 1
@@ -77,9 +86,11 @@ dependencies:
   name: json_pure
   prerelease: false
   requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 23
         segments: 
         - 1
         - 2
@@ -97,6 +108,11 @@ extra_rdoc_files: []
 
 files: 
 - lib/restfulie/client/base.rb
+- lib/restfulie/client/cache/basic.rb
+- lib/restfulie/client/cache/fake.rb
+- lib/restfulie/client/cache/http_ext.rb
+- lib/restfulie/client/cache/restrictions.rb
+- lib/restfulie/client/cache.rb
 - lib/restfulie/client/configuration.rb
 - lib/restfulie/client/entry_point.rb
 - lib/restfulie/client/ext/atom_ext.rb
@@ -168,10 +184,12 @@ files:
 - lib/restfulie/common/representation/json/link.rb
 - lib/restfulie/common/representation/json/link_collection.rb
 - lib/restfulie/common/representation/json.rb
-- lib/restfulie/common/representation/xml.rb
+- lib/restfulie/common/representation/links.rb
 - lib/restfulie/common/representation.rb
 - lib/restfulie/common.rb
 - lib/restfulie/server/action_controller/base.rb
+- lib/restfulie/server/action_controller/cacheable_responder.rb
+- lib/restfulie/server/action_controller/created_responder.rb
 - lib/restfulie/server/action_controller/params_parser.rb
 - lib/restfulie/server/action_controller/patch.rb
 - lib/restfulie/server/action_controller/restful_responder.rb
@@ -202,23 +220,27 @@ rdoc_options: []
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.6
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
 summary: Hypermedia aware resource based library in ruby (client side) and ruby on rails (server side).

data/lib/restfulie/common/representation/xml.rb

@@ -1,26 +0,0 @@
-module Restfulie
-  module Common
-    module Representation
-      # Implements the interface for marshal Xml media type requests (application/xml)
-      class XmlD
-        cattr_reader :media_type_name
-        @@media_type_name = 'application/xml'
-    
-        cattr_reader :headers
-        @@headers = { 
-          :post => { 'Content-Type' => media_type_name }
-        }
-    
-        def unmarshal(string)
-          Hash.from_xml(string)
-        end
-    
-        def marshal(entity, rel)
-          return entity if entity.kind_of? String
-          return entity.values.first.to_xml(:root => entity.keys.first) if entity.kind_of?(Hash) && entity.size==1
-          entity.to_xml
-        end
-      end
-    end
-  end
-end