duality 0.0.1

data/Gemfile

@@ -0,0 +1,13 @@
+source :rubygems
+
+group :test do
+  gem 'rspec'
+  gem 'simplecov'
+  gem 'diskcached'
+  gem 'mongocached'
+end
+
+group :development do
+  gem 'rdoc'
+end
+

data/HISTORY.md

@@ -0,0 +1,6 @@
+# Duality
+
+## pre-release
+
+* initial commit
+

data/README.md

@@ -0,0 +1,24 @@
+duality
+=======
+
+a simple cache interface to setting and getting from two caches
+
+* sets to both caches asynchronously
+* gets from faster and then fails over to slower
+
+## Usage
+
+        require 'diskcached'
+        require 'memcached'
+        require 'duality'
+        
+        $cache = Duality.new(Diskcached.new, Memcached.new("remotehost:11211")) # example caches
+        $cache.set('key', "content")
+        puts $cache.get('key')
+        
+## More Info
+
+### [Documentation](http://rubyops.github.com/duality/doc/Duality.html) 
+### [Coverage](http://rubyops.github.com/duality/coverage/)
+
+

data/lib/duality.rb

@@ -0,0 +1,86 @@
+require 'timeout'
+class Duality
+
+  VERSION = "0.0.1"
+  DEFAULT_TIMEOUT=1
+  @@fast, @@slow = nil
+
+  # Used to set cache connection timeout
+  # - default is 0.5 seconds
+  attr_accessor :timeout
+
+  def initialize fast, slow
+    # check params are caches
+    raise NotACache unless fast.respond_to?(:set) && fast.respond_to?(:get)
+    raise NotACache unless slow.respond_to?(:set) && slow.respond_to?(:get)
+    @fast = fast
+    @slow = slow
+  end
+
+  # Return set timeout or use default.
+  def timeout
+    @timeout||DEFAULT_TIMEOUT
+  end
+
+  # Set to fast and slow.
+  # - timeout after #timeout
+  # - return true if both succeed
+  # - return false if either fail
+  def set key, value
+    Process.fork { @fast.set(key, value) }
+    Process.fork { @slow.set(key, value) }
+    begin
+      Timeout::timeout(timeout) do
+        return ((Process.waitall.select { |p| p[1] == 0 }).count == 2)
+      end
+    rescue Timeout::Error
+      raise CacheTimeout
+    end
+  end
+
+  # Get from fast or slow.
+  # - returns nil if none are found
+  def get key
+    content = nil
+    begin
+      content = @fast.get(key) 
+    rescue Exception
+    end
+
+    return content unless content.nil?
+
+    begin
+      content = @slow.get(key) 
+    rescue Exception
+    end
+    return content
+  end
+
+  # Add support for other methods from passed caches
+  # this adds support only, but no speed gains.
+  # - use "strict_" to ensure both caches contain method
+  def method_missing(meth, *args, &block)
+    if meth =~ /^strict_(.+)$/
+      meth = $1
+      return run_missing_method(meth, *args, &block) if @fast.respond_to?(meth) && @slow.respond_to?(meth)
+    elsif @fast.respond_to?(meth) || @slow.respond_to?(meth)
+      return run_missing_method(meth, *args, &block) 
+    end
+    super
+  end
+
+  private
+  def run_missing_method meth, *args, &block
+      fast = @fast.send(meth, *args, &block) rescue nil
+      slow = @slow.send(meth, *args, &block) rescue nil
+      return fast if fast == slow
+      return slow if fast.nil?
+      return fast
+  end
+
+  class NotACache < Exception
+  end
+
+  class CacheTimeout < Exception
+  end
+end

metadata

@@ -0,0 +1,129 @@
+--- !ruby/object:Gem::Specification
+name: duality
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Joshua Mervine
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-07-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: diskcached
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mongocached
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: a simple cache interface to setting and getting from two caches
+email:
+- joshua@mervine.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/duality.rb
+- README.md
+- HISTORY.md
+- Gemfile
+homepage: http://github.com/rubyops/duality/
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Simple disk cache
+test_files: []