opee 0.0.1

data/LICENSE

@@ -0,0 +1,27 @@
+Copyright (c) 2012, Peter Ohler
+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.
+
+ - Neither the name of Peter Ohler nor the names of its contributors may 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 HOLDER 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.

data/README.md

@@ -0,0 +1,49 @@
+# Opee gem
+An experimental Object-base Parallel Evaluation Environment
+
+The purpose of this gem is to explore setting up an environment that will run
+completely in parallel with minimum use of mutex synchronization. Actors only
+push the flow forward, never returning values when using the ask()
+method. Other methods return immediately but they should never modify the data
+portions of the Actors. They can be used to modify the control of the Actor.
+
+# plans
+
+- create an error handler that prints or logs rescued exceptions (::Opee::Log class)
+
+- pick a problem to test against
+
+- describe patterns for use
+
+- Is the notion of a job needed to follow processing of an initial input?
+ - avoid using job for storing data though unless rules can be set up to isolate portions of the data to a specific processing path
+
+### License:
+
+    Copyright (c) 2012, Peter Ohler
+    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.
+    
+     - Neither the name of Peter Ohler nor the names of its contributors may 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 HOLDER 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.

data/lib/opee.rb

@@ -0,0 +1,5 @@
+
+module Opee
+end # Opee
+
+require 'opee/actor'

data/lib/opee/actor.rb

@@ -0,0 +1,69 @@
+
+module Opee
+
+  class Actor
+
+    def initialize(options={})
+      @queue = []
+      @ask_mutex = Mutex.new()
+      @ask_timeout = 0.0
+      @max_queue_count = nil
+      @running = true
+      set_options(options)
+      @loop = Thread.start(self) do |me|
+        begin
+          sleep(1.0) if @queue.empty?
+          unless @queue.empty?
+            a = nil
+            @ask_mutex.synchronize {
+              a = @queue.pop()
+            }
+            send(a.op, *a.args)
+          end
+        rescue Exception => e
+          # TBD handle errors by passing them to a error handler
+          puts "*** #{e.class}: #{e.message}"
+          e.backtrace.each { |line| puts "    " + line }
+        end
+      end
+    end
+
+    def set_options(options)
+      # 
+    end
+
+    # deep copy and freeze args if not already frozen or primitive types
+    def ask(op, *args)
+      @ask_mutex.synchronize {
+        @queue << Act.new(op, args)
+      }
+      @loop.wakeup() if @running
+    end
+
+    def queue_count()
+      @queue.length
+    end
+
+    def stop()
+      @running = false
+    end
+
+    def start()
+      @running = true
+      @loop.wakeup()
+    end
+
+    private
+
+    class Act
+      attr_accessor :op
+      attr_accessor :args
+
+      def initialize(op, args)
+        @op = op
+        @args = args
+      end
+    end
+
+  end # Actor
+end # Opee

data/lib/opee/version.rb

@@ -0,0 +1,5 @@
+
+module Opee
+  # Current version of the module. 
+  VERSION = '0.0.1'
+end

data/test/tests.rb

@@ -0,0 +1,40 @@
+#!/usr/bin/env ruby -wW1
+# encoding: UTF-8
+
+$: << File.join(File.dirname(__FILE__), "../lib")
+
+require 'test/unit'
+require 'opee'
+
+class Relay < ::Opee::Actor
+  attr_reader :last_data
+
+  def initialize(buddy)
+    super
+    @buddy = buddy
+    @last_data = nil
+  end
+  
+  private
+
+  def relay(data)
+    @last_data = data
+    @buddy.ask(:relay, data) unless @buddy.nil?
+  end
+
+end # Relay
+
+class Opeet < ::Test::Unit::TestCase
+
+  def test_ask_queue
+    a = ::Relay.new(nil)
+    assert_equal(0, a.queue_count())
+    a.stop()
+    a.ask(:relay, 7)
+    assert_equal(1, a.queue_count())
+    a.start()
+    sleep(0.2)
+    assert_equal(7, a.last_data)
+  end
+
+end # Opeet

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: opee
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Peter Ohler
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-04-17 00:00:00.000000000 Z
+dependencies: []
+description: ! 'An experimental Object-base Parallel Evaluation Environment. '
+email: peter@ohler.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- lib/opee/actor.rb
+- lib/opee/version.rb
+- lib/opee.rb
+- test/tests.rb
+- LICENSE
+- README.md
+homepage: http://www.ohler.com/opee
+licenses: []
+post_install_message: 
+rdoc_options:
+- --main
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: opee
+rubygems_version: 1.8.21
+signing_key: 
+specification_version: 3
+summary: An experimental Object-base Parallel Evaluation Environment.
+test_files: []
+has_rdoc: true