ruby-redis 0.0.1

data/LICENSE

@@ -0,0 +1,9 @@
+Copyright (c) 2011, David Turnbull et al
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README

@@ -0,0 +1,90 @@
+This project was started because I needed an authenticating and routable
+proxy for Redis.  The main feature is a high-performance, evented, pure-Ruby,
+implementation of the complete Redis wire protocol with the same interface as
+hiredis/reader.
+
+In the worst possible scenario of very small payloads, I was benching 30k GETs
+per second with pure ruby and 40k/s with hiredis/reader.  With larger payloads,
+the performance gap narrows to zero.  Not near-zero, actual zero.
+
+Ruby Gem:
+
+gem install ruby-redis
+
+
+Server:
+
+# Runs a server that looks and feels like the C redis-server
+bin/ruby-redis
+# Run the TCL test suite from C Redis against the Ruby server
+src/redis-test
+
+
+Client example:
+
+require 'redis'
+EventMachine.run {
+  redis = EventMachine.connect '127.0.0.1', 6379, Redis
+  # Subscribe and publish messages will call here
+  redis.pubsub_callback do |message|
+    # case message[0]
+    # when 'psubscribe' ...
+  end
+  # All commands implemented uniformly with method_missing
+  # Returns instance of Redis::Command < EventMachine::Deferrable 
+  # Pipelining is implicit
+  redis.set :pi, 3.14159
+  redis.get('pi') do |result|
+    p result
+  end
+  redis.blpop('mylist', 1).callback do |result|
+    p result
+    EM.stop
+  end.errback do |e|
+    EM.stop
+    raise e
+  end
+}
+
+
+Using hiredis/reader (only affects clients):
+
+# require it before you connect
+require 'hiredis/reader'
+
+
+Fibers; compatible with em-synchrony:
+
+require 'redis/synchrony'
+Redis.synchrony {
+  # Use redis to pipeline and sync to block
+  redis = EventMachine.connect '127.0.0.1', 6379, Redis, :hiredis => true
+  sync = redis.synchrony
+  # repeat transaction until success
+  reply = nil
+  until reply
+    redis.watch 'mykey' # never fails, use pipeline
+    x = sync.get('mykey').to_i
+    reply = sync.multi_exec do |multi|
+      # multi is pipelined (async)
+      # no reason to block in here
+      multi.set 'mykey', x + 1
+    end
+  end
+  redis.close
+  p reply
+  EM.stop
+}
+
+
+Ruby to Redis type conversions:
+
+      String === Status reply
+RuntimeError === Error reply
+      String === Bulk reply
+     Integer === Integer reply
+       Array === Multi-bulk reply
+        Hash === Multi-bulk reply to hgetall
+    NilClass === Nil element or nil multi-bulk
+   TrueClass === :1
+  FalseClass === :0

data/bin/ruby-redis

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+begin
+  require 'rubygems'
+rescue LoadError
+end
+direct_bin_filename = File.expand_path '../lib/redis/bin', File.dirname(__FILE__)
+if File.exist? direct_bin_filename + '.rb'
+  require direct_bin_filename
+else
+  require 'redis/bin'
+end
+Redis::Bin.server

data/bin/ruby-redis.compiled.rbc

@@ -0,0 +1,243 @@
+!RBIX
+6235178746665710376
+x
+M
+1
+n
+n
+x
+10
+__script__
+i
+115
+26
+93
+0
+15
+29
+18
+0
+5
+7
+0
+64
+47
+49
+1
+1
+30
+8
+45
+26
+93
+1
+15
+24
+13
+45
+2
+3
+12
+49
+4
+1
+10
+35
+8
+40
+15
+1
+25
+8
+45
+15
+92
+1
+27
+34
+92
+0
+27
+15
+45
+5
+6
+7
+7
+64
+45
+5
+8
+65
+49
+9
+0
+49
+10
+1
+49
+11
+2
+19
+0
+15
+45
+5
+12
+20
+0
+7
+13
+64
+81
+14
+49
+15
+1
+9
+95
+5
+20
+0
+47
+49
+1
+1
+8
+103
+5
+7
+16
+64
+47
+49
+1
+1
+15
+45
+17
+18
+43
+19
+49
+20
+0
+15
+2
+11
+I
+7
+I
+1
+I
+0
+I
+0
+n
+p
+21
+s
+8
+rubygems
+x
+7
+require
+x
+9
+LoadError
+n
+x
+3
+===
+x
+4
+File
+n
+s
+16
+../lib/redis/bin
+n
+x
+11
+active_path
+x
+7
+dirname
+x
+11
+expand_path
+n
+s
+3
+.rb
+x
+1
++
+x
+6
+exist?
+s
+9
+redis/bin
+x
+5
+Redis
+n
+x
+3
+Bin
+x
+6
+server
+p
+21
+I
+0
+I
+3
+I
+12
+I
+0
+I
+17
+I
+4
+I
+2d
+I
+0
+I
+31
+I
+6
+I
+47
+I
+7
+I
+56
+I
+8
+I
+5f
+I
+a
+I
+67
+I
+0
+I
+68
+I
+c
+I
+73
+x
+47
+/Users/dturnbull/ruby/ruby-redis/bin/ruby-redis
+p
+1
+x
+19
+direct_bin_filename

data/lib/redis/bin.rb

@@ -0,0 +1,74 @@
+require File.expand_path '../redis', File.dirname(__FILE__)
+require_relative 'config'
+require_relative 'connection'
+require_relative 'logger'
+
+class Redis
+  class Bin
+
+    class StrictConnection < Connection
+      include Strict
+    end
+    
+    def self.server
+
+      if ARGV==['-v'] or ARGV==['--version']
+        print "Redis server version %s (Ruby)\n" % Redis::VERSION
+        exit 0
+      end
+
+      if ARGV==['--help'] or ARGV.size > 1
+        STDERR.print "Usage: ruby-redis [/path/to/redis.conf]\n"
+        STDERR.print "       ruby-redis - (read config from stdin)\n"
+        exit 1
+      end
+
+      show_no_config_warning = (ARGV.size == 0)
+
+      config = Config.new(ARGV.empty? ? [] : ARGF)
+
+      Dir.chdir config[:dir]
+
+      Redis.logger config[:logfile] unless config[:logfile] == 'stdout'
+
+      #TODO
+      # Set server verbosity to 'debug'
+      # it can be one of:
+      # debug (a lot of information, useful for development/testing)
+      # verbose (many rarely useful info, but not a mess like the debug level)
+      # notice (moderately verbose, what you want in production probably)
+      # warning (only very important / critical messages are logged)
+      # loglevel verbose
+
+      if show_no_config_warning
+        Redis.logger.warn "Warning: no config file specified, using the default config. In order to specify a config file use 'ruby-redis /path/to/redis.conf'"
+      end
+
+      EventMachine.epoll
+      EventMachine.run {
+  
+        (0...config[:databases]).each do |db_index|
+          Redis.databases[db_index] ||= Database.new
+        end
+
+        #TODO support changing host and EventMachine::start_unix_domain_server
+        EventMachine::start_server "127.0.0.1", config[:port], StrictConnection, config[:requirepass]
+
+        if config[:daemonize]
+          raise 'todo'
+          # daemonize();
+          # FILE *fp = fopen(server.pidfile,"w");
+          # if (fp) { fprintf(fp,"%d\n",(int)getpid()); fclose(fp); }
+        end
+        
+        Redis.logger.notice "Server started, Ruby Redis version %s" % Redis::VERSION
+        Redis.logger.notice "The server is now ready to accept connections on port %d" % config[:port]
+
+        # The test suite blocks until it gets the pid from the log.
+        Redis.logger.flush
+
+      }
+      
+    end
+  end
+end