instructure-redis-store 1.0.0.1.instructure1

data/.travis.yml

@@ -0,0 +1,7 @@
+bundler_args: "--without development"
+script: "bundle exec rake"
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - jruby
+  - rbx

data/CHANGELOG

@@ -0,0 +1,311 @@
+*1.0.0.1 (September 6, 2011)*
+
+  * Bump version v1.0.0.1
+
+*1.0.0 (September 1, 2011)*
+
+  * Bump version v1.0.0
+  * Avoid encoding issues when sending strings to Redis. [Damian Janowski]
+  * Fixed a bug that caused all the users to share the same session (with a session_id of 0 or 1) [Mathieu Ravaux]
+  * ActiveSupport cache stores reply to read_multi with a hash, not an array. [Matt Griffin]
+  * Rack::Session && Rack::Cache store can be created with options [aligo]
+  * add destroy_session [aligo]
+  * compatible with rails 3.1. rely on Rack::Session::Redis stores API. [aligo]
+  * Fixed Marshalling semantic
+
+*1.0.0 [rc1] (June 5, 2011)*
+
+  * Bump version v1.0.0.rc1
+  * Re-implement the delete_entry because it s needed by the ActiveSupport::Cache [Cyril Mougel]
+  * Change readme documentation for rack-cache to use single redis database with namespace support per Redis maintainers recommendation [Travis D. Warlick, Jr.]
+  * Rack-Cache entity and meta store base classes should use the Redis::Factory.convert_to_redis_client_options method for DRYness and for namespace support [Travis D. Warlick, Jr.]
+  * Modify #fetch for cache stores to return the yielded value instead of OK [Rune Botten]
+  * Minor revisions to Readme language and organization [Jeff Casimir]
+  * Re-implement the delete_entry because it s needed by the ActiveSupport::Cache implementation in Rails 3 [Cyril Mougel]
+  * Refactor delete_matched [Andrei Kulakov]
+
+*1.0.0 [beta5] (April 2, 2011)*
+
+  * Bump version v1.0.0.beta5
+  * Introducing Rails.cache.reconnect, useful for Unicorn environments. Closes #21
+  * Namespaced i18n backend should strip namespace when lists available locales. Closes #62
+  * how to configure Redis session store in Sinatra [Christian von Kleist]
+  * gracefully handle Connection Refused errors, allows database fall-back on fetch [Michael Kintzer]
+  * Sinatra's API must have changed, its registered not register. [Michael D'Auria]
+
+*1.0.0 [beta4] (December 15, 2010)*
+
+  * Bump version v1.0.0.beta4
+  * Force Rails cache store when ActiveSupport is detected
+  * Make sure to accept options when :servers isn't passed
+  * Always force session store loading when using Rails
+  * Make it compatible with Rails 3 sessions store [Andre Medeiros]
+  * Better Rails 3 detection [Andre Medeiros]
+  * Added support for password in Redis URI resolution [Jacob Gyllenstierna]
+  * fix deleting values from session hash [Calvin Yu]
+  * Use defensive design when build options for a store
+  * ActiveSupport cache store doesn't accept any argument in Rails 2
+  * Updated dependencies
+
+*1.0.0 [beta3] (September 10, 2010)*
+
+  * Bump version v1.0.0.beta3
+  * Updated gemspec
+  * Made compatible with Ruby 1.9.2
+  * Made compatible with Rails 3
+  * Making the redis-store rails session store compatible with Rails 2.3.9. [Aaron Gibralter]
+  * Updated to v2.3.9 the development dependencies for Rails 2.x
+  * Added password support
+  * Set default URI string for Rack session store according to redis gem
+  * Require redis:// scheme as mandatory part of URI string
+  * Updated locked dependencies
+  * Added namespace support for Redis::DistrubutedStore
+  * Specs for Interface module
+  * Moved a spec to reflect lib/ structure
+  * Made specs run again with bundler-1.0.0.rc.2
+  * Prepare for bundler-1.0.0.rc.1
+  * Use tmp/ for Redis database dumps
+  * README, gemspec
+  * Lookup for scoped keys
+  * Introducing I18n::Backend::Redis
+  * Don't pollute Redis namespace. closes #16
+  * Don't look twice for Rails module
+  * Fixed loading ActionDispatch::Session issue with Rails 3
+  * ActiveSupport cache now uses new Rails 3 namespace API
+  * Let Rack::Cache entity store to use plain Redis client
+  * CHANGELOG
+  * Gemspec
+  * Redis::DistributedMarshaled => Redis::DistributedStore
+  * Extracted expiration logic in Redis::Ttl
+  * Introducing Redis::Store and extracted marshalling logic into Redis::Marshalling
+  * CHANGELOG
+  * Gemspec
+  * Removed superfluous specs. Documentation.
+  * Made the specs pass with Ruby 1.9.2 and Rails 3
+  * Made the specs pass with Ruby 1.9.2
+  * Prepare specs for Ruby 1.9.2
+  * Made the specs pass for Rails 3
+  * Namespaced keys for ActiveSupport::Cache::RedisStore
+  * Got RedisSessionStore working again with namespace
+  * Delegate MarshaledClient#to_s decoration to Redis::Namespace
+  * Redis::Namespace
+  * Accept :namespace option when instantiate a store
+  * Test against merb-1.1.0 for now
+  * Updated Rake tasks for Redis installation
+  * Advanced configurations for Rails in README. closes #8
+  * Locked gems
+  * Changed the gemspec according to the new directories structure
+  * Changed directories structure, according to the ActiveSupport loading policies
+  * Typo in CHANGELOG
+
+*1.0.0 [beta2] (June 12, 2010)*
+
+  * Bump version v1.0.0.beta2
+  * Added committers names to CHANGELOG
+  * Added CHANGELOG
+  * Rake namespace: redis_cluster => redis:cluster
+  * Fixed Rails 3 failing spec
+  * Added ActiveSupport::Cache::RedisStore#read_multi
+  * Enabled notifications for ActiveSupport::Cache::RedisStore
+  * Moved spec
+  * Use consistent Rails 3 check in session store
+  * Make sure of use top-level module
+  * Updated Rails 2.x development dependencies
+
+*1.0.0 [beta1] (June 9, 2010)*
+
+  * Bump version v1.0.0.beta1
+  * Made specs pass for Ruby 1.9.1
+  * Updated instructions to test against Rails 3.x
+  * Updated copyright year
+  * Prepare for v1.0.0.beta1
+  * Use Rails v3.0.0.beta4
+  * Require redis >= 2.0.0 gem in Gemfile
+  * Updated instructions for Rails 2 session store
+  * Added instructions for Rails 3 configuration
+  * Check against Rails#version instead of Rails::VERSION::STRING
+  * Added redis gem as dependency
+  * Changed spec_helper.rb according to the new Rails 3 check
+  * Fix the rails3 check [Bruno Michel]
+  * Added bundler cleanup Rake task
+  * Fixed ActiveSupport::Cache::RedisStore#fetch
+  * Re-enabled redis:console Rake task
+  * Don't use Rspec#have with ActiveSupport 3
+  * Fixed Rails 2 regression for ActiveSupport::Cache::RedisStore#delete_matched
+  * Fixed issues for ActiveSupport::Cache::RedisStore #delete_matched, #read, #rwrite
+  * Rails 3 namespace
+  * Use Rails edge instead of 3.0.0.beta3
+  * Made the specs run again
+  * Updated Gemfile development/test dependencies for rails3.
+  * Updated README instructions
+  * Updated test configuration files, according to redis-2.0.0-rc1 defaults
+  * Made specs pass with redis-2.0.0 gem
+  * Don't support the old redis-rb namespace
+  * Import the whole redis-rb old Rake tasks
+  * Updated redis-rb dependency
+
+*0.3.8 [Final] (May 21, 2010)*
+
+  * Fixed gemspec executable issue
+  * Updated .gemspec
+  * Version bump to 0.3.8
+  * Started namespace migration for redis-2.0.0
+  * Merge branch 'master' of http://github.com/akahn/redis-store
+  * Fixed dependency issues. [Brian Takita]
+  * Removed methopara because it require ruby 1.9.1. [Brian Takita]
+  * Merge branch 'master' of http://github.com/dsander/redis-store [Brian Takita]
+  * Moved RedisSessionStore to rack session directory. [Brian Takita]
+  * Got RedisSessionStore working with passing specs. [Brian Takita]
+  * Using modified version of RedisSessionStore (http://github.com/mattmatt/redis-session-store). Still needs testing. [Brian Takita]
+  * Using redis 1.0.5. [Brian Takita]
+  * Ignoring gem files and gemspecs with a prefix. [Brian Takita]
+  * Added git and jeweler to dependencies. [Brian Takita]
+  * Ignoring .bundle and rubymine files. [Brian Takita]
+  * Added ability to add a prefix to the gem name via the GEM_PREFIX environment variable. [Brian Takita]
+  * Fixed marshalling issues with the new Redis api. Fixed redis-server configurations for the latest version of redis-server. Added redis_cluster:start and redis_cluster:stop rake tasks. Spec suite passes. [Brian Takita]
+  * Fixed redis deprecation warnings. [Brian Takita]
+  * Using redis 1.0.4. Loading redis.tasks.rb from redis gem using Bundler. Fixed redis test configurations. [Brian Takita]
+  * Supports redis 1.0.5 [Dominik Sander]
+  * Add Rack::Session::Redis usage for Sinatra to README [Alexander Kahn]
+  * Updated development and testing dependencies
+  * Made compatible with rack-cache-0.5.2
+
+*0.3.7 [Final] (November 15, 2009)*
+
+  * Version bump to 0.3.7
+  * Version bump to 0.3.7
+  * Updated spec instructions in README
+  * Jeweler generated redis-store.gemspec
+  * Removed no longer used Rake tasks. Added Gemcutter support via Jeweler.
+  * Typo
+  * Let Rcov task run with the Redis cluster started
+  * Make spec suite pass again
+  * README.textile -> README.md
+  * Re-enabled Merb specs
+  * Added *.rdb in .gitignore
+  * Run detached Redis instances for spec suite
+  * Start detached Redis server for specs
+  * Added Gemfile, removed rubygems dependecy for testing.
+  * Added *.swp to .gitignore
+  * Added jeweler rake tasks
+  * Make it work in classic Sinatra apps. [Dmitriy Timokhin]
+  * Updated README with new instructions about redis-rb
+
+*0.3.6 [Final] (June 18, 2009)*
+
+  * Prepare for v0.3.6
+  * Updated README with new version
+  * Changed Redis config files for specs
+  * Updated README instructions
+  * New filelist in gemspec
+  * Fixed typo in spec
+  * Don't try to unmarshal empty strings
+  * Running specs according to the DEBUG env var
+  * Added specs for uncovered Merb Cache API
+  * Added rcov Rake task
+  * Fix README
+  * Fix typo in README
+  * Updated README instructions
+  * Removed RedisError catching
+  * Declaring for now RedisError in spec_helper.rb
+  * Removed unnecessary classes
+  * Fix specs for DistributedMarshaledRedis
+  * Fix some specs
+  * Made Server#notify_observers private
+  * Ensure to select the correct database after the socket connection
+  * Reverted socket pooling. Ensure to always return an active socket.
+  * Lowering default timeout from 10 to 0.1
+
+*0.3.5 [Final] (May 7, 2009)*
+
+  * Prepare for v0.3.5
+  * Totally replace ezmobius-redis-rb Server implementation
+  * Fixed default Server timeout to 1 second
+  * Little refactoring
+  * Ensure Server#active? always returns a boolean and never raise an exception
+  * Made configurable connection pool timeout and size
+  * Socket connection pooling
+  * Updated README
+
+*0.3.0 [Final] (May 3, 2009)*
+
+  * Prepare for v0.3.0
+  * README formatting issues
+  * README formatting (again)
+  * README formatting
+  * Updated Rack::Session instructions for Sinatra
+  * Make Rack::Session implementation working with Merb
+  * Added instructions for Rack::Session
+  * Expiration support for Rack::Session
+  * Ensure to test Rails and Sinatra expiration implementations with both MarshaledRedis and DistrbutedMarshaledRedis
+  * Expiration support for Merb::Cache
+  * Use full qualified class names in specs. Minor spec fix.
+  * Ported for foreword compatibility the expiration implementation from ezmobius/redis-rb
+  * Little spec cleanup
+  * Full support for Rack::Session
+  * Extracted some logic into RedisFactory
+  * Initial support for Rack::Session
+
+*0.2.0 [Final] (April 30, 2009)*
+
+  * Prepare for v0.2.0
+  * Links in README
+  * Maybe someday I will use the right formatting rules at first attempt
+  * Still formatting README
+  * Formatting for README
+  * Updated instructions for Rack::Cache
+  * Don't require any cache store if no Ruby framework is detected
+  * Implemented EntityStore for Rack::Cache
+  * Added REDIS constant for Rack::Cache::Metastore
+  * MetaStore implementation for Rack::Cache
+
+*0.1.0 [Final] (April 30, 2009)*
+
+  * Prepare for v0.1.0
+  * Sinatra cache support
+
+*0.0.3 [Final] (April 30, 2009)*
+
+  * Prepare for v0.0.3
+  * Updated instructions for Merb
+  * Hack for Merb cyclic dependency
+  * Renaming main lib
+  * Merb store #writable always returns true. Added pending test.
+  * Merb store #fetch refactoring
+  * Updated Redis installation instructions
+  * Implemented #fetch for Merb store
+  * Implemented #exists?, #delete and #delete_all for Merb cache store
+  * Renamed project name in Rakefile
+  * Updated project name in README
+  * Updated README with Merb instructions
+  * Changed name in gemspec
+  * New gemspec
+  * Initial cache store support for Merb
+  * Moving files around
+  * Don't complain about missing db in tmp/
+
+*0.0.2 [Final] (April 16, 2009)*
+
+  * Prepare for v0.0.2
+  * Updated file list in gemspec
+  * Updated README instructions
+  * Re-enabled spec for RedisStore#fetch
+  * Update rdoc
+  * Fix RedisStore#clear when use a cluster
+  * Test RedisStore both with single server and with a cluster
+  * Fix port in DistributedMarshaledRedis spec
+  * Don't slave Redis cluster node
+  * Changed Redis cluster configuration
+  * Added configuration for Redis cluster
+  * Use a distributed system if the store uses more than one server
+  * Accept params for client connection
+
+*0.0.1 [Final] (April 11, 2009)*
+
+  * Added :unless_exist option to #write
+  * Added failing specs for :expires_in option
+  * Made optional args compatible with the Cache interface
+  * Implemented #delete_matched, #clear, #stats
+  * Implemented #delete, #exist?, #increment, #decrement
+  * Introduced RedisStore
+  * Initial import

data/Gemfile

@@ -0,0 +1,34 @@
+source :gemcutter
+gem "redis", "3.0.1"
+
+group :development do
+  gem "jeweler"
+  gem "git"
+end
+
+group :development, :test, :rails3 do
+  gem "rack-cache"
+  gem "merb", "1.1.0"
+  gem "rspec", "1.3.0"
+  gem "i18n"
+
+  if RUBY_VERSION > '1.9'
+    gem "methopara" # required by merb.
+  else
+    gem "ruby-debug" # linecache isn't compatible with 1.9.2 yet.
+  end
+end
+
+if ENV["REDIS_STORE_ENV"] == "rails3"
+  group :rails3 do
+    gem "rack", "~> 1.2.1"
+    gem "activesupport", "3.0.5"
+    gem "actionpack", "3.0.5"
+  end
+else
+  group :test do
+    gem "rack", "~> 1.1.0"
+    gem "activesupport", "2.3.11"
+    gem "actionpack", "2.3.11"
+  end
+end

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 - 2011 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,239 @@
+# Namespaced Rack::Session, Rack::Cache, I18n and cache Redis stores for Ruby web frameworks
+
+## Installation
+
+### Redis, Option 1: Homebrew
+
+MacOS X users should use [Homebrew](https://github.com/mxcl/homebrew) to install Redis:
+
+    brew install redis
+
+### Redis, Option 2: From Source
+
+Download and install Redis from [http://code.google.com/p/redis/](http://code.google.com/p/redis/)
+
+    wget http://redis.googlecode.com/files/redis-2.0.0.tar.gz
+    tar -zxf redis-2.0.0.tar.gz
+    mv redis-2.0.0 redis
+    cd redis
+    make
+
+### Install the Gem
+
+Assuming you're using RVM or on Windows, install the gem with:
+
+    gem install redis-store
+
+## Options
+You can specify the Redis configuration details using a URI or a hash.  By default the gem will attempt to connect to `localhost` port `6379` and the db `0`.
+
+### Set by URI
+
+For example
+
+    "redis://:secret@192.168.1.100:23682/13/theplaylist"
+
+Made up of the following:
+
+    host: 192.168.1.100
+    port: 23682
+    db: 13
+    namespace: theplaylist
+    password: secret
+
+If you want to specify the `namespace` option, you have to pass the `db` param too.
+#### __Important__: `namespace` is only supported for single, non-distributed stores.
+
+### Set by Hash
+
+    { :host => 192.168.1.100, :port => 23682, :db => 13, :namespace => "theplaylist", :password => "secret" }
+
+#### __Important__: `namespace` is only supported for single, non-distributed stores.
+
+## Cache store
+
+Provides a cache store for your Ruby web framework of choice.
+
+### Rails 2.x
+
+    config.gem "redis-store"
+    config.cache_store = :redis_store
+
+### Rails 2.x (with Bundler)
+
+    # Gemfile
+    gem "redis-store"
+
+    # in your configuration
+    config.gem "redis-store"
+    config.cache_store = :redis_store, { ... optional configuration ... }
+
+### Rails 3.x
+
+    # Gemfile
+    gem 'redis'
+    gem 'redis-store', '1.0.0.1'
+
+    # config/environments/production.rb
+    config.cache_store = :redis_store, { ... optional configuration ... }
+
+For advanced configurations scenarios please visit [the wiki](https://github.com/jodosha/redis-store/wiki/Frameworks-Configuration).
+
+### Merb
+
+    dependency "redis-store", "1.0.0.1"
+    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
+        settings.cache.fetch("greet") { "Hello, World!" }
+      end
+    end
+
+Keep in mind that the above fetch will return "OK" on success, not the return of the block.
+
+For advanced configurations scenarios please visit [the wiki](https://github.com/jodosha/redis-store/wiki/Frameworks-Configuration).
+
+## 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 2.x
+
+    # config/environment.rb
+    config.gem "redis-store"
+
+    # then configure as following:
+
+    # config/environments/*.rb
+    config.cache_store = :redis_store
+
+    # or
+
+    # config/initializers/session_store.rb
+    ActionController::Base.session = {
+      :key         => APPLICATION['session_key'],
+      :secret      => APPLICATION['session_secret'],
+      :key_prefix  => Rails.env
+    }
+
+    ActionController::Base.session_store = :redis_session_store
+
+### Rails 2.x (with Bundler)
+
+    # Gemfile
+    gem "redis-store"
+
+    # then configure as following:
+
+    # config/environments/*.rb
+    config.cache_store = :redis_store
+
+    # or
+
+    # config/initializers/session_store.rb
+    ActionController::Base.session = {
+      :key         => APPLICATION['session_key'],
+      :secret      => APPLICATION['session_secret'],
+      :key_prefix  => Rails.env
+    }
+
+    ActionController::Base.session_store = :redis_session_store
+
+### Rails 3.x
+
+    # Gemfile
+    gem 'rails', '3.0.3'
+    gem 'redis'
+    gem 'redis-store', '1.0.0.1'
+
+    # config/initializers/session_store.rb
+    MyApp::Application.config.session_store :redis_session_store
+
+For advanced configurations scenarios please visit [the wiki](https://github.com/jodosha/redis-store/wiki/Frameworks-Configuration).
+
+### Merb
+
+    dependency "redis-store", "1.0.0.1"
+    Merb::Config.use do |c|
+      c[:session_store] = "redis"
+    end
+    Merb::BootLoader.before_app_loads do
+      Merb::SessionContainer.subclasses << "Merb::RedisSession"
+    end
+
+### Sinatra
+
+    require "sinatra"
+    require "redis-store"
+
+    class MyApp < Sinatra::Base
+      use Rack::Session::Redis, :redis_server => 'redis://127.0.0.1:6379/0' # Redis server on localhost port 6379, database 0
+
+      get "/" do
+        session[:visited_at] = DateTime.now.to_s # This is stored in Redis
+        "Hello, visitor."
+      end
+    end
+
+For advanced configurations scenarios please visit [the wiki](https://github.com/jodosha/redis-store/wiki/Frameworks-Configuration).
+
+## 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/metastore',
+      :entitystore => 'redis://localhost:6380/0/entitystore'
+    run Application.new
+
+## I18n
+
+    require "i18n"
+    require "redis-store"
+    I18n.backend = I18n::Backend::Redis.new
+
+The backend accepts the uri string and hash options.
+
+## Unicorn
+
+Use `Rails.cache.reconnect` in your Unicorn hooks, in order to force the client reconnection.
+
+## Running specs
+
+    gem install jeweler bundler
+    git clone git://github.com/jodosha/redis-store.git
+    cd redis-store
+    bundle install
+    REDIS_STORE_ENV=rails3 bundle install # to install Rails 3 gems
+    rake dtach:install
+    rake redis:install
+    rake
+    REDIS_STORE_ENV=rails3 rake # to test against Rails 3
+
+If you are on **Snow Leopard** you have to run `env ARCHFLAGS="-arch x86_64" bundle install`
+
+## Copyright
+
+(c) 2009 - 2011 Luca Guidi - [http://lucaguidi.com](http://lucaguidi.com), released under the MIT license