functional-ruby 0.5.0 → 0.6.0

data/spec/functional/thread_pool_shared.rb

@@ -0,0 +1,209 @@
+require 'spec_helper'
+
+module Functional
+
+  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/functional/utilities_spec.rb

@@ -0,0 +1,149 @@
+require 'spec_helper'
+require 'fakefs/safe'
+
+describe 'utilities' do
+
+  context '#repl?' do
+
+    before(:each) do
+      @dollar_zero = $0
+    end
+
+    after(:each) do
+      $0 = @dollar_zero
+    end
+
+    def set_dollar_zero(val)
+      $0 = val
+    end
+
+    it 'recognizes IRB' do
+      set_dollar_zero('irb')
+      repl?.should be_true
+    end
+
+    it 'recognizes Pry' do
+      set_dollar_zero('pry')
+      repl?.should be_true
+    end
+
+    it 'recognizes Rails Console' do
+      set_dollar_zero('script/rails')
+      repl?.should be_true
+    end
+
+    it 'recognizes Bundle Console' do
+      set_dollar_zero('bin/bundle')
+      repl?.should be_true
+    end
+
+    it 'returns false when not in a REPL' do
+      set_dollar_zero(__FILE__)
+      repl?.should be_false
+    end
+  end
+
+  context '#safe' do
+
+    it 'allows safe operations' do
+      lambda {
+        safe{ 1 + 1 }
+      }.should_not raise_error(SecurityError)
+    end
+
+    it 'returns the value of the block when safe' do
+      safe{ 1 + 1 }.should eq 2
+    end
+
+    it 'passes all arguments to the block' do
+      safe(1, 2, 3){|x, y, z| x + y + z }.should eq 6
+    end
+
+    it 'rejects unsafe operations on tainted objects' do
+      lambda {
+        safe{ Signal.trap('INT'.taint) }
+      }.should raise_error(SecurityError)
+    end
+
+    it 'rejects the use of #eval' do
+      lambda {
+        safe{ eval 'puts 1' }
+      }.should raise_error(SecurityError)
+    end
+  end
+
+  context '#slurp' do
+
+    before(:all) { FakeFS.activate! }
+    after(:all) { FakeFS.deactivate! }
+
+    let!(:path){ 'slurp.txt' }
+    let!(:text){ 'Hello, world!' }
+
+    it 'returns the contents of the file' do
+      File.open(path, 'w+') {|f| f.write(text) }
+      slurp(path).should eq text
+    end
+
+    it 'raises an exception when the file does not exist' do
+      lambda {
+        slurp('path/does/not/exist')
+      }.should raise_error(Errno::ENOENT)
+    end
+  end
+
+  context '#slurpee' do
+
+    before(:all) { FakeFS.activate! }
+    after(:all) { FakeFS.deactivate! }
+
+    let!(:path){ 'slurp.txt' }
+    let!(:text){ 'You are number 6.' }
+    let!(:erb) { 'You are number <%= 2 * 3 %>.' }
+
+    it 'returns the processed contents of the file' do
+      File.open(path, 'w+') {|f| f.write(erb) }
+      slurpee(path).should eq text
+    end
+
+    it 'raises an exception when the file does not exist' do
+      lambda {
+        slurpee('path/does/not/exist')
+      }.should raise_error(Errno::ENOENT)
+    end
+  end
+
+  context '#delta' do
+
+    it 'computes the delta of two positive values' do
+      delta(10.5, 5.0).should be_within(0.01).of(5.5)
+    end
+
+    it 'computes the delta of two negative values' do
+      delta(-10.5, -5.0).should be_within(0.01).of(5.5)
+    end
+
+    it 'computes the delta of a positive and negative value' do
+      delta(10.5, -5.0).should be_within(0.01).of(15.5)
+    end
+
+    it 'computes the delta of two positive values with a block' do
+      v1 = {:count => 10.5}
+      v2 = {:count => 5.0}
+      delta(v1, v2){|x| x[:count]}.should be_within(0.01).of(5.5)
+    end
+
+    it 'computes the delta of two negative values with a block' do
+      v1 = {:count => -10.5}
+      v2 = {:count => -5.0}
+      delta(v1, v2){|x| x[:count]}.should be_within(0.01).of(5.5)
+    end
+
+    it 'computes the delta of a positive and negative value with a block' do
+      v1 = {:count => 10.5}
+      v2 = {:count => -5.0}
+      delta(v1, v2){|x| x[:count]}.should be_within(0.01).of(15.5)
+    end
+  end
+
+end

data/spec/spec_helper.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: functional-ruby
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Jerry D'Antonio
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-06-22 00:00:00.000000000 Z
+date: 2013-07-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -25,7 +25,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 description: |2
-      A gem for adding Erlang and Clojure inspired functional programming tools to Ruby.
+      A gem for adding Erlang, Clojure, and Go inspired concurrency and functional programming tools to Ruby.
 email: jerry.dantonio@gmail.com
 executables: []
 extensions: []
@@ -35,22 +35,62 @@ extra_rdoc_files:
 files:
 - README.md
 - LICENSE
+- lib/functional/agent.rb
 - lib/functional/all.rb
 - lib/functional/behavior.rb
 - lib/functional/behaviour.rb
+- lib/functional/cached_thread_pool.rb
 - lib/functional/concurrency.rb
 - lib/functional/core.rb
+- lib/functional/event.rb
+- lib/functional/event_machine_defer_proxy.rb
+- lib/functional/fixed_thread_pool.rb
+- lib/functional/future.rb
+- lib/functional/global_thread_pool.rb
+- lib/functional/obligation.rb
 - lib/functional/pattern_matching.rb
+- lib/functional/promise.rb
+- lib/functional/thread_pool.rb
+- lib/functional/utilities.rb
 - lib/functional/version.rb
+- lib/functional.rb
+- lib/functional_ruby.rb
+- md/behavior.md
+- md/concurrency.md
+- md/future.md
+- md/obligation.md
+- md/pattern_matching.md
+- md/promise.md
+- md/utilities.md
+- spec/functional/agent_spec.rb
 - spec/functional/behavior_spec.rb
+- spec/functional/cached_thread_pool_spec.rb
+- spec/functional/concurrency_spec.rb
+- spec/functional/event_machine_defer_proxy_spec.rb
+- spec/functional/event_spec.rb
+- spec/functional/fixed_thread_pool_spec.rb
+- spec/functional/future_spec.rb
 - spec/functional/integration_spec.rb
+- spec/functional/obligation_shared.rb
 - spec/functional/pattern_matching_spec.rb
+- spec/functional/promise_spec.rb
+- spec/functional/thread_pool_shared.rb
+- spec/functional/utilities_spec.rb
 - spec/spec_helper.rb
 homepage: https://github.com/jdantonio/functional-ruby/
 licenses:
 - MIT
 metadata: {}
-post_install_message: start() -> io:format("Hello, World!").
+post_install_message: |2
+      hello() -> io:format("Hello, World!").
+
+      package main
+      import "fmt"
+      func main() {
+        fmt.Printf("hello, world")
+      }
+
+      (def hello (fn [] "Hello world"))
 rdoc_options: []
 require_paths:
 - lib
@@ -71,8 +111,18 @@ signing_key:
 specification_version: 4
 summary: Erlang and Clojure inspired functional programming tools for Ruby.
 test_files:
+- spec/functional/agent_spec.rb
 - spec/functional/behavior_spec.rb
+- spec/functional/cached_thread_pool_spec.rb
+- spec/functional/concurrency_spec.rb
+- spec/functional/event_machine_defer_proxy_spec.rb
+- spec/functional/event_spec.rb
+- spec/functional/fixed_thread_pool_spec.rb
+- spec/functional/future_spec.rb
 - spec/functional/integration_spec.rb
+- spec/functional/obligation_shared.rb
 - spec/functional/pattern_matching_spec.rb
+- spec/functional/promise_spec.rb
+- spec/functional/thread_pool_shared.rb
+- spec/functional/utilities_spec.rb
 - spec/spec_helper.rb
-has_rdoc: