concurrent-ruby 0.0.1 → 0.1.0

data/spec/concurrent/thread_pool_shared.rb

@@ -0,0 +1,209 @@
+require 'spec_helper'
+
+module Concurrent
+
+  share_examples_for 'Thread Pool' do
+
+    context '#running?' do
+
+      it 'returns true when the thread pool is running' do
+        subject.should be_running
+      end
+
+      it 'returns false when the thread pool is shutting down' do
+        subject.post{ sleep(1) }
+        subject.shutdown
+        subject.should_not be_running
+      end
+
+      it 'returns false when the thread pool is shutdown' do
+        subject.shutdown
+        subject.should_not be_running
+      end
+
+      it 'returns false when the thread pool is killed' do
+        subject.shutdown
+        subject.should_not be_running
+      end
+    end
+
+    context '#shutdown?' do
+
+      it 'returns true if #shutdown has been called' do
+        subject.shutdown
+        subject.should be_shutdown
+      end
+
+      it 'returns false when running' do
+        subject.should_not be_shutdown
+      end
+    end
+
+    context '#killed?' do
+
+      it 'returns true if tasks were killed at shutdown' do
+        subject.post{ sleep(1) }
+        subject.kill
+        subject.should be_killed
+      end
+
+      it 'returns false when running' do
+        subject.should_not be_killed
+      end
+    end
+
+    context '#shutdown' do
+
+      it 'stops accepting new tasks' do
+        subject.post{ sleep(1) }
+        subject.shutdown
+        @expected = false
+        subject.post{ @expected = true }.should be_false
+        sleep(1)
+        @expected.should be_false
+      end
+
+      it 'allows in-progress tasks to complete' do
+        @expected = false
+        subject.post{ sleep(0.5); @expected = true }
+        subject.shutdown
+        sleep(1)
+        @expected.should be_true
+      end
+
+      it 'allows pending tasks to complete' do
+        @expected = false
+        subject.post{ sleep(0.2) }
+        subject.post{ sleep(0.2); @expected = true }
+        subject.shutdown
+        sleep(1)
+        @expected.should be_true
+      end
+
+      it 'allows threads to exit normally' do
+        pool = FixedThreadPool.new(5)
+        pool.shutdown
+        sleep(1)
+        pool.status.should be_empty
+      end
+    end
+
+    context '#kill' do
+
+      it 'stops accepting new tasks' do
+        subject.post{ sleep(1) }
+        subject.kill
+        @expected = false
+        subject.post{ @expected = true }.should be_false
+        sleep(1)
+        @expected.should be_false
+      end
+
+      it 'attempts to kill all in-progress tasks' do
+        @expected = false
+        subject.post{ sleep(1); @expected = true }
+        subject.kill
+        sleep(1)
+        @expected.should be_false
+      end
+
+      it 'rejects all pending tasks' do
+        @expected = false
+        subject.post{ sleep(0.5) }
+        subject.post{ sleep(0.5); @expected = true }
+        subject.kill
+        sleep(1)
+        @expected.should be_false
+      end
+    end
+
+    context '#wait_for_termination' do
+
+      it 'immediately returns true after shutdown has complete' do
+        subject.shutdown
+        subject.wait_for_termination.should be_true
+      end
+
+      it 'blocks indefinitely when timeout it nil' do
+        subject.post{ sleep(1) }
+        subject.shutdown
+        subject.wait_for_termination(nil).should be_true
+      end
+
+      it 'returns true when shutdown sucessfully completes before timeout' do
+        subject.post{ sleep(0.5) }
+        subject.shutdown
+        subject.wait_for_termination(1).should be_true
+      end
+
+      it 'returns false when shutdown fails to complete before timeout' do
+        subject.post{ sleep(1) }
+        subject.shutdown
+        subject.wait_for_termination(0.5).should be_true
+      end
+    end
+
+    context '#post' do
+
+      it 'raises an exception if no block is given' do
+        lambda {
+          subject.post
+        }.should raise_error(ArgumentError)
+      end
+
+      it 'returns true when the block is added to the queue' do
+        subject.post{ nil }.should be_true
+      end
+
+      it 'calls the block with the given arguments' do
+        @expected = nil
+        subject.post(1, 2, 3)do |a, b, c|
+          @expected = a + b + c
+        end
+        sleep(0.1)
+        @expected.should eq 6
+      end
+
+      it 'rejects the block while shutting down' do
+        pool = FixedThreadPool.new(5)
+        pool.post{ sleep(1) }
+        pool.shutdown
+        @expected = nil
+        pool.post(1, 2, 3)do |a, b, c|
+          @expected = a + b + c
+        end
+        @expected.should be_nil
+      end
+
+      it 'returns false while shutting down' do
+        subject.post{ sleep(1) }
+        subject.shutdown
+        subject.post{ nil }.should be_false
+      end
+
+      it 'rejects the block once shutdown' do
+        pool = FixedThreadPool.new(5)
+        pool.shutdown
+        @expected = nil
+        pool.post(1, 2, 3)do |a, b, c|
+          @expected = a + b + c
+        end
+        @expected.should be_nil
+      end
+
+      it 'returns false once shutdown' do
+        subject.post{ nil }
+        subject.shutdown
+        sleep(0.1)
+        subject.post{ nil }.should be_false
+      end
+
+      it 'aliases #<<' do
+        @expected = false
+        subject << proc { @expected = true }
+        sleep(0.1)
+        @expected.should be_true
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -1,3 +1,5 @@
+require 'eventmachine'
+
 require 'concurrent'
 
 # import all the support files

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: concurrent-ruby
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Jerry D'Antonio
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-07-23 00:00:00.000000000 Z
+date: 2013-07-24 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: functional-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.0
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -25,7 +39,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 description: |2
-      This gem does nothing. It is a placeholder for a gem I plan to build.
+      A gem for adding Erlang, Clojure, and Go inspired concurrent programming tools to Ruby.
 email: jerry.dantonio@gmail.com
 executables: []
 extensions: []
@@ -35,8 +49,40 @@ extra_rdoc_files:
 files:
 - README.md
 - LICENSE
+- lib/concurrent/agent.rb
+- lib/concurrent/cached_thread_pool.rb
+- lib/concurrent/defer.rb
+- lib/concurrent/event.rb
+- lib/concurrent/event_machine_defer_proxy.rb
+- lib/concurrent/fixed_thread_pool.rb
+- lib/concurrent/future.rb
+- lib/concurrent/global_thread_pool.rb
+- lib/concurrent/goroutine.rb
+- lib/concurrent/obligation.rb
+- lib/concurrent/promise.rb
+- lib/concurrent/thread_pool.rb
 - lib/concurrent/version.rb
 - lib/concurrent.rb
+- lib/concurrent_ruby.rb
+- md/agent.md
+- md/defer.md
+- md/event.md
+- md/future.md
+- md/goroutine.md
+- md/obligation.md
+- md/promise.md
+- md/thread_pool.md
+- spec/concurrent/agent_spec.rb
+- spec/concurrent/cached_thread_pool_spec.rb
+- spec/concurrent/defer_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/goroutine_spec.rb
+- spec/concurrent/obligation_shared.rb
+- spec/concurrent/promise_spec.rb
+- spec/concurrent/thread_pool_shared.rb
 - spec/spec_helper.rb
 homepage: https://github.com/jdantonio/concurrent-ruby/
 licenses:
@@ -61,6 +107,17 @@ rubyforge_project:
 rubygems_version: 2.0.3
 signing_key: 
 specification_version: 4
-summary: This gem does nothing. It is a placeholder for a gem I plan to build.
+summary: Erlang, Clojure, and Go inspired concurrent programming tools for Ruby.
 test_files:
+- spec/concurrent/agent_spec.rb
+- spec/concurrent/cached_thread_pool_spec.rb
+- spec/concurrent/defer_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/goroutine_spec.rb
+- spec/concurrent/obligation_shared.rb
+- spec/concurrent/promise_spec.rb
+- spec/concurrent/thread_pool_shared.rb
 - spec/spec_helper.rb