jodosha-redis-store 0.0.2

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Luca Guidi
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.textile

@@ -0,0 +1,35 @@
+h1. Redis cache and session stores for Ruby web frameworks
+
+h2. Installation
+
+Download and install Redis from http://code.google.com/p/redis/
+
+  wget http://redis.googlecode.com/files/redis-0.094.tar.gz
+  tar -zxvf redis-0.094.tar.gz
+  cd redis-0.094
+  make
+
+Install the gems
+
+  sudo gem install ezmobius-redis-rb -s http://gems.github.com
+  sudo gem install jodosha-redis-store -s http://gems.github.com
+
+h2. How to use with Rails
+
+In your configuration files:
+
+  config.gem "jodosha-redis-store", :source => "http://gems.github.com", :lib => "redis-store"
+  require "redis-store" # HACK Rails tries to instantiate cache first, then load configured gems
+  config.cache_store = :redis_store
+
+h2. How to use with Merb
+
+  dependency "merb-cache" do
+    Merb::Cache.setup do
+      register(:redis, RedisStore, :servers => ["127.0.0.1:6379"])
+    end
+  end
+
+h2. Copyright
+
+(c) 2009 Luca Guidi - http://lucaguidi.com, released under the MIT license

data/Rakefile

@@ -0,0 +1,52 @@
+$:.unshift 'lib'
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'spec/rake/spectask'
+
+REDIS_STORE_VERSION = "0.0.2"
+
+task :default => :spec
+
+desc 'Build and install the gem (useful for development purposes).'
+task :install do
+  system "gem build redis-store.gemspec"
+  system "sudo gem uninstall redis-store"
+  system "sudo gem install --local --no-rdoc --no-ri redis-store-#{REDIS_STORE_VERSION}.gem"
+  system "rm redis-store-*.gem"
+end
+
+Spec::Rake::SpecTask.new do |t|
+  t.spec_files = FileList['spec/**/*_spec.rb']
+  t.spec_opts = %w(-fs --color)
+end
+
+desc 'Show the file list for the gemspec file'
+task :files do
+  puts "Files:\n #{Dir['**/*'].reject {|f| File.directory?(f)}.sort.inspect}"
+  puts "Test files:\n #{Dir['spec/**/*_spec.rb'].reject {|f| File.directory?(f)}.sort.inspect}"
+end
+
+namespace :redis do
+  desc 'Start the Redis cluster'
+  task :start => :clean do
+    system "redis-server spec/config/single.conf"
+    system "redis-server spec/config/master.conf"
+    system "redis-server spec/config/slave.conf"
+  end
+
+  desc 'Stop the Redis cluster'
+  task :stop do
+    # TODO replace with:
+    # system "kill -9 `tmp/redis-single.pid`"
+    # system "kill -9 `tmp/redis-master.pid`"
+    # system "kill -9 `tmp/redis-slave.pid`"
+    system "ps -eo pid,comm | grep redis | xargs kill -9"
+  end
+
+  desc 'Clean the tmp/ directory'
+  task :clean do
+    system "rm tmp/*" rescue nil
+  end
+end

data/lib/cache/merb/redis_store.rb

@@ -0,0 +1,83 @@
+module Merb
+  module Cache
+    class RedisStore < AbstractStore
+      # Instantiate the store.
+      #
+      # Example:
+      #   RedisStore.new                                     # => host: localhost,   port: 6379,  db: 0
+      #   RedisStore.new :servers => ["example.com"]         # => host: example.com, port: 6379,  db: 0
+      #   RedisStore.new :servers => ["example.com:23682"]   # => host: example.com, port: 23682, db: 0
+      #   RedisStore.new :servers => ["example.com:23682/1"] # => host: example.com, port: 23682, db: 1
+      #   RedisStore.new :servers => ["localhost:6379/0", "localhost:6380/0"] # => instantiate a cluster
+      def initialize(config = {})
+        addresses = extract_addresses(config[:servers])
+        @data = if addresses.size > 1
+          DistributedMarshaledRedis.new addresses
+        else
+          MarshaledRedis.new addresses.first || {}
+        end
+      end
+
+      def writable?(key, parameters = {}, conditions = {})
+        true
+      end
+
+      def read(key, parameters = {}, conditions = {})
+        @data.get normalize(key, parameters), conditions
+      end
+
+      def write(key, data = nil, parameters = {}, conditions = {})
+        if writable?(key, parameters, conditions)
+          method = conditions && conditions[:unless_exist] ? :set_unless_exists : :set
+          @data.send method, normalize(key, parameters), data, conditions
+        end
+      end
+
+      def write_all(key, data = nil, parameters = {}, conditions = {})
+        write key, data, parameters, conditions
+      end
+
+      def fetch(key, parameters = {}, conditions = {}, &blk)
+        read(key, parameters) || (write key, yield, parameters, conditions if block_given?)
+      end
+
+      def exists?(key, parameters = {})
+        @data.key? normalize(key, parameters)
+      end
+
+      def delete(key, parameters = {})
+        @data.delete normalize(key, parameters)
+      end
+
+      def delete_all
+        @data.flush_db
+      end
+
+      def delete_all!
+        delete_all
+      end
+
+      private
+        def extract_addresses(addresses) # TODO extract in a module or a class
+          return [] unless addresses
+          addresses = addresses.flatten.compact
+          addresses.inject([]) do |result, address|
+            host, port = address.split /\:/
+            port, db   = port.split /\// if port
+            address = {}
+            address[:host] = host if host
+            address[:port] = port if port
+            address[:db]  = db.to_i if db
+            result << address
+            result
+          end
+        end
+
+        # Returns cache key calculated from base key
+        # and SHA2 hex from parameters.
+        def normalize(key, parameters = {})
+          parameters.empty? ? "#{key}" : "#{key}--#{parameters.to_sha2}"
+        end
+    end
+  end
+end

data/lib/cache/rails/redis_store.rb

@@ -0,0 +1,129 @@
+module ActiveSupport
+  module Cache
+    class RedisStore < Store
+      # Instantiate the store.
+      #
+      # Example:
+      #   RedisStore.new                       # => host: localhost,   port: 6379,  db: 0
+      #   RedisStore.new "example.com"         # => host: example.com, port: 6379,  db: 0
+      #   RedisStore.new "example.com:23682"   # => host: example.com, port: 23682, db: 0
+      #   RedisStore.new "example.com:23682/1" # => host: example.com, port: 23682, db: 1
+      #   RedisStore.new "localhost:6379/0", "localhost:6380/0" # => instantiate a cluster
+      def initialize(*addresses)
+        addresses = extract_addresses(addresses)
+        @data = if addresses.size > 1
+          DistributedMarshaledRedis.new addresses
+        else
+          MarshaledRedis.new addresses.first || {}
+        end
+      end
+
+      def write(key, value, options = nil)
+        super
+        method = options && options[:unless_exist] ? :set_unless_exists : :set
+        @data.send method, key, value, options
+      end
+
+      def read(key, options = nil)
+        super
+        @data.get key, options
+      end
+
+      def delete(key, options = nil)
+        super
+        @data.delete key
+      end
+
+      def exist?(key, options = nil)
+        super
+        @data.key? key
+      end
+
+      # Increment a key in the store.
+      #
+      # If the key doesn't exist it will be initialized on 0.
+      # If the key exist but it isn't a Fixnum it will be initialized on 0.
+      #
+      # Example:
+      #   We have two objects in cache:
+      #     counter # => 23
+      #     rabbit  # => #<Rabbit:0x5eee6c>
+      #
+      #   cache.increment "counter"
+      #   cache.read "counter", :raw => true      # => "24"
+      #
+      #   cache.increment "counter", 6
+      #   cache.read "counter", :raw => true      # => "30"
+      #
+      #   cache.increment "a counter"
+      #   cache.read "a counter", :raw => true    # => "1"
+      #
+      #   cache.increment "rabbit"
+      #   cache.read "rabbit", :raw => true       # => "1"
+      def increment(key, amount = 1)
+        log "increment", key, amount
+        @data.incr key, amount
+      end
+
+      # Decrement a key in the store
+      #
+      # If the key doesn't exist it will be initialized on 0.
+      # If the key exist but it isn't a Fixnum it will be initialized on 0.
+      #
+      # Example:
+      #   We have two objects in cache:
+      #     counter # => 23
+      #     rabbit  # => #<Rabbit:0x5eee6c>
+      #
+      #   cache.decrement "counter"
+      #   cache.read "counter", :raw => true      # => "22"
+      #
+      #   cache.decrement "counter", 2
+      #   cache.read "counter", :raw => true      # => "20"
+      #
+      #   cache.decrement "a counter"
+      #   cache.read "a counter", :raw => true    # => "-1"
+      #
+      #   cache.decrement "rabbit"
+      #   cache.read "rabbit", :raw => true       # => "-1"
+      def decrement(key, amount = 1)
+        log "decrement", key, amount
+        @data.decr key, amount
+      end
+
+      # Delete objects for matched keys.
+      #
+      # Example:
+      #   cache.delete_matched "rab*"
+      def delete_matched(matcher, options = nil)
+        super
+        @data.keys(matcher).each { |key| @data.delete key }
+      end
+
+      # Clear all the data from the store.
+      def clear
+        log "clear", nil, nil
+        @data.flush_db
+      end
+
+      def stats
+        @data.info
+      end
+      
+      private
+        def extract_addresses(addresses)
+          addresses = addresses.flatten.compact
+          addresses.inject([]) do |result, address|
+            host, port = address.split /\:/
+            port, db   = port.split /\// if port
+            address = {}
+            address[:host] = host if host
+            address[:port] = port if port
+            address[:db]  = db.to_i if db
+            result << address
+            result
+          end
+        end
+    end
+  end
+end

data/lib/redis/distributed_marshaled_redis.rb

@@ -0,0 +1,10 @@
+class DistributedMarshaledRedis < DistRedis
+  def initialize(addresses)
+    nodes = addresses.map do |address|
+      MarshaledRedis.new address
+    end
+    @ring = HashRing.new nodes
+  end
+  
+  alias_method :flush_db, :delete_cloud!
+end

data/lib/redis/marshaled_redis.rb

@@ -0,0 +1,28 @@
+class MarshaledRedis < Redis
+  def set(key, val, options = nil)
+    val = Marshal.dump val unless raw?(options)
+    super key, val, expires_in(options)
+  end
+
+  def set_unless_exists(key, val, options = nil)
+    val = Marshal.dump val unless raw?(options)
+    super key, val    
+  end
+
+  def get(key, options = nil)
+    result = super key
+    result = Marshal.load result if result && !raw?(options)
+    result
+  end
+  
+  private
+    def raw?(options)
+      options && options[:raw]
+    end
+
+    def expires_in(options)
+      if options
+        options[:expires_in] || options[:expire_in]
+      end
+    end
+end

data/lib/redis-store.rb

@@ -0,0 +1,11 @@
+require "redis"
+require "dist_redis"
+require "redis/marshaled_redis"
+require "redis/distributed_marshaled_redis"
+
+if defined?(Merb)
+  require "cache/merb/redis_store"
+else # rails or ruby application
+  require "activesupport"
+  require "cache/rails/redis_store"
+end

data/redis-store.gemspec

@@ -0,0 +1,14 @@
+Gem::Specification.new do |s|
+  s.name               = "redis-store"
+  s.version            = "0.0.2"
+  s.date               = "2009-04-16"
+  s.summary            = "Redis cache and session stores for Ruby web frameworks"
+  s.author             = "Luca Guidi"
+  s.email              = "guidi.luca@gmail.com"
+  s.homepage           = "http://lucaguidi.com"
+  s.description        = "Redis cache and session stores for Ruby web frameworks"
+  s.has_rdoc           = true
+  s.files              = ["MIT-LICENSE", "README.textile", "Rakefile", "lib/cache/merb/redis_store.rb", "lib/cache/rails/redis_store.rb", "lib/redis-store.rb", "lib/redis/distributed_marshaled_redis.rb", "lib/redis/marshaled_redis.rb", "redis-store.gemspec", "spec/cache/merb/redis_store_spec.rb", "spec/cache/rails/redis_store_spec.rb", "spec/config/master.conf", "spec/config/single.conf", "spec/config/slave.conf", "spec/redis/distributed_marshaled_redis_spec.rb", "spec/redis/marshaled_redis_spec.rb", "spec/spec_helper.rb"]
+  s.test_files         = ["spec/cache/merb/redis_store_spec.rb", "spec/cache/rails/redis_store_spec.rb", "spec/redis/distributed_marshaled_redis_spec.rb", "spec/redis/marshaled_redis_spec.rb"]
+  s.extra_rdoc_files   = ["README.textile"]
+end

data/spec/cache/merb/redis_store_spec.rb

@@ -0,0 +1,132 @@
+require File.join(File.dirname(__FILE__), "/../../spec_helper")
+
+module Merb
+  module Cache
+    describe "RedisStore" do
+      before(:each) do
+        @store  = RedisStore.new
+        @dstore = RedisStore.new :servers => ["localhost:6380/1", "localhost:6381/1"]
+        @rabbit = OpenStruct.new :name => "bunny"
+        @white_rabbit = OpenStruct.new :color => "white"
+        with_store_management do |store|
+          store.write  "rabbit", @rabbit
+          store.delete "rub-a-dub"
+        end
+      end
+
+      it "should accept connection params" do
+        redis = instantiate_store
+        redis.instance_variable_get(:@db).should == 0
+        redis.host.should == "localhost"
+        redis.port.should == "6379"
+
+        redis = instantiate_store "redis.com"
+        redis.host.should == "redis.com"
+        
+        redis = instantiate_store "redis.com:6380"
+        redis.host.should == "redis.com"
+        redis.port.should == "6380"
+
+        redis = instantiate_store "redis.com:6380/23"
+        redis.instance_variable_get(:@db).should == 23
+        redis.host.should == "redis.com"
+        redis.port.should == "6380"
+      end
+      
+      it "should instantiate a ring" do
+        store = instantiate_store
+        store.should be_kind_of(MarshaledRedis)
+        store = instantiate_store ["localhost:6379/0", "localhost:6379/1"]
+        store.should be_kind_of(DistributedMarshaledRedis)
+      end
+
+      it "should verify if writable" do
+        with_store_management do |store|
+          store.writable?("rabbit").should be_true
+        end
+      end
+
+      it "should read the data" do
+        with_store_management do |store|
+          store.read("rabbit").should === @rabbit
+        end
+      end
+
+      it "should read raw data" do
+        with_store_management do |store|
+          store.read("rabbit", {}, :raw => true).should == "\004\bU:\017OpenStruct{\006:\tname\"\nbunny"
+        end
+      end
+
+      it "should write the data" do
+        with_store_management do |store|
+          store.write "rabbit", @white_rabbit
+          store.read("rabbit").should === @white_rabbit
+        end
+      end
+
+      it "should write raw data" do
+        with_store_management do |store|
+          store.write "rabbit", @white_rabbit, {}, :raw => true
+          store.read("rabbit", {}, :raw => true).should == %(#<OpenStruct color="white">)
+        end
+      end
+
+      # it "should write the data with expiration time" do
+      #   @store.write "rabbit", @white_rabbit, :expires_in => 1.second
+      #   @store.read("rabbit").should === @white_rabbit ; sleep 2
+      #   @store.read("rabbit").should be_nil
+      # end
+
+      it "should not write data if :unless_exist option is true" do
+        with_store_management do |store|
+          store.write "rabbit", @white_rabbit, {}, :unless_exist => true
+          store.read("rabbit").should === @rabbit
+        end
+      end
+
+      it "should fetch data" do
+        with_store_management do |store|
+          store.fetch("rabbit").should == @rabbit
+          store.fetch("rub-a-dub").should be_nil
+          store.fetch("rub-a-dub") { "Flora de Cana" }
+          store.fetch("rub-a-dub").should === "Flora de Cana"
+          # store.fetch("rabbit", {}, :force => true, :expires_in => 1.second) { @white_rabbit }
+          # store.fetch("rabbit").should === @white_rabbit ; sleep 2
+          # store.fetch("rabbit").should be_nil
+        end
+      end
+
+      it "should verify existence" do
+        with_store_management do |store|
+          store.exists?("rabbit").should be_true
+          store.exists?("rab-a-dub").should be_false
+        end
+      end
+
+      it "should delete data" do
+        with_store_management do |store|
+          store.delete "rabbit"
+          store.read("rabbit").should be_nil
+        end
+      end
+
+      it "should delete all the data" do
+        with_store_management do |store|
+          store.delete_all
+          store.instance_variable_get(:@data).keys("*").should be_empty
+        end
+      end
+
+      private
+        def instantiate_store(addresses = nil)
+          RedisStore.new(:servers => [addresses].flatten).instance_variable_get(:@data)
+        end
+
+        def with_store_management
+          yield @store
+          yield @dstore
+        end
+    end
+  end
+end

data/spec/cache/rails/redis_store_spec.rb

@@ -0,0 +1,170 @@
+require File.join(File.dirname(__FILE__), "/../../spec_helper")
+
+module ActiveSupport
+  module Cache
+    describe "RedisStore" do
+      before(:each) do
+        @store  = RedisStore.new
+        @dstore = RedisStore.new "localhost:6380/1", "localhost:6381/1"
+        @rabbit = OpenStruct.new :name => "bunny"
+        @white_rabbit = OpenStruct.new :color => "white"
+        with_store_management do |store|
+          store.write  "rabbit", @rabbit
+          store.delete "counter"
+        end
+      end
+
+      it "should accept connection params" do
+        redis = instantiate_store
+        redis.instance_variable_get(:@db).should == 0
+        redis.host.should == "localhost"
+        redis.port.should == "6379"
+
+        redis = instantiate_store "redis.com"
+        redis.host.should == "redis.com"
+        
+        redis = instantiate_store "redis.com:6380"
+        redis.host.should == "redis.com"
+        redis.port.should == "6380"
+
+        redis = instantiate_store "redis.com:6380/23"
+        redis.instance_variable_get(:@db).should == 23
+        redis.host.should == "redis.com"
+        redis.port.should == "6380"
+      end
+
+      it "should instantiate a ring" do
+        store = instantiate_store
+        store.should be_kind_of(MarshaledRedis)
+        store = instantiate_store ["localhost:6379/0", "localhost:6379/1"]
+        store.should be_kind_of(DistributedMarshaledRedis)
+      end
+
+      it "should read the data" do
+        with_store_management do |store|
+          store.read("rabbit").should === @rabbit
+        end
+      end
+
+      it "should write the data" do
+        with_store_management do |store|
+          store.write "rabbit", @white_rabbit
+          store.read("rabbit").should === @white_rabbit
+        end
+      end
+
+      # it "should write the data with expiration time" do
+      #   @store.write "rabbit", @white_rabbit, :expires_in => 1.second
+      #   @store.read("rabbit").should === @white_rabbit ; sleep 2
+      #   @store.read("rabbit").should be_nil
+      # end
+
+      it "should not write data if :unless_exist option is true" do
+        with_store_management do |store|
+          store.write "rabbit", @white_rabbit, :unless_exist => true
+          store.read("rabbit").should === @rabbit
+        end
+      end
+
+      it "should read raw data" do
+        with_store_management do |store|
+          store.read("rabbit", :raw => true).should == "\004\bU:\017OpenStruct{\006:\tname\"\nbunny"
+        end
+      end
+
+      it "should write raw data" do
+        with_store_management do |store|
+          store.write "rabbit", @white_rabbit, :raw => true
+          store.read("rabbit", :raw => true).should == %(#<OpenStruct color="white">)
+        end
+      end
+
+      it "should delete data" do
+        with_store_management do |store|
+          store.delete "rabbit"
+          store.read("rabbit").should be_nil
+        end
+      end
+
+      it "should delete matched data" do
+        with_store_management do |store|
+          store.delete_matched "rabb*"
+          store.read("rabbit").should be_nil
+        end
+      end
+
+      it "should verify existence of an object in the store" do
+        with_store_management do |store|
+          store.exist?("rabbit").should be_true
+          store.exist?("rab-a-dub").should be_false
+        end
+      end
+
+      it "should increment a key" do
+        with_store_management do |store|
+          3.times { store.increment "counter" }
+          store.read("counter", :raw => true).to_i.should == 3
+        end
+      end
+
+      it "should decrement a key" do
+        with_store_management do |store|
+          3.times { store.increment "counter" }
+          2.times { store.decrement "counter" }
+          store.read("counter", :raw => true).to_i.should == 1
+        end
+      end
+
+      it "should increment a key by given value" do
+        with_store_management do |store|
+          store.increment "counter", 3
+          store.read("counter", :raw => true).to_i.should == 3
+        end
+      end
+
+      it "should decrement a key by given value" do
+        with_store_management do |store|
+          3.times { store.increment "counter" }
+          store.decrement "counter", 2
+          store.read("counter", :raw => true).to_i.should == 1
+        end
+      end
+
+      it "should clear the store" do
+        with_store_management do |store|
+          store.clear
+          store.instance_variable_get(:@data).keys("*").should be_empty
+        end
+      end
+
+      it "should return store stats" do
+        with_store_management do |store|
+          store.stats.should_not be_empty
+        end
+      end
+
+      it "should fetch data" do
+        with_store_management do |store|
+          store.fetch("rabbit").should == @rabbit
+          store.fetch("rub-a-dub").should be_nil
+          store.fetch("rub-a-dub") { "Flora de Cana" }
+          store.fetch("rub-a-dub").should === "Flora de Cana"
+          store.fetch("rabbit", :force => true).should be_nil # force cache miss
+          # store.fetch("rabbit", :force => true, :expires_in => 1.second) { @white_rabbit }
+          # store.fetch("rabbit").should === @white_rabbit ; sleep 2
+          # store.fetch("rabbit").should be_nil
+        end
+      end
+      
+      private
+        def instantiate_store(addresses = nil)
+          RedisStore.new(addresses).instance_variable_get(:@data)
+        end
+
+        def with_store_management
+          yield @store
+          yield @dstore
+        end
+    end
+  end
+end

data/spec/config/master.conf

@@ -0,0 +1,87 @@
+# Redis configuration file example
+
+# By default Redis does not run as a daemon. Use 'yes' if you need it.
+# Note that Redis will write a pid file in /var/run/redis.pid when daemonized.
+daemonize yes
+
+# When run as a daemon, Redis write a pid file in /var/run/redis.pid by default.
+# You can specify a custom pid file location here.
+pidfile ./tmp/redis-master.pid
+
+# Accept connections on the specified port, default is 6379
+port 6380
+
+# If you want you can bind a single interface, if the bind option is not
+# specified all the interfaces will listen for connections.
+#
+# bind 127.0.0.1
+
+# Close the connection after a client is idle for N seconds
+timeout 300
+
+# Save the DB on disk:
+#
+#   save <seconds> <changes>
+#
+#   Will save the DB if both the given number of seconds and the given
+#   number of write operations against the DB occurred.
+#
+#   In the example below the behaviour will be to save:
+#   after 900 sec (15 min) if at least 1 key changed
+#   after 300 sec (5 min) if at least 10 keys changed
+#   after 60 sec if at least 10000 keys changed
+save 900 1
+save 300 10
+save 60 10000
+
+# For default save/load DB in/from the working directory
+# Note that you must specify a directory not a file name.
+dir ./tmp
+
+# Set server verbosity to 'debug'
+# it can be one of:
+# debug (a lot of information, useful for development/testing)
+# notice (moderately verbose, what you want in production probably)
+# warning (only very important / critical messages are logged)
+loglevel debug
+
+# Specify the log file name. Also 'stdout' can be used to force
+# the demon to log on the standard output. Note that if you use standard
+# output for logging but daemonize, logs will be sent to /dev/null
+logfile stdout
+
+# Set the number of databases.
+databases 16
+
+################################# REPLICATION #################################
+
+# Master-Slave replication. Use slaveof to make a Redis instance a copy of
+# another Redis server. Note that the configuration is local to the slave
+# so for example it is possible to configure the slave to save the DB with a
+# different interval, or to listen to another port, and so on.
+
+# slaveof <masterip> <masterport>
+
+################################## SECURITY ###################################
+
+# Require clients to issue AUTH <PASSWORD> before processing any other
+# commands.  This might be useful in environments in which you do not trust
+# others with access to the host running redis-server.
+#
+# This should stay commented out for backward compatibility and because most
+# people do not need auth (e.g. they run their own servers).
+
+# requirepass foobared
+
+############################### ADVANCED CONFIG ###############################
+
+# Glue small output buffers together in order to send small replies in a
+# single TCP packet. Uses a bit more CPU but most of the times it is a win
+# in terms of number of queries per second. Use 'yes' if unsure.
+glueoutputbuf yes
+
+# Use object sharing. Can save a lot of memory if you have many common
+# string in your dataset, but performs lookups against the shared objects
+# pool so it uses more CPU and can be a bit slower. Usually it's a good
+# idea.
+shareobjects no

data/spec/config/single.conf

@@ -0,0 +1,87 @@
+# Redis configuration file example
+
+# By default Redis does not run as a daemon. Use 'yes' if you need it.
+# Note that Redis will write a pid file in /var/run/redis.pid when daemonized.
+daemonize yes
+
+# When run as a daemon, Redis write a pid file in /var/run/redis.pid by default.
+# You can specify a custom pid file location here.
+pidfile ./tmp/redis-single.pid
+
+# Accept connections on the specified port, default is 6379
+port 6379
+
+# If you want you can bind a single interface, if the bind option is not
+# specified all the interfaces will listen for connections.
+#
+# bind 127.0.0.1
+
+# Close the connection after a client is idle for N seconds
+timeout 300
+
+# Save the DB on disk:
+#
+#   save <seconds> <changes>
+#
+#   Will save the DB if both the given number of seconds and the given
+#   number of write operations against the DB occurred.
+#
+#   In the example below the behaviour will be to save:
+#   after 900 sec (15 min) if at least 1 key changed
+#   after 300 sec (5 min) if at least 10 keys changed
+#   after 60 sec if at least 10000 keys changed
+save 900 1
+save 300 10
+save 60 10000
+
+# For default save/load DB in/from the working directory
+# Note that you must specify a directory not a file name.
+dir ./tmp
+
+# Set server verbosity to 'debug'
+# it can be one of:
+# debug (a lot of information, useful for development/testing)
+# notice (moderately verbose, what you want in production probably)
+# warning (only very important / critical messages are logged)
+loglevel debug
+
+# Specify the log file name. Also 'stdout' can be used to force
+# the demon to log on the standard output. Note that if you use standard
+# output for logging but daemonize, logs will be sent to /dev/null
+logfile stdout
+
+# Set the number of databases.
+databases 16
+
+################################# REPLICATION #################################
+
+# Master-Slave replication. Use slaveof to make a Redis instance a copy of
+# another Redis server. Note that the configuration is local to the slave
+# so for example it is possible to configure the slave to save the DB with a
+# different interval, or to listen to another port, and so on.
+
+# slaveof <masterip> <masterport>
+
+################################## SECURITY ###################################
+
+# Require clients to issue AUTH <PASSWORD> before processing any other
+# commands.  This might be useful in environments in which you do not trust
+# others with access to the host running redis-server.
+#
+# This should stay commented out for backward compatibility and because most
+# people do not need auth (e.g. they run their own servers).
+
+# requirepass foobared
+
+############################### ADVANCED CONFIG ###############################
+
+# Glue small output buffers together in order to send small replies in a
+# single TCP packet. Uses a bit more CPU but most of the times it is a win
+# in terms of number of queries per second. Use 'yes' if unsure.
+glueoutputbuf yes
+
+# Use object sharing. Can save a lot of memory if you have many common
+# string in your dataset, but performs lookups against the shared objects
+# pool so it uses more CPU and can be a bit slower. Usually it's a good
+# idea.
+shareobjects no

data/spec/config/slave.conf

@@ -0,0 +1,87 @@
+# Redis configuration file example
+
+# By default Redis does not run as a daemon. Use 'yes' if you need it.
+# Note that Redis will write a pid file in /var/run/redis.pid when daemonized.
+daemonize yes
+
+# When run as a daemon, Redis write a pid file in /var/run/redis.pid by default.
+# You can specify a custom pid file location here.
+pidfile ./tmp/redis-slave.pid
+
+# Accept connections on the specified port, default is 6379
+port 6381
+
+# If you want you can bind a single interface, if the bind option is not
+# specified all the interfaces will listen for connections.
+#
+# bind 127.0.0.1
+
+# Close the connection after a client is idle for N seconds
+timeout 300
+
+# Save the DB on disk:
+#
+#   save <seconds> <changes>
+#
+#   Will save the DB if both the given number of seconds and the given
+#   number of write operations against the DB occurred.
+#
+#   In the example below the behaviour will be to save:
+#   after 900 sec (15 min) if at least 1 key changed
+#   after 300 sec (5 min) if at least 10 keys changed
+#   after 60 sec if at least 10000 keys changed
+save 900 1
+save 300 10
+save 60 10000
+
+# For default save/load DB in/from the working directory
+# Note that you must specify a directory not a file name.
+dir ./tmp
+
+# Set server verbosity to 'debug'
+# it can be one of:
+# debug (a lot of information, useful for development/testing)
+# notice (moderately verbose, what you want in production probably)
+# warning (only very important / critical messages are logged)
+loglevel debug
+
+# Specify the log file name. Also 'stdout' can be used to force
+# the demon to log on the standard output. Note that if you use standard
+# output for logging but daemonize, logs will be sent to /dev/null
+logfile stdout
+
+# Set the number of databases.
+databases 16
+
+################################# REPLICATION #################################
+
+# Master-Slave replication. Use slaveof to make a Redis instance a copy of
+# another Redis server. Note that the configuration is local to the slave
+# so for example it is possible to configure the slave to save the DB with a
+# different interval, or to listen to another port, and so on.
+
+# slaveof 127.0.0.1 6380
+
+################################## SECURITY ###################################
+
+# Require clients to issue AUTH <PASSWORD> before processing any other
+# commands.  This might be useful in environments in which you do not trust
+# others with access to the host running redis-server.
+#
+# This should stay commented out for backward compatibility and because most
+# people do not need auth (e.g. they run their own servers).
+
+# requirepass foobared
+
+############################### ADVANCED CONFIG ###############################
+
+# Glue small output buffers together in order to send small replies in a
+# single TCP packet. Uses a bit more CPU but most of the times it is a win
+# in terms of number of queries per second. Use 'yes' if unsure.
+glueoutputbuf yes
+
+# Use object sharing. Can save a lot of memory if you have many common
+# string in your dataset, but performs lookups against the shared objects
+# pool so it uses more CPU and can be a bit slower. Usually it's a good
+# idea.
+shareobjects no

data/spec/redis/distributed_marshaled_redis_spec.rb

@@ -0,0 +1,35 @@
+require File.join(File.dirname(__FILE__), "/../spec_helper")
+
+describe "DistributedMarshaledRedis" do
+  before(:each) do
+    @dmr = DistributedMarshaledRedis.new [
+      {:host => "localhost", :port => "6380", :db => 0},
+      {:host => "localhost", :port => "6381", :db => 0}
+    ]
+    @rabbit = OpenStruct.new :name => "bunny"
+    @white_rabbit = OpenStruct.new :color => "white"
+    @dmr.set "rabbit", @rabbit
+  end
+
+  after(:all) do
+    @dmr.ring.nodes.each { |server| server.flush_db }
+  end
+
+  it "should accept connection params" do
+    dmr = DistributedMarshaledRedis.new [ :host => "redis.com", :port => "6380", :db => 1 ]
+    dmr.ring.should have(1).node
+    mr = dmr.ring.nodes.first
+    mr.host.should == "redis.com"
+    mr.port.should == "6380"
+    mr.instance_variable_get(:@db).should == 1
+  end
+
+  it "should set an object" do
+    @dmr.set "rabbit", @white_rabbit
+    @dmr.get("rabbit").should == @white_rabbit
+  end
+
+  it "should get an object" do
+    @dmr.get("rabbit").should == @rabbit
+  end
+end

data/spec/redis/marshaled_redis_spec.rb

@@ -0,0 +1,44 @@
+require File.join(File.dirname(__FILE__), "/../spec_helper")
+
+describe "MarshaledRedis" do
+  before(:each) do
+    @mr = MarshaledRedis.new
+    @rabbit = OpenStruct.new :name => "bunny"
+    @white_rabbit = OpenStruct.new :color => "white"
+    @mr.set    "rabbit", @rabbit
+    @mr.delete "rabbit2"
+  end
+
+  it "should unmarshal an object on get" do
+    @mr.get("rabbit").should === @rabbit
+  end
+
+  it "should marshal object on set" do
+    @mr.set "rabbit", @white_rabbit
+    @mr.get("rabbit").should === @white_rabbit
+  end
+
+  it "should not unmarshal object on get if raw option is true" do
+    @mr.get("rabbit", :raw => true).should == "\004\bU:\017OpenStruct{\006:\tname\"\nbunny"
+  end
+
+  it "should not marshal object on set if raw option is true" do
+    @mr.set "rabbit", @white_rabbit, :raw => true
+    @mr.get("rabbit", :raw => true).should == %(#<OpenStruct color="white">)
+  end
+
+  it "should not set an object if already exist" do
+    @mr.set_unless_exists "rabbit", @white_rabbit
+    @mr.get("rabbit").should === @rabbit
+  end
+
+  it "should marshal object on set_unless_exists" do
+    @mr.set_unless_exists "rabbit2", @white_rabbit
+    @mr.get("rabbit2").should === @white_rabbit
+  end
+
+  it "should not marshal object on set_unless_exists if raw option is true" do
+    @mr.set_unless_exists "rabbit2", @white_rabbit, :raw => true
+    @mr.get("rabbit2", :raw => true).should == %(#<OpenStruct color="white">)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+$: << File.join(File.dirname(__FILE__), "/../lib")
+require "rubygems"
+require "ostruct"
+require "spec"
+require "redis"
+require "merb"
+require "redis-store"
+require "activesupport"
+require "cache/rails/redis_store"

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification 
+name: jodosha-redis-store
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+platform: ruby
+authors: 
+- Luca Guidi
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-04-16 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Redis cache and session stores for Ruby web frameworks
+email: guidi.luca@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.textile
+files: 
+- MIT-LICENSE
+- README.textile
+- Rakefile
+- lib/cache/merb/redis_store.rb
+- lib/cache/rails/redis_store.rb
+- lib/redis-store.rb
+- lib/redis/distributed_marshaled_redis.rb
+- lib/redis/marshaled_redis.rb
+- redis-store.gemspec
+- spec/cache/merb/redis_store_spec.rb
+- spec/cache/rails/redis_store_spec.rb
+- spec/config/master.conf
+- spec/config/single.conf
+- spec/config/slave.conf
+- spec/redis/distributed_marshaled_redis_spec.rb
+- spec/redis/marshaled_redis_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://lucaguidi.com
+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.2.0
+signing_key: 
+specification_version: 2
+summary: Redis cache and session stores for Ruby web frameworks
+test_files: 
+- spec/cache/merb/redis_store_spec.rb
+- spec/cache/rails/redis_store_spec.rb
+- spec/redis/distributed_marshaled_redis_spec.rb
+- spec/redis/marshaled_redis_spec.rb