reference_tracking 0.0.1 → 0.0.2

data/lib/reference_tracking.rb

@@ -2,12 +2,19 @@ require 'active_support/core_ext/kernel/singleton_class'
 require 'action_controller'
 
 module ReferenceTracking
-  TAGS_HEADER = 'rack-cache.tags'
+  TAGS_HEADER       = 'rack-cache.tags'
+  PURGE_TAGS_HEADER = 'rack-cache.purge-tags'
 
   autoload :ActionController, 'reference_tracking/action_controller'
   autoload :IvarProxy,        'reference_tracking/ivar_proxy'
   autoload :Tracker,          'reference_tracking/tracker'
   autoload :References,       'reference_tracking/references'
+
+  class << self
+    def to_tag(object, method = nil)
+      "#{object.class.name.underscore}-#{object.id}#{":#{method}" if method}"
+    end
+  end
 end
 
 ActionController::Base.send(:extend, ReferenceTracking::ActionController::ActMacro)

data/lib/reference_tracking/action_controller.rb

@@ -3,7 +3,7 @@ module ReferenceTracking
     module ActMacro
       def tracks(*args)
         unless tracks_references?
-          include ReferenceTracking::ActionController
+          include ReferenceTracking::ActionController::Tracking
 
           class_inheritable_accessor :reference_tracking_options
           self.reference_tracking_options = { :header => TAGS_HEADER }
@@ -22,19 +22,46 @@ module ReferenceTracking
       def tracks_references?
         respond_to?(:reference_tracking_options) && reference_tracking_options.present?
       end
+
+      def purges(*actions)
+        unless purges?
+          include ReferenceTracking::ActionController::Purging
+          class_inheritable_accessor :purging_options
+          self.purging_options = { :header => PURGE_TAGS_HEADER, :actions => [] }
+        end
+
+        self.purging_options[:actions] += actions.map(&:to_sym)
+        self.purging_options[:actions].uniq
+      end
+
+      def purges?
+        respond_to?(:purging_options)
+      end
+
+      def purge?(action)
+        purges? && purging_options[:actions].include?(action.to_sym)
+      end
     end
 
     # TODO could this hook into instrumentation?
     # ActiveSupport::Notifications.instrument("render_template.action_view", ...)?
 
-    def render(*)
-      methods = reference_tracking_options[params[:action].to_sym] || {}
-      @_references = ReferenceTracking::References.new(self, methods)
+    module Tracking
+      def render(*)
+        methods = reference_tracking_options[params[:action].to_sym] || {}
+        @_references = ReferenceTracking::References.new(self, methods)
+
+        result = super
 
-      result = super
+        headers[reference_tracking_options[:header]] = @_references.tags unless @_references.empty?
+        result
+      end
+    end
 
-      headers[reference_tracking_options[:header]] = @_references.tags
-      result
+    module Purging
+      def purge(objects)
+        response.headers[purging_options[:header]] = objects.map { |object| ReferenceTracking.to_tag(object) }
+      end
     end
   end
 end

data/lib/reference_tracking/references.rb

@@ -5,9 +5,7 @@ module ReferenceTracking
     end
 
     def tags
-      map do |object, method| 
-        "#{object.class.name.underscore}-#{object.id}#{":#{method}" if method}"
-      end.uniq
+      map { |object, method| ReferenceTracking.to_tag(object, method) }.uniq
     end
   end
 end

data/lib/reference_tracking/version.rb

@@ -1,3 +1,3 @@
 module ReferenceTracking
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: reference_tracking
 version: !ruby/object:Gem::Version 
-  hash: 29
+  hash: 27
   prerelease: false
   segments: 
   - 0
   - 0
-  - 1
-  version: 0.0.1
+  - 2
+  version: 0.0.2
 platform: ruby
 authors: 
 - Sven Fuchs
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-09-04 00:00:00 +02:00
+date: 2010-09-05 00:00:00 +02:00
 default_executable: 
 dependencies: []