ichannel 4.1.0 → 5.0.0

data/ChangeLog.txt

@@ -1,3 +1,16 @@
+== v5.0.0
+	* Remove IChannel#empty?
+	
+	I think the #readable? method is all you need, since the inverse of 
+	#readable? is the same as #empty? (at least in terms of logic).
+
+== v4.1.0
+	* Add IChannel#readable?
+
+	A method that can tell you whether or not a read would block. 
+	When it returns true, a read shouldn't block, on the other hand
+	if it were false it'd likely block by the time you call #get.
+
 == v4.0.0
 	* Modify IChannel#empty?
 

data/README.md

@@ -67,7 +67,7 @@ can be passed as a serializer to IChannel.
 
 __REAL WORLD EXAMPLES__
  
- I am using IChannel in a couple of my own personal projects:
+I am using IChannel in a couple of my own personal projects:
 
  - [IProcess](https://github.com/robgleeson/iprocess)  
     Provides a number of abstractions on top of spawning subprocesses and 
@@ -75,8 +75,14 @@ __REAL WORLD EXAMPLES__
     extracted into its own project when I realised it could be useful on its
     own.
 
- - [XPool](https://github.com/robgleeson/xpool)  
-    A UNIX(X) Process Pool.
+ - [xpool](https://github.com/robgleeson/xpool)  
+    A lightweight UNIX(X) process pool implementation.
+
+
+Other people have started to write code on top of ichannel, too:
+  
+  - [ifuture](https://github.com/Havenwood/ifuture)  
+    An implementation of Futures for Ruby using process forks and ichannel.
 
 __PLATFORM SUPPORT__
 

data/lib/ichannel/version.rb

@@ -1,3 +1,3 @@
 class IChannel
-  VERSION = "4.1.0"
+  VERSION = "5.0.0"
 end

data/lib/ichannel.rb

@@ -126,21 +126,14 @@ class IChannel
 
   #
   # @return [Boolean]
-  #   Returns true when the channel is empty (nothing to read).
+  #   Returns true when the channel is readable.
   #
-  def empty?
+  def readable?
     if @reader.closed? 
-      true
+      false
     else
-      ! IO.select [@reader], nil, nil, 0.1
+      readable = IO.select [@reader], nil, nil, 0.1
+      !! readable
     end
   end
-
-  #
-  # @return [Boolean]
-  #   Returns true when the channel is readable.
-  #
-  def readable?
-    ! empty?
-  end
 end

data/test/ichannel_class_test.rb

@@ -40,27 +40,6 @@ class IChannelTest < Test::Unit::TestCase
     assert_equal %w(b), @channel.get
   end
 
-  def test_empty_on_empty_channel
-    assert @channel.empty?
-  end
-
-  def test_empty_on_populated_channel
-    @channel.put %w(a)
-    refute @channel.empty?
-  end
-
-  def test_empty_on_emptied_channel
-    @channel.put %w(a)
-    @channel.get 
-    assert @channel.empty?
-  end
-
-  def test_empty_on_closed_channel
-    @channel.put %w(a)
-    @channel.close
-    assert @channel.empty?
-  end
-
   def test_readable_on_populated_channel
     @channel.put %w(a)
     @channel.put %w(b)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ichannel
 version: !ruby/object:Gem::Version
-  version: 4.1.0
+  version: 5.0.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-11-30 00:00:00.000000000 Z
+date: 2012-12-01 00:00:00.000000000 Z
 dependencies: []
 description: ! "A modern and easy-to-use interprocess communication \n    primitive."
 email:
@@ -45,7 +45,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -2586476710676895974
+      hash: -2692349737197848980
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -54,7 +54,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -2586476710676895974
+      hash: -2692349737197848980
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.23