concurrent-ruby 0.3.2 → 0.4.0

data/spec/concurrent/timer_task_spec.rb

@@ -1,5 +1,6 @@
 require 'spec_helper'
 require_relative 'runnable_shared'
+require_relative 'stoppable_shared'
 
 module Concurrent
 
@@ -19,6 +20,17 @@ module Concurrent
       it_should_behave_like :runnable
     end
 
+    context ':stoppable' do
+
+      subject do
+        task = TimerTask.new{ nil }
+        task.run!
+        task
+      end
+
+      it_should_behave_like :stoppable
+    end
+
     context 'created with #new' do
 
       context '#initialize' do
@@ -26,7 +38,31 @@ module Concurrent
         it 'raises an exception if no block given' do
           lambda {
             @subject = Concurrent::TimerTask.new
-          }.should raise_error
+          }.should raise_error(ArgumentError)
+        end
+
+        it 'raises an exception if :execution_interval is not greater than zero' do
+          lambda {
+            @subject = Concurrent::TimerTask.new(execution_interval: 0){ nil }
+          }.should raise_error(ArgumentError)
+        end
+
+        it 'raises an exception if :execution_interval is not an integer' do
+          lambda {
+            @subject = Concurrent::TimerTask.new(execution_interval: 'one'){ nil }
+          }.should raise_error(ArgumentError)
+        end
+
+        it 'raises an exception if :timeout_interval is not greater than zero' do
+          lambda {
+            @subject = Concurrent::TimerTask.new(timeout_interval: 0){ nil }
+          }.should raise_error(ArgumentError)
+        end
+
+        it 'raises an exception if :timeout_interval is not an integer' do
+          lambda {
+            @subject = Concurrent::TimerTask.new(timeout_interval: 'one'){ nil }
+          }.should raise_error(ArgumentError)
         end
 
         it 'uses the default execution interval when no interval is given' do

metadata

@@ -1,27 +1,27 @@
 --- !ruby/object:Gem::Specification
 name: concurrent-ruby
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.4.0
 platform: ruby
 authors:
 - Jerry D'Antonio
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-11-08 00:00:00.000000000 Z
+date: 2014-01-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 description: |2
@@ -34,36 +34,38 @@ extra_rdoc_files:
 - README.md
 - LICENSE
 files:
-- README.md
 - LICENSE
+- README.md
+- lib/concurrent.rb
 - lib/concurrent/actor.rb
 - lib/concurrent/agent.rb
-- lib/concurrent/cached_thread_pool/worker.rb
 - lib/concurrent/cached_thread_pool.rb
+- lib/concurrent/cached_thread_pool/worker.rb
+- lib/concurrent/channel.rb
 - lib/concurrent/contract.rb
 - lib/concurrent/dereferenceable.rb
 - lib/concurrent/event.rb
 - lib/concurrent/event_machine_defer_proxy.rb
-- lib/concurrent/fixed_thread_pool/worker.rb
 - lib/concurrent/fixed_thread_pool.rb
+- lib/concurrent/fixed_thread_pool/worker.rb
 - lib/concurrent/future.rb
 - lib/concurrent/global_thread_pool.rb
-- lib/concurrent/goroutine.rb
 - lib/concurrent/obligation.rb
+- lib/concurrent/postable.rb
 - lib/concurrent/promise.rb
 - lib/concurrent/runnable.rb
 - lib/concurrent/scheduled_task.rb
+- lib/concurrent/stoppable.rb
 - lib/concurrent/supervisor.rb
 - lib/concurrent/timer_task.rb
 - lib/concurrent/utilities.rb
 - lib/concurrent/version.rb
-- lib/concurrent.rb
 - lib/concurrent_ruby.rb
 - md/actor.md
 - md/agent.md
+- md/channel.md
 - md/dereferenceable.md
 - md/future.md
-- md/goroutine.md
 - md/obligation.md
 - md/promise.md
 - md/scheduled_task.md
@@ -73,18 +75,20 @@ files:
 - spec/concurrent/actor_spec.rb
 - spec/concurrent/agent_spec.rb
 - spec/concurrent/cached_thread_pool_spec.rb
+- spec/concurrent/channel_spec.rb
 - spec/concurrent/contract_spec.rb
 - spec/concurrent/event_machine_defer_proxy_spec.rb
 - spec/concurrent/event_spec.rb
 - spec/concurrent/fixed_thread_pool_spec.rb
 - spec/concurrent/future_spec.rb
 - spec/concurrent/global_thread_pool_spec.rb
-- spec/concurrent/goroutine_spec.rb
 - spec/concurrent/obligation_shared.rb
+- spec/concurrent/postable_shared.rb
 - spec/concurrent/promise_spec.rb
 - spec/concurrent/runnable_shared.rb
 - spec/concurrent/runnable_spec.rb
 - spec/concurrent/scheduled_task_spec.rb
+- spec/concurrent/stoppable_shared.rb
 - spec/concurrent/supervisor_spec.rb
 - spec/concurrent/thread_pool_shared.rb
 - spec/concurrent/timer_task_spec.rb
@@ -105,17 +109,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: 1.9.2
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.1.10
+rubygems_version: 2.2.0.rc.1
 signing_key: 
 specification_version: 4
 summary: Modern concurrency tools including agents, futures, promises, thread pools,
@@ -124,18 +128,20 @@ test_files:
 - spec/concurrent/actor_spec.rb
 - spec/concurrent/agent_spec.rb
 - spec/concurrent/cached_thread_pool_spec.rb
+- spec/concurrent/channel_spec.rb
 - spec/concurrent/contract_spec.rb
 - spec/concurrent/event_machine_defer_proxy_spec.rb
 - spec/concurrent/event_spec.rb
 - spec/concurrent/fixed_thread_pool_spec.rb
 - spec/concurrent/future_spec.rb
 - spec/concurrent/global_thread_pool_spec.rb
-- spec/concurrent/goroutine_spec.rb
 - spec/concurrent/obligation_shared.rb
+- spec/concurrent/postable_shared.rb
 - spec/concurrent/promise_spec.rb
 - spec/concurrent/runnable_shared.rb
 - spec/concurrent/runnable_spec.rb
 - spec/concurrent/scheduled_task_spec.rb
+- spec/concurrent/stoppable_shared.rb
 - spec/concurrent/supervisor_spec.rb
 - spec/concurrent/thread_pool_shared.rb
 - spec/concurrent/timer_task_spec.rb
@@ -143,3 +149,4 @@ test_files:
 - spec/concurrent/utilities_spec.rb
 - spec/spec_helper.rb
 - spec/support/functions.rb
+has_rdoc: 

data/lib/concurrent/goroutine.rb

@@ -1,25 +0,0 @@
-require 'thread'
-
-require 'concurrent/global_thread_pool'
-
-module Kernel
-
-  # Post the given agruments and block to the Global Thread Pool.
-  #
-  # @param args [Array] zero or more arguments for the block
-  # @param block [Proc] operation to be performed concurrently
-  #
-  # @return [true,false] success/failre of thread creation
-  #
-  # @note Althought based on Go's goroutines and Erlang's spawn/1,
-  # Ruby has a vastly different runtime. Threads aren't nearly as
-  # efficient in Ruby. Use this function appropriately.
-  #
-  # @see http://golang.org/doc/effective_go.html#goroutines
-  # @see https://gobyexample.com/goroutines
-  def go(*args, &block)
-    return false unless block_given?
-    $GLOBAL_THREAD_POOL.post(*args, &block)
-  end
-  module_function :go
-end

data/md/goroutine.md

@@ -1,54 +0,0 @@
-# Go, Go, Gadget Goroutine!
-
-A goroutine is the simplest of the concurrency utilities in this library. It is inspired by
-[Go's](http://golang.org/) [goroutines](https://gobyexample.com/goroutines) and
-[Erlang's](http://www.erlang.org/) [spawn](http://erlangexamples.com/tag/spawn/) keyword. The
-`go` function is nothing more than a simple way to send a block to the global thread pool (see below)
-for processing.
-
-## Examples
-
-```ruby
-require 'concurrent'
-
-go('foo'){|echo| sleep(0.1); print "#{echo}\n"; sleep(0.1); print "Boom!\n" }
-go('bar'){|echo| sleep(0.1); print "#{echo}\n"; sleep(0.1); print "Pow!\n" }
-go('baz'){|echo| sleep(0.1); print "#{echo}\n"; sleep(0.1); print "Zap!\n" }
-sleep(0.5)
-
-#=> foo
-#=> bar
-#=> baz
-#=> Boom!
-#=> Pow!
-#=> Zap!
-```
-
-## Copyright
-
-*Concurrent Ruby* is Copyright © 2013 [Jerry D'Antonio](https://twitter.com/jerrydantonio).
-It is free software and may be redistributed under the terms specified in the LICENSE file.
-
-## License
-
-Released under the MIT license.
-
-http://www.opensource.org/licenses/mit-license.php  
-
-> Permission is hereby granted, free of charge, to any person obtaining a copy  
-> of this software and associated documentation files (the "Software"), to deal  
-> in the Software without restriction, including without limitation the rights  
-> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell  
-> copies of the Software, and to permit persons to whom the Software is  
-> furnished to do so, subject to the following conditions:  
-> 
-> The above copyright notice and this permission notice shall be included in  
-> all copies or substantial portions of the Software.  
-> 
-> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR  
-> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,  
-> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE  
-> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER  
-> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,  
-> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN  
-> THE SOFTWARE.  

data/spec/concurrent/goroutine_spec.rb

@@ -1,52 +0,0 @@
-require 'spec_helper'
-
-module Concurrent
-
-  describe '#go' do
-
-    before(:each) do
-      $GLOBAL_THREAD_POOL = CachedThreadPool.new
-    end
-
-    it 'passes all arguments to the block' do
-      @expected = nil
-      go(1, 2, 3){|a, b, c| @expected = [c, b, a] }
-      sleep(0.1)
-      @expected.should eq [3, 2, 1]
-    end
-
-    it 'returns true if the thread is successfully created' do
-      $GLOBAL_THREAD_POOL.should_receive(:post).and_return(true)
-      go{ nil }.should be_true
-    end
-
-    it 'returns false if the thread cannot be created' do
-      $GLOBAL_THREAD_POOL.should_receive(:post).and_return(false)
-      go{ nil }.should be_false
-    end
-
-    it 'immediately returns false if no block is given' do
-      go().should be_false
-    end
-
-    it 'does not create a thread if no block is given' do
-      $GLOBAL_THREAD_POOL.should_not_receive(:post)
-      go()
-      sleep(0.1)
-    end
-
-    it 'supresses exceptions on the thread' do
-      lambda{
-        go{ raise StandardError }
-        sleep(0.1)
-      }.should_not raise_error
-    end
-
-    it 'processes the block' do
-      @expected = false
-      go(1,2,3){|*args| @expected = args }
-      sleep(0.1)
-      @expected.should eq [1,2,3]
-    end
-  end
-end