concurrent-sequential 0.1

data/lib/concurrent/sequential.rb

@@ -0,0 +1,32 @@
+# concurrent/sequential - Sequenced asynchronous actions
+#
+# Copyright 2008  MenTaLguY <mental@rydia.net>
+#
+# All rights reserved.
+# 
+# Redistribution and use in source and binary forms, with or without 
+# modification, are permitted provided that the following conditions are met:
+# 
+# * Redistributions of source code must retain the above copyright notice,
+#   this list of conditions and the following disclaimer.
+# * Redistributions in binary form must reproduce the above copyright notice
+#   this list of conditions and the following disclaimer in the documentation
+#   and/or other materials provided with the distribution.
+# * The names of the authors may not be used to endorse or promote products
+#   derived from this software without specific prior written permission.
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require 'concurrent/sequenced/mock-sequencer'
+require 'concurrent/sequenced/thread-sequencer'
+

data/lib/concurrent/sequential/mock-sequencer.rb

@@ -0,0 +1,51 @@
+# concurrent/sequential/mock-sequencer - Single-threaded sequencer for testing
+#
+# Copyright 2008  MenTaLguY <mental@rydia.net>
+#
+# All rights reserved.
+# 
+# Redistribution and use in source and binary forms, with or without 
+# modification, are permitted provided that the following conditions are met:
+# 
+# * Redistributions of source code must retain the above copyright notice,
+#   this list of conditions and the following disclaimer.
+# * Redistributions in binary form must reproduce the above copyright notice
+#   this list of conditions and the following disclaimer in the documentation
+#   and/or other materials provided with the distribution.
+# * The names of the authors may not be used to endorse or promote products
+#   derived from this software without specific prior written permission.
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+module Concurrent
+module Sequential
+
+class MockSequencer
+  def initialize
+    @queue = []
+  end
+
+  def soon(&block)
+    raise ArgumentError, "No block given" unless block
+    @queue << block
+    self
+  end
+
+  def run
+    @queue.shift.call until @queue.empty?
+    self
+  end
+end
+
+end
+end

data/lib/concurrent/sequential/thread-sequencer.rb

@@ -0,0 +1,71 @@
+# concurrent/sequential/thread-sequencer - Sequencer with own scheduling thread
+#
+# Copyright 2008  MenTaLguY <mental@rydia.net>
+#
+# All rights reserved.
+# 
+# Redistribution and use in source and binary forms, with or without 
+# modification, are permitted provided that the following conditions are met:
+# 
+# * Redistributions of source code must retain the above copyright notice,
+#   this list of conditions and the following disclaimer.
+# * Redistributions in binary form must reproduce the above copyright notice
+#   this list of conditions and the following disclaimer in the documentation
+#   and/or other materials provided with the distribution.
+# * The names of the authors may not be used to endorse or promote products
+#   derived from this software without specific prior written permission.
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require 'thread'
+begin
+  require 'fastthread'
+rescue LoadError
+end
+
+module Concurrent
+module Sequential
+
+class ThreadSequencer
+  def initialize
+    @queue = Queue.new
+    @running = true
+    @thread = Thread.new { run }
+  end
+
+  def soon(&block)
+    raise ArgumentError, "No block given" unless block
+    @queue << block
+    self
+  end
+
+  def shutdown(timeout=nil)
+    soon { @running = false } if @thread.alive?
+    @thread.join(timeout)
+    self
+  end
+
+  def run
+    while @running
+      begin
+        @queue.shift.call
+      rescue Exception
+      end
+    end
+    self
+  end
+  private :run
+end
+
+end
+end

data/spec/sequential/mock-sequencer_spec.rb

@@ -0,0 +1,31 @@
+require 'concurrent/sequential/mock-sequencer'
+
+mock_sequencer = Concurrent::Sequential::MockSequencer
+
+describe mock_sequencer do
+  before :each do
+    @sequencer = mock_sequencer.new
+  end
+
+  it "should accept blocks via #{mock_sequencer}#soon" do
+    @sequencer.soon { }
+  end
+
+  it "should execute submitted blocks after submission" do
+    calls = mock("calls")
+    @sequencer.soon { calls.a }
+    calls.should_receive(:a)
+    @sequencer.run
+  end
+
+  it "should execute reentrant blocks completely and in submission order" do
+    calls = mock("calls")
+    @sequencer.soon do
+      @sequencer.soon { calls.b }
+      calls.a
+    end
+    calls.should_receive(:a).ordered
+    calls.should_receive(:b).ordered
+    @sequencer.run
+  end
+end

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.4
+specification_version: 1
+name: concurrent-sequential
+version: !ruby/object:Gem::Version 
+  version: "0.1"
+date: 2008-06-03 00:00:00 -04:00
+summary: Sequenced asynchronous actions
+require_paths: 
+- lib
+email: 
+homepage: 
+rubyforge_project: 
+description: 
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- MenTaLguY <mental@rydia.net>
+files: 
+- spec/sequential/mock-sequencer_spec.rb
+- lib/concurrent/sequential.rb
+- lib/concurrent/sequential/mock-sequencer.rb
+- lib/concurrent/sequential/thread-sequencer.rb
+test_files: []
+
+rdoc_options: []
+
+extra_rdoc_files: []
+
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: []
+