xlymian-redis-store 0.3.8

data/.gitignore

@@ -0,0 +1,7 @@
+*.rdb
+*.swp
+bin/
+coverage/
+pkg/
+vendor/
+tmp/

data/Gemfile

@@ -0,0 +1,13 @@
+gem "redis", "0.1.1"
+
+# testing gems
+only :testing do
+  gem "ruby-debug"
+  gem "rspec"
+  gem "rack", "1.1.0"
+  gem "rack-cache"
+  gem "activesupport"
+  gem "merb"
+end
+
+disable_system_gems

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.md

@@ -0,0 +1,105 @@
+# Rack::Session, Rack::Cache and cache Redis stores for Ruby web frameworks
+
+## Installation
+
+Download and install Redis from [http://code.google.com/p/redis/](http://code.google.com/p/redis/)
+
+    curl -OL http://redis.googlecode.com/files/redis-1.02.tar.gz
+    tar -zxvf redis-1.02.tar.gz
+    mv redis-1.02 redis
+    cd redis
+    make
+
+Install the gems
+
+    sudo gem install redis-rb redis-store
+
+## Cache store
+
+Provides a cache store for your Ruby web framework of choice.
+
+### Rails
+
+    config.gem "redis-store", :source => "http://gemcutter.org", :lib => "redis-store"
+    require "redis-store"
+    config.cache_store = :redis_store
+
+### Merb
+
+    dependency "redis-store", "0.3.7"
+    dependency("merb-cache", merb_gems_version) do
+      Merb::Cache.setup do
+        register(:redis, Merb::Cache::RedisStore, :servers => ["127.0.0.1:6379"])
+      end
+    end
+
+### Sinatra
+
+    require "sinatra"
+    require "redis-store"
+    class MyApp < Sinatra::Base
+      register Sinatra::Cache
+      get "/hi" do
+        cache.fetch("greet") { "Hello, World!" }
+      end
+    end
+
+## Rack::Session
+
+Provides a Redis store for Rack::Session. See [http://rack.rubyforge.org/doc/Rack/Session.html](http://rack.rubyforge.org/doc/Rack/Session.html)
+
+### Rack application
+
+    require "rack"
+    require "redis-store"
+    require "application"
+    use Rack::Session::Redis
+    run Application.new
+
+### Rails
+
+    config.gem "redis-store", :source => "http://gemcutter.org", :lib => "redis-store"
+    ActionController::Base.session_store = Rack::Session::Redis
+
+### Merb
+
+    dependency "redis-store", "0.3.7"
+    Merb::Config.use do |c|
+      c[:session_store] = "redis"
+    end
+    Merb::BootLoader.before_app_loads do
+      Merb::SessionContainer.subclasses << "Merb::RedisSession"
+    end
+
+### Sinatra
+
+Sorry, but Sinatra application boot system [hardcode](http://github.com/sinatra/sinatra/blob/0f02bafe86f8dd9bba9ab425468cb1067caa83ff/lib/sinatra/base.rb#L785) `Rack::Session::Cookie`
+
+## Rack::Cache
+
+Provides a Redis store for HTTP caching. See [http://github.com/rtomayko/rack-cache](http://github.com/rtomayko/rack-cache)
+
+    require "rack"
+    require "rack/cache"
+    require "redis-store"
+    require "application"
+    use Rack::Cache,
+      :metastore   => 'redis://localhost:6379/0',
+      :entitystore => 'redis://localhost:6380/1'
+    run Application.new
+
+## Running specs
+
+    gem install jeweler bundler
+    git clone git://github.com/jodosha/redis-store.git
+    cd redis-store
+    gem bundle
+    rake dtach:install
+    rake redis:install
+    rake
+
+If you are on **Snow Leopard** you have to run `env ARCHFLAGS="-arch x86_64" gem bundle`
+
+## Copyright
+
+(c) 2009 Luca Guidi - [http://lucaguidi.com](http://lucaguidi.com), released under the MIT license

data/Rakefile

@@ -0,0 +1,57 @@
+$:.unshift 'lib'
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'spec/rake/spectask'
+
+task :default => "spec:suite"
+
+begin
+  require "jeweler"
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name        = "xlymian-redis-store"
+    gemspec.summary     = "Rack::Session, Rack::Cache and cache Redis stores for Ruby web frameworks."
+    gemspec.description = "Rack::Session, Rack::Cache and cache Redis stores for Ruby web frameworks."
+    gemspec.email       = "guidi.luca@gmail.com"
+    gemspec.homepage    = "http://github.com/xlymian/redis-store"
+    gemspec.authors     = [ "Luca Guidi" ]
+  end
+
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install jeweler" 
+end
+
+namespace :spec do
+  desc "Run all the examples by starting a detached Redis instance"
+  task :suite do
+    invoke_with_redis_cluster "spec:run"
+  end
+
+  Spec::Rake::SpecTask.new(:run) do |t|
+    t.spec_files = FileList['spec/**/*_spec.rb']
+    t.spec_opts = %w(-fs --color)
+  end
+end
+
+desc "Run all examples with RCov"
+task :rcov do
+  invoke_with_redis_cluster "rcov_run"
+end
+
+Spec::Rake::SpecTask.new(:rcov_run) do |t|
+  t.spec_files = FileList['spec/**/*_spec.rb']
+  t.rcov = true
+end
+
+# courtesy of http://github.com/ezmobius/redis-rb team
+load "tasks/redis.tasks.rb"
+def invoke_with_redis_cluster(task_name)
+  begin
+    result = RedisClusterRunner.start_detached
+    raise("Could not start redis-server, aborting.") unless result
+    Rake::Task[task_name].invoke
+  ensure
+    RedisClusterRunner.stop
+  end
+end

data/VERSION

@@ -0,0 +1 @@
+0.3.8

data/lib/cache/merb/redis_store.rb

@@ -0,0 +1,63 @@
+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 = {})
+        @data = RedisFactory.create config[:servers]
+      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
+        # 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,109 @@
+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)
+        @data = RedisFactory.create(addresses)
+      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
+    end
+  end
+end

data/lib/cache/sinatra/redis_store.rb

@@ -0,0 +1,111 @@
+module Sinatra
+  module Cache
+    class << self
+      def register(app)
+        app.set :cache, RedisStore.new
+      end
+    end
+
+    class RedisStore
+      # 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)
+        @data = RedisFactory.create addresses
+      end
+
+      def write(key, value, options = nil)
+        method = options && options[:unless_exist] ? :set_unless_exists : :set
+        @data.send method, key, value, options
+      end
+
+      def read(key, options = nil)
+        @data.get key, options
+      end
+
+      def delete(key, options = nil)
+        @data.delete key
+      end
+
+      def exist?(key, options = nil)
+        @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)
+        @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)
+        @data.decr key, amount
+      end
+
+      # Delete objects for matched keys.
+      #
+      # Example:
+      #   cache.delete_matched "rab*"
+      def delete_matched(matcher, options = nil)
+        @data.keys(matcher).each { |key| @data.delete key }
+      end
+
+      def fetch(key, options = {})
+        (!options[:force] && data = read(key, options)) || (write key, yield, options if block_given?)
+      end
+
+      # Clear all the data from the store.
+      def clear
+        @data.flush_db
+      end
+
+      def stats
+        @data.info
+      end
+    end
+  end
+end