redis_message_capsule 0.8.2 → 0.8.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 0215b76d96a1d432d94d3cf26f4efccd5e1f2735
+  data.tar.gz: 72bb72a589d99c58fe15994f3b61956b5dc98b89
+SHA512:
+  metadata.gz: 76449cdfb3c0cbd3774a728c296c4c34930809bdb9f4fa7904f69c2e37b968fc7f350e3fad7c349e6f818593c1a90c0c8c3d59fc2f5029346f328cc6010435de
+  data.tar.gz: 3fe6e4c83ed511ee70a45784f07703e27da442e4ade0fc19f1d616534bb1bbb9d8d0fe110bfff70a83646c140b7d67e69a704e1b7a73273fb9b2f2ef55ab2318

data/README.md

@@ -18,6 +18,8 @@ Send messages between node or rails apps asynchronously (via redis).
 ## Usage
 The purpose of RedisMessageCapsule is to enable separate apps to communicate with each other asynchronously.
 
+The ruby implementation listens for messages in a separate thread, and node listens in a separate Fiber.
+
 ### Make sure redis is running:
 The code below defaults to using redis running on localhost
 
@@ -29,7 +31,7 @@ Both windows can be ruby, can be node, or one can be ruby and one can be node.
 
     $ node
     require('redis_message_capsule')
-    redisurl = 'redis://127.0.0.1:6379/' 
+    redisurl = 'redis://127.0.0.1:6379/'
     capsule = RedisMessageCapsule.capsule(redisurl)
     cat = capsule.channel('cat')
     cat.send('meow')
@@ -39,9 +41,10 @@ Both windows can be ruby, can be node, or one can be ruby and one can be node.
 
     $ irb
     require('redis_message_capsule')
-    redisurl = 'redis://127.0.0.1:6379/' 
+    redisurl = 'redis://127.0.0.1:6379/'
     capsule = RedisMessageCapsule.capsule(redisurl)
     cat = capsule.channel('cat')
+    cat.clear  # clear existing messages from this channel
     cat.send('meow')
     cat.send('meow')
 
@@ -50,7 +53,7 @@ Both windows can be ruby, can be node, or one can be ruby and one can be node.
 
     $ node
     require('redis_message_capsule')
-    redisurl = 'redis://127.0.0.1:6379/' 
+    redisurl = 'redis://127.0.0.1:6379/'
     capsule = RedisMessageCapsule.capsule(redisurl)
     cat = capsule.channel('cat')
     cat.register(function(err, message){ console.log(message) })
@@ -59,10 +62,11 @@ Both windows can be ruby, can be node, or one can be ruby and one can be node.
 
     $ irb
     require('redis_message_capsule')
-    redisurl = 'redis://127.0.0.1:6379/' 
+    redisurl = 'redis://127.0.0.1:6379/'
     capsule = RedisMessageCapsule.capsule(redisurl)
     cat = capsule.channel('cat')
     cat.register { |msg|  puts msg }
+For Rails apps, listeners can be registered in an initializer.
 
 ### To Send More Messages From Window 1
 **in node**:
@@ -88,8 +92,8 @@ This module sends messages in a queue rather than a typical pub/sub model: messa
 
 ### Multiple Listeners on a Channel Will Round Robin
 * If multiple apps are listening on the same channel, only one will actually receive the message and pass it on to its registered handlers for processing.
-* Listeners run in their own thread (in ruby) or fiber(in node) and may block waiting for a message.
-* When a message comes in, only the app that was waiting the longest will receive it.
+* Listeners run in their own thread (in ruby) or fiber (in node). They will block themselves when waiting for a message, so the main event loop can continue.
+* When a message comes in, only the app that was waiting the longest will receive it (the message will be forwarded to all handlers registered in that app).
 
 ## Environment
 In order for 2 apps to send messages to each other, they must bind a capsule to the same redis DB and select the same db number.
@@ -114,7 +118,7 @@ In node use one of the following to set your environment
 Alternatively, you can specify exactly what you want when materializing a capsule:
 
     RedisMessageCapsule = require('redis_message_capsule')
-    redisurl = process.env.REDIS_URL || process.env.REDISTOGO_URL || 'redis://127.0.0.1:6379/' 
+    redisurl = process.env.REDIS_URL || process.env.REDISTOGO_URL || 'redis://127.0.0.1:6379/'
     redisdb = 5
     capsule = RedisMessageCapsule.capsule(redisurl, redisdb)
 

data/lib/redis_message_capsule.rb

@@ -32,7 +32,7 @@ module RedisMessageCapsule
   def self.capsules() @capsules ||=  {} end
   def self.make_capsule_key(url, db_num) "#{url}.#{db_num}" end
   def self.materialize_capsule(redis_url=nil, db_number=-1)
-    url = redis_url || config.redis_url    
+    url = redis_url || config.redis_url
     redis_uri = URI.parse(url) rescue nil
     return nil if redis_uri.nil?
 
@@ -99,12 +99,13 @@ class RedisMessageCapsule::Capsule::Channel
     @listener = nil
   end
 
+  def clear
+    redis_client.del channel_name
+  end
+
   def send (message)
     payload = { 'data' => message }
     redis_client.rpush channel_name, payload.to_json
-  rescue Exception => e
-    puts e.message
-    puts e.backtrace
   ensure
     self # chainability
   end
@@ -155,7 +156,7 @@ class RedisMessageCapsule::Capsule::Channel::Listener
     @listener_thread ||= Thread.new do
 
       blocking_redis_client = RedisMessageCapsule.materialize_redis_client @redis_uri, @db_number
-      # This redis connection will block when popping, so it is created inside of its own thread 
+      # This redis connection will block when popping, so it is created inside of its own thread
 
       Thread.current[:name] = :RedisMessageCapsule
       Thread.current[:chanel] = @channel_name
@@ -175,6 +176,7 @@ class RedisMessageCapsule::Capsule::Channel::Listener
           end
         rescue Exception => e
           Thread.current[:listening] = false # stop listening
+          raise e
         end
       end # while
     end # Thread.new

data/lib/redis_message_capsule/version.rb

@@ -1,3 +1,3 @@
 module RedisMessageCapsule
-  VERSION = "0.8.2"
+  VERSION = "0.8.3"
 end

metadata

@@ -1,94 +1,83 @@
 --- !ruby/object:Gem::Specification
 name: redis_message_capsule
 version: !ruby/object:Gem::Version
-  version: 0.8.2
-  prerelease: 
+  version: 0.8.3
 platform: ruby
 authors:
 - Arbind
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-11-25 00:00:00.000000000 Z
+date: 2013-09-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: redis
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 description: Send messages between node or rails apps asynchronously (via redis).
@@ -109,27 +98,26 @@ files:
 - spec/spec_helper.rb
 homepage: https://github.com/arbind/redis_message_capsule-gem
 licenses: []
+metadata: {}
 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.24
+rubygems_version: 2.0.5
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: See the README file for code demonstrations
 test_files:
 - spec/spec_helper.rb