redisent 0.0.1

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2012 Michel Martens
+
+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

@@ -0,0 +1,44 @@
+redisent
+====
+
+Sentinel aware Redis client.
+
+Description
+-----------
+
+Redisent is a wrapper for the Redis client that fetches configuration
+details from sentinels.
+
+## Usage
+
+Instead of passing a Redis URL, you have to pass an array with the
+URLs of your Redis sentinels as the first parameter, then the name
+of your master server (as defined in the sentinels configuration) as
+the second parameter, and finally a hash of options to be used when
+connecting to the master.
+
+```ruby
+# List of sentinels.
+sentinels = ["redis://localhost:27379/",
+             "redis://localhost:27380/",
+             "redis://localhost:27381/"]
+
+# Master server name as defined in sentinel.conf.
+master = "server-1"
+
+# Additional options for the master server.
+options = { :timeout => 5, :password => "abcd" }
+
+redis = Redisent.new(sentinels, master, options)
+```
+
+If the sentinels can't be reached, or if there is no master available,
+you will get the exception `Redis::CannotConnectError`.
+
+## Installation
+
+You can install it using rubygems:
+
+```
+$ gem install redisent
+```

data/lib/redisent.rb

@@ -0,0 +1,23 @@
+require "redis"
+
+module Redisent
+  def self.new(sentinels, master, options = {})
+    sentinels.each do |sentinel|
+      begin
+        master = find_master(sentinel, master, options)
+        return master if master
+      rescue Redis::CannotConnectError
+      end
+    end
+
+    raise Redis::CannotConnectError
+  end
+
+  def self.find_master(sentinel, master, options)
+    redis = Redis.new(url: sentinel)
+
+    host, port = redis.sentinel("get-master-addr-by-name", master)
+
+    Redis.new(options.merge(:host => host, :port => port))
+  end
+end

data/test/redisent_test.rb

@@ -0,0 +1,38 @@
+require File.expand_path("../lib/redisent", File.dirname(__FILE__))
+
+test "basics" do |redis|
+  redis = Redisent.new(
+    ["redis://localhost:27378/",
+     "redis://localhost:27379/",
+     "redis://localhost:27380/",
+     "redis://localhost:27381/"],
+    "server-1", :timeout => 5)
+
+  redis.set("foo", 1)
+
+  assert_equal "1", redis.get("foo")
+  assert_equal "6379", redis.info["tcp_port"]
+  assert_equal 5.0, redis.client.timeout
+end
+
+test "no available sentinel" do
+  assert_raise Redis::CannotConnectError do
+    redis = Redisent.new(
+      ["redis://localhost:27478/",
+       "redis://localhost:27479/",
+       "redis://localhost:27480/",
+       "redis://localhost:27481/"],
+      "server-1")
+  end
+end
+
+test "no available master" do
+  assert_raise Redis::CannotConnectError do
+    redis = Redisent.new(
+      ["redis://localhost:27478/",
+       "redis://localhost:27479/",
+       "redis://localhost:27480/",
+       "redis://localhost:27481/"],
+      "server-2")
+  end
+end

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification
+name: redisent
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Michel Martens
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-10-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: redis
+  requirement: &2155997400 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2155997400
+- !ruby/object:Gem::Dependency
+  name: cutest
+  requirement: &2155996720 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2155996720
+description: Redisent is a wrapper for the Redis client that fetches configuration
+  details from sentinels.
+email:
+- michel@soveran.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README
+- lib/redisent.rb
+- test/redisent_test.rb
+homepage: https://github.com/soveran/redisent
+licenses:
+- MIT
+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: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: Sentinel aware Redis client.
+test_files: []