ichannel 5.1.1.5 → 5.2.0

data/ChangeLog.txt

@@ -1,3 +1,8 @@
+== v5.2.0
+	* add IChannel#last_msg.
+	Reads the last message written to the channel by reading until the channel
+	is empty. The last message is cached and reset to nil on call to #close.
+
 == v5.1.1.1, v5.1.1.2, v5.1.1.3, v5.1.1.4, v5.1.1.5
 	* doc improvements
 	a set of releases that improved the README & api docs.

data/README.md

@@ -17,13 +17,11 @@ machine. All communication on a channel occurs on a streamed UNIXSocket that a
 channel uses to queues its messages (ruby objects), and also to ensure that 
 messages are received in the order they are sent.
 
-__SERIALIZATION__
-
-ichannel relies on serialization when writing and reading from the underlying 
-UNIXSocket. A ruby object is serialized before a write, and it is deserialized 
-after a read. The choice of serializer is left up to you, though. A serializer 
-can be any object that implements `dump` and `load` -- two methods that are 
-usually implemented by serializers written in ruby.
+Underneath the hood ruby objects are serialized when writing and reading from the 
+underlying UNIXSocket. A ruby object is serialized before a write, and it is 
+deserialized after a read. The choice of serializer is left up to you, though. 
+A serializer can be any object that implements `dump` and `load` -- two methods 
+that are usually implemented by serializers written in ruby.
 
 __EXAMPLES__
 

data/lib/ichannel.rb

@@ -11,6 +11,7 @@ class IChannel
   def initialize(serializer)
     @reader, @writer = UNIXSocket.pair :STREAM
     @serializer = serializer
+    @last_msg = nil
   end
 
   #
@@ -31,6 +32,7 @@ class IChannel
     unless closed?
       @reader.close
       @writer.close
+      @last_msg = nil
       true
     end
   end
@@ -81,6 +83,20 @@ class IChannel
   end
   alias_method :put!, :write!
 
+  #
+  # Reads the last message written to the channel by reading until the channel
+  # is empty. The last message is cached and reset to nil on call to {#close}.
+  #
+  # @return [Object]
+  #   Returns the last message to be written to the channel.
+  #
+  def last_msg
+    while readable?
+      @last_msg = get
+    end
+    @last_msg
+  end
+
   #
   # Receive an object from the channel.
   #

data/lib/ichannel/version.rb

@@ -1,3 +1,3 @@
 class IChannel
-  VERSION = "5.1.1.5"
+  VERSION = "5.2.0"
 end

data/test/ichannel_class_test.rb

@@ -9,6 +9,26 @@ class IChannelTest < Test::Unit::TestCase
     @channel.close
   end
 
+  def test_last_msg
+    @channel.put %w(a)
+    @channel.put %w(b)
+    assert_equal %w(b), @channel.last_msg
+  end
+
+  def test_last_msg_cache
+    @channel.put %w(a)
+    2.times { assert_equal %w(a), @channel.last_msg }
+    @channel.close
+    assert_equal nil, @channel.last_msg
+  end
+
+  def test_bust_last_msg_cache
+    @channel.put %w(a)
+    assert_equal %w(a), @channel.last_msg
+    @channel.put %w(b)
+    2.times { assert_equal %w(b), @channel.last_msg }
+  end
+
   def test_put_and_get
     pid = fork do
       @channel.put %w(a b c)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ichannel
 version: !ruby/object:Gem::Version
-  version: 5.1.1.5
+  version: 5.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-03-21 00:00:00.000000000 Z
+date: 2013-04-05 00:00:00.000000000 Z
 dependencies: []
 description: ! "A modern and easy-to-use interprocess communication \n    primitive."
 email:
@@ -46,7 +46,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 718866409656378387
+      hash: 1696570348195705541
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -55,7 +55,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 718866409656378387
+      hash: 1696570348195705541
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.23