preheat 0.1.0 → 0.2.0

data/README.rdoc

@@ -0,0 +1,60 @@
+= Preheat
+
+IN DEVELOPMENT DISCLAMER: This gem is still under development and hasn't been put through intensive real-world testing yet.  Any comments/concerns/recommendations would be greatly appreciated.
+
+Keep your Rails.cache up to date without:
+* code bloat in your Rails.cache.fetch invocations
+* tedious dependency setup in a cron task to mimic what your controller does, just so you can call your model/library methods which have the Rails.cache.fetch invocations
+
+Anything executed in a Preheat.it block will change all fetch calls into a fetch calls with :force => true.  (:force => true will force a cache-miss and a subsequent cache-write)
+
+== Example
+
+This will "preheat" all your Rails.cache.fetch calls on your homepage.  It is as simple as that!
+
+  Preheat.it do
+    app.get("/")
+  end
+
+Note: If you have not seen "app.get" used before, the "app" object is not related to my preheat gem.  It ships with rails: {more detail here}[http://www.clarkware.com/cgi/blosxom/2006/04/04].  I use app.get because ActiveSupport's fetch method is being modified only in the ruby process which is using Preheat, so something like mechanize/wget/curl would call the page through your frontend webserver and would not be effected by Preheat.it, while app.get will directly call your controller in that same ruby process.
+
+== A more detailed example
+
+Let's say we have a list of product pages where we want the cached to be updated every hour.
+
+  #app/models/product.rb
+  def slow_method
+    Rails.cache.fetch("product-slow-method-#{self.id}") do
+      sleep 15
+      Time.now
+    end
+  end
+
+  #lib/tasks/preheat.rake
+  namespace :preheat do
+    desc "Preheat product caches"
+    task (:products => :environment) do
+      Preheat.it do
+        Product.all.each do |product|
+          app.get(app.products_path(product)) #or you could just call product.slow_method directly, whatever makes more sense
+        end
+      end
+    end
+  end
+
+  #crontab -e
+  0 * * * * /path/to/rake preheat:products RAILS_ENV=production 2>&1 >> #{Rails.root}/log/preheat.log &
+
+== Installation
+
+1. gem install preheat
+2. Add the gem to environment.rb or your Gemfile
+
+== Thanks
+
+John Hume for helping me cleanup part of my code.
+Brian Guthrie for getting me all learned up on gem dependencies and the like.
+
+
+
+

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.2.0

data/lib/preheat.rb

@@ -11,14 +11,12 @@ class ActiveSupport::Cache::Store
     end
   end
 
-  #the singleton class_eval workaround for the aliasing is due to this issue:
-  # http://newsgroups.derkeiler.com/Archive/Comp/comp.lang.ruby/2006-05/msg00575.html
   def enable_preheat
-    (class << self; self; end).class_eval { alias_method_chain :fetch, :force }
+    self.class_eval { alias_method_chain :fetch, :force }
   end
 
   def disable_preheat
-    (class << self; self; end).class_eval { alias_method :fetch, :fetch_without_force }
+    self.class_eval { alias_method :fetch, :fetch_without_force }
   end
 end
 

data/preheat.gemspec

@@ -0,0 +1,46 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{preheat}
+  s.version = "0.2.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Tom Hallett"]
+  s.date = %q{2010-10-07}
+  s.description = %q{Keep your Rails.cache warm}
+  s.email = %q{tomhallett@gmail.com}
+  s.extra_rdoc_files = [
+    "README.rdoc"
+  ]
+  s.files = [
+    ".gitignore",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "lib/preheat.rb",
+     "preheat.gemspec",
+     "spec/lib/preheat_spec.rb"
+  ]
+  s.homepage = %q{http://github.com/tommyh/preheat}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Keep your Rails.cache warm}
+  s.test_files = [
+    "spec/lib/preheat_spec.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: preheat
 version: !ruby/object:Gem::Version 
-  hash: 27
+  hash: 23
   prerelease: false
   segments: 
   - 0
-  - 1
+  - 2
   - 0
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Tom Hallett
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-09-28 00:00:00 -04:00
+date: 2010-10-07 00:00:00 -04:00
 default_executable: 
 dependencies: []
 
@@ -33,6 +33,7 @@ files:
 - Rakefile
 - VERSION
 - lib/preheat.rb
+- preheat.gemspec
 - spec/lib/preheat_spec.rb
 has_rdoc: true
 homepage: http://github.com/tommyh/preheat