redis 1.0.4 → 1.0.5

data/README.markdown

@@ -1,6 +1,6 @@
 # redis-rb
 
-A Ruby client library for the [Redis](http://code.google.com/p/redis) key-value storage system.
+A Ruby client library for the [Redis](http://code.google.com/p/redis) key-value store.
 
 ## Information about Redis
 
@@ -11,64 +11,102 @@ Redis is a key-value store with some interesting features:
 
 See [the Redis homepage](http://code.google.com/p/redis/wiki/README) for more information.
 
-## Usage
-
-For all types redis-rb needs redis-server running to connect to.
-
-### Simple Key Value Strings can be used like a large Ruby Hash (Similar to Memcached, Tokyo Cabinet)
-	
-	require 'redis'
-	r = Redis.new
-	r['key_one'] = "value_one"
-	r['key_two'] = "value_two"
-	
-	r['key_one]  # => "value_one"
-
-### Redis only stores strings. To store Objects, Array or Hashes, you must [Marshal](http://ruby-doc.org/core/classes/Marshal.html)
-	
-	require 'redis'
-	r = Redis.new
-	
-	example_hash_to_store = {:name => "Alex", :age => 21, :password => "letmein", :cool => false}
-	
-	r['key_one'] = Marshal.dump(example_hash_to_store)
-	
-	hash_returned_from_redis = Marshal.load(r['key_one'])
-	
-### Alternatively you can use the [Redis Commands](http://code.google.com/p/redis/wiki/CommandReference)
-	
-	require 'redis'
-	r = Redis.new
-	r.set 'key_one', 'value_one'
-	r.get 'key_one' # => 'value_one'
-	
-	# Using Redis list objects
-	# Push an object to the head of the list. Creates the list if it doesn't allready exsist.
-	
-	blog_hash = {:title => "Redis Rules!", :body => "Ok so, like why, well like, RDBMS is like....", :created_at => Time.now.to_i}
-	r.lpush 'all_blogs', Marshal.dump(blog_hash)
-	
-	# Get a range of strings from the all_blogs list. Similar to offset and limit in SQL (-1, means the last one)
-	
-	r.lrange 'all_blogs', 0, -1
-
-### Multiple commands at once!
-
-	require 'redis'
-	r = Redis.new
-	r.multi do
-	  r.set 'foo', 'bar'
-	  r.incr 'baz'
-	end
+## Getting started
 
-## Contributing
+You can connect to Redis by instantiating the `Redis` class:
+
+    require "redis"
+
+    redis = Redis.new
+
+This assumes Redis was started with default values listening on `localhost`, port 6379. If you need to connect to a remote server or a different port, try:
+
+    redis = Redis.new(:host => "10.0.1.1", :port => 6380)
+
+Once connected, you can start running commands against Redis:
+
+    >> redis.set "foo", "bar"
+    => "OK"
+
+    >> redis.get "foo"
+    => "bar"
+
+    >> redis.sadd "users", "albert"
+    => true
+
+    >> redis.sadd "users", "bernard"
+    => true
+
+    >> redis.sadd "users", "charles"
+    => true
+
+How many users?
+
+    >> redis.scard "users"
+    => 3
+
+Is `albert` a user?
+
+    >> redis.sismember "users", "albert"
+    => true
+
+Is `isabel` a user?
+
+    >> redis.sismember "users", "isabel"
+    => false
+
+Handle groups:
 
-See the build on [RunCodeRun](http://runcoderun.com/rsanheim/redis-rb).
+    >> redis.sadd "admins", "albert"
+    => true
 
-If you would like to submit patches, you'll need Redis in your development environment:
+    >> redis.sadd "admins", "isabel"
+    => true
 
-		rake redis:install
+Users who are also admins:
 
-## Examples
+    >> redis.sinter "users", "admins"
+    => ["albert"]
+
+Users who are not admins:
+
+    >> redis.sdiff "users", "admins"
+    => ["bernard", "charles"]
+
+Admins who are not users:
+
+    >> redis.sdiff "admins", "users"
+    => ["isabel"]
+
+All users and admins:
+
+    >> redis.sunion "admins", "users"
+    => ["albert", "bernard", "charles", "isabel"]
+
+
+## Storing objects
+
+Redis only stores strings as values. If you want to store an object inside a key, you can use a serialization/deseralization mechanism like JSON:
+
+    >> redis.set "foo", [1, 2, 3].to_json
+    => OK
+
+    >> JSON.parse(redis.get("foo"))
+    => [1, 2, 3]
+
+## Executing multiple commands atomically
+
+You can use `MULTI/EXEC` to run arbitrary commands in an atomic fashion:
+
+    redis.multi do
+      redis.set "foo", "bar"
+      redis.incr "baz"
+    end
+
+## More info
+
+Check the [Redis Command Reference](http://code.google.com/p/redis/wiki/CommandReference) or check the tests to find out how to use this client.
+
+## Contributing
 
-Check the `examples/` directory. You'll need to have an instance of `redis-server` running before running the examples.
+[Fork the project](http://github.com/ezmobius/redis-rb) and send pull requests. You can also ask for help at `#redis` on Freenode.

data/lib/redis.rb

@@ -1,7 +1,7 @@
 require 'socket'
 
 class Redis
-  VERSION = "1.0.4"
+  VERSION = "1.0.5"
 
   def self.new(*attrs)
     Client.new(*attrs)

data/lib/redis/client.rb

@@ -41,7 +41,8 @@ class Redis
     MULTI_BULK_COMMANDS = {
       "mset"      => true,
       "msetnx"    => true,
-      "hset"      => true
+      "hset"      => true,
+      "hmset"     => true
     }
 
     BOOLEAN_PROCESSOR = lambda{|r| r == 1 }
@@ -167,6 +168,10 @@ class Redis
       set(key, value)
     end
 
+    def get(key)
+      call_command([:get, key])
+    end
+
     def set(key, value, ttl = nil)
       if ttl
         deprecated("set with an expire", :set_with_expire, caller[0])
@@ -475,8 +480,14 @@ class Redis
     end
 
 
-    def get_size(string)
-      string.respond_to?(:bytesize) ? string.bytesize : string.size
+    if "".respond_to?(:bytesize)
+      def get_size(string)
+        string.bytesize
+      end
+    else
+      def get_size(string)
+        string.size
+      end
     end
 
   private

data/lib/redis/dist_redis.rb

@@ -72,7 +72,7 @@ class Redis
     def delete_cloud!
       @ring.nodes.each do |red|
         red.keys("*").each do |key|
-          red.delete key
+          red.del key
         end
       end
     end
@@ -107,6 +107,10 @@ class Redis
         kbn
       end
     end
+
+    def type(key)
+      method_missing(:type, key)
+    end
   end
 end
 

data/lib/redis/pipeline.rb

@@ -14,7 +14,6 @@ class Redis
     def execute
       return if @commands.empty?
       @redis.call_command(@commands)
-      @commands.clear
     end
   end
 end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 1
   - 0
-  - 4
-  version: 1.0.4
+  - 5
+  version: 1.0.5
 platform: ruby
 authors: 
 - Ezra Zygmuntowicz
@@ -19,7 +19,7 @@ autorequire: redis
 bindir: bin
 cert_chain: []
 
-date: 2010-04-05 00:00:00 -07:00
+date: 2010-04-21 00:00:00 -03:00
 default_executable: 
 dependencies: []