threach 0.1.1 → 0.2.0

data/README.markdown

@@ -3,9 +3,23 @@
 `threach` adds to the Enumerable module to provide a threaded
 version of whatever enumerator you throw at it (`each` by default).
 
+## Warning: Deadlocks under JRuby if an exception is thrown
+
+`threach` works fine, so long as nothing goes wrong. In particular, there's no safe way (that I can find; see below) to break out of a `threach` loop without a deadlock under JRuby. This is, shall we say, an Issue. 
+
+Under vanilla ruby, `threach` will exit as expected, but who the hell wants to 
+use `threach` where there are no real threads???
+
+## Installation
+
+`threach` is on rubygems.org, so you should just be able to do
+
+    gem install threach
+    # or jruby -S gem install threach
+
 ## Use
 
-    # You like #each? You'll love...err..probably like #threach
+    # You like #each? You'll love...err.."probably like" #threach
     require 'rubygems'
     require 'threach'
     
@@ -33,6 +47,28 @@ version of whatever enumerator you throw at it (`each` by default).
       puts "#{i}: #{letter}"
     end
 
+## Major problem
+
+I can't figure out how to exit gracefully from a threach loop. 
+
+  begin
+    ('a'..'z').threach(2, :each_with_index) do |letter, i|
+      break if i > 10  # will deadlock under jruby; fine under ruby
+      # raise StandardError if i > 10 # deadlock under jruby; find under ruby
+      puts letter
+    end
+  rescue 
+    puts "Rescued; broke out of the loop"
+  end
+
+The `break` under jruby prints "Exception in thread "Thread-1" org.jruby.exceptions.JumpException$BreakJump," but if there's a way to catch that in the enclosing code I sure don't know how. 
+
+Use of `catch` and `throw` seemed like an obvious choice, but they don't work across threads. Then I thought I'd use `catch` within the consumers and throw or raise an error at the producer, but that doesn't work, either. 
+
+I'm clearly up against (or well beyond) my knowledge limitations, here.
+
+If anyone has a solution to what should be a simple problem (and works under both ruby and jruby) boy, would I be grateful.
+
 ## Why and when to use it?
 
 Well, if you're using stock (MRI) ruby -- you probably shouldn't bother with `threach`. It'll just slow things down. But if you're using a ruby implementation that has real threads, like JRuby, this will give you relatively painless multi-threading.

data/VERSION

@@ -1 +1 @@
-0.1.1
+0.2.0

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: threach
 version: !ruby/object:Gem::Version 
-  hash: 25
+  hash: 23
   prerelease: false
   segments: 
   - 0
-  - 1
-  - 1
-  version: 0.1.1
+  - 2
+  - 0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Bill Dueber
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-07-13 00:00:00 -04:00
+date: 2010-08-10 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency