benschwarz-openuri_memcached 0.1.1

data/README

@@ -0,0 +1,35 @@
+OpenURI with Memcached caching
+--
+
+Carelessly make heavy OpenURI calls as many times as you like with local
+memcached picking up the slack and stopping people from sending you hate mail.
+
+Require the library using 
+  require 'openuri_memcached'
+  
+To get started run your memcached server
+  $ memcached -d 
+The default address that this gem will terminate against is localhost:11211, you can change this using
+  OpenURI::Cache.host = ['10.1.1.10:11211', '10.1.1.11:11211']
+
+The cache defaults to 15 minutes, however this can be changed using:
+  OpenURI::Cache.expiry = 60 * 10 # Ten long minutes
+  
+Execution
+Use exactly the same as you would openuri, only.. enable it.
+
+  require 'openuri_memcached'
+  OpenURI::Cache.enable!
+  open("http://germanforblack.com").read # Slow as a wet week
+  
+Quit your app (leave memcached running) and run the same example, it 
+should now happen in less then ... some time that is really fast.
+
+Questions and comments can be directed to ben at germanforblack.com
+
+Requirements: 
+	» Ruby 1.8.6
+	» Memcached 
+	» memcache - Refer to blog.evanweaver.com/files/doc/fauna/memcached/files/README.html for installation notes
+	 For the gem, do this `sudo env ARCHFLAGS="-arch i386" gem install memcached --no-rdoc --no-ri -- --with-opt-dir=/opt/local`
+	

data/lib/openuri_memcached.rb

@@ -0,0 +1,78 @@
+require 'open-uri'
+require 'rubygems'
+require 'memcached'
+
+module Kernel
+  private 
+  alias openuri_original_open open
+  def open(uri, *rest, &block)
+    OpenURI::open(uri, *rest, &block)
+  end
+  module_function :open, :openuri_original_open
+end
+
+module OpenURI
+  alias original_open open #:nodoc:
+  def self.open(uri, *rest, &block)
+    if Cache.enabled?
+      begin
+        response = Cache::get(uri.to_s)
+      rescue Memcached::NotFound
+        response = false
+      end
+    end
+    
+    unless response
+      response = openuri_original_open(uri, *rest, &block).read
+      Cache::set(uri.to_s, response) if Cache.enabled?
+    end
+    StringIO.new(response)
+  end
+  
+  class Cache
+    # Cache is not enabled by default
+    @cache_enabled = false
+    
+    class << self
+      attr_writer :expiry, :host
+      
+      # Is the cache enabled?
+      def enabled?
+        @cache_enabled
+      end
+      
+      # Enable caching
+      def enable!
+        @cache ||= Memcached.new(host, {:namespace => 'openuri'})
+        @cache_enabled = true
+      end
+      
+      # Disable caching - all queries will be run directly 
+      # using the standard OpenURI `open` method.
+      def disable!
+        @cache_enabled = false
+      end
+
+      def disabled?
+        !@cache_enabled
+      end
+      
+      def get(key)
+        @cache.get(key)
+      end
+      
+      def set(key, value)
+        @cache.set(key, value, expiry)
+      end
+            
+      # How long your caches will be kept for (in seconds)
+      def expiry
+        @expiry ||= 60 * 10
+      end
+      
+      def host
+        @host ||= "127.0.0.1:11211"
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification 
+name: benschwarz-openuri_memcached
+version: !ruby/object:Gem::Version 
+  version: 0.1.1
+platform: ruby
+authors: 
+- Ben Schwarz
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-05-14 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: memcached
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0.10"
+    version: 
+description: OpenURI with transparent caching
+email: ben@germanforblack.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README
+- lib/openuri_memcached.rb
+has_rdoc: false
+homepage: http://github.com/benschwarz/open-uri-memcached
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: The same OpenURI that you know and love with the power of Memcached
+test_files: []
+