parallizer 0.0.1

data/Gemfile

@@ -0,0 +1,21 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+gem "bundler", ">= 1.1.5"
+gem "jeweler", ">= 1.8.4"
+
+gem "work_queue", ">= 0"
+
+group :test do
+  gem "minitest", "2.12.1"
+  gem "minitest-extra-assertions", "0.1.0", :require => nil # guarantee it gets loaded after minitest
+  gem "minitest-reporters", "0.7.0"
+  gem "always_execute", "0.0.2", :require => nil
+  gem "shoulda", "2.11.3", :require => nil
+  gem "mocha", "0.9.8", :require => nil
+end
+

data/Gemfile.lock

@@ -0,0 +1,43 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    always_execute (0.0.2)
+      shoulda
+    ansi (1.4.3)
+    builder (2.1.2)
+    git (1.2.5)
+    jeweler (1.8.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    json (1.7.4)
+    minitest (2.12.1)
+    minitest-extra-assertions (0.1.0)
+    minitest-reporters (0.7.0)
+      ansi
+      builder
+      minitest (~> 2.0)
+      ruby-progressbar
+    mocha (0.9.8)
+      rake
+    rake (0.9.2.2)
+    rdoc (3.12)
+      json (~> 1.4)
+    ruby-progressbar (0.0.10)
+    shoulda (2.11.3)
+    work_queue (2.5.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  always_execute (= 0.0.2)
+  bundler (>= 1.1.5)
+  jeweler (>= 1.8.4)
+  minitest (= 2.12.1)
+  minitest-extra-assertions (= 0.1.0)
+  minitest-reporters (= 0.7.0)
+  mocha (= 0.9.8)
+  shoulda (= 2.11.3)
+  work_queue

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Michael Pearce
+
+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/README.md

@@ -0,0 +1,14 @@
+# Parallizer - Execute your service layer in parallel.
+
+## Examples
+
+# Credits
+
+Always Execute is maintained by [Michael Pearce](http://github.com/michaelgpearce) and is funded by [BookRenter.com](http://www.bookrenter.com "BookRenter.com").
+
+![BookRenter.com Logo](http://assets0.bookrenter.com/images/header/bookrenter_logo.gif "BookRenter.com")
+
+# Copyright
+
+Copyright (c) 2012 Michael Pearce, Bookrenter.com. See LICENSE.txt for further details.
+

data/Rakefile

@@ -0,0 +1,36 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "parallizer"
+  gem.homepage = "http://github.com/michaelgpearce/parallizer"
+  gem.license = "MIT"
+  gem.summary = %Q{Execute your service layer in parallel.}
+  gem.description = %Q{Execute your service layer in parallel.}
+  gem.email = "michael.pearce@bookrenter.com"
+  gem.authors = ["Michael Pearce"]
+  # Include your dependencies below. Runtime dependencies are required when using your gem,
+  # and development dependencies are only needed for development (ie running rake tasks, tests, etc)
+  gem.add_runtime_dependency 'work_queue', '>= 0'
+  gem.add_development_dependency 'shoulda', '>= 0'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+task :default => :test

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/lib/parallizer.rb

@@ -0,0 +1,49 @@
+require 'set'
+require 'work_queue'
+require 'parallizer/proxy'
+
+class Parallizer
+  attr_accessor :calls, :client
+  
+  def initialize(client)
+    self.client = client
+    self.calls = Set.new
+  end
+  
+  def add_call(method_name, *args)
+    calls.add([method_name.to_sym, *args])
+  end
+  
+  def execute
+    Parallizer.execute_all(self).first
+  end
+  
+  def self.work_queue
+    # TODO: share the work queue among calling threads
+    Thread.current[:parallizer_work_queue] ||= WorkQueue.new(10)
+  end
+  
+  def self.execute_all(*parallizers)
+    parallizers_execution_results = {}
+    parallizers.each do |parallizer|
+      execution_results = {}
+      parallizers_execution_results[parallizer] = execution_results
+      
+      parallizer.calls.each do |name_and_args|
+        Parallizer.work_queue.enqueue_b do
+          begin
+            execution_results[name_and_args] = {:result => parallizer.client.send(*name_and_args)}
+          rescue Exception => e
+            execution_results[name_and_args] = {:exception => e}
+          end
+        end
+      end
+    end
+    
+    Parallizer.work_queue.join
+
+    return parallizers_execution_results.collect do |parallizer, execution_results|
+      Parallizer::Proxy.new(parallizer.client, execution_results)
+    end
+  end
+end

data/lib/parallizer/proxy.rb

@@ -0,0 +1,33 @@
+require 'set'
+
+class Parallizer
+  class Proxy
+    def initialize(client, execution_results)
+      @client = client
+      @execution_results = execution_results
+    end
+
+    def method_missing(name, *args, &block)
+      if @execution_results.key?([name, *args])
+        value = @execution_results[[name, *args]]
+        if value[:exception]
+          raise value[:exception]
+        else
+          value[:result]
+        end
+      else
+        @client.send(*[name, *args], &block)
+      end
+    end
+  
+    def respond_to?(name, include_private = false, &block)
+      @execution_methods ||= Set.new(@execution_results.keys.collect(&:first))
+    
+      if @execution_methods.include?(name.to_sym)
+        true
+      else
+        super
+      end
+    end
+  end
+end

data/parallizer.gemspec

@@ -0,0 +1,63 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "parallizer"
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Michael Pearce"]
+  s.date = "2012-07-28"
+  s.description = "Execute your service layer in parallel."
+  s.email = "michael.pearce@bookrenter.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "lib/parallizer.rb",
+    "lib/parallizer/proxy.rb",
+    "parallizer.gemspec",
+    "test/parallizer/proxy_test.rb",
+    "test/parallizer_test.rb",
+    "test/test_helper.rb"
+  ]
+  s.homepage = "http://github.com/michaelgpearce/parallizer"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.24"
+  s.summary = "Execute your service layer in parallel."
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<bundler>, [">= 1.1.5"])
+      s.add_runtime_dependency(%q<jeweler>, [">= 1.8.4"])
+      s.add_runtime_dependency(%q<work_queue>, [">= 0"])
+      s.add_runtime_dependency(%q<work_queue>, [">= 0"])
+      s.add_development_dependency(%q<shoulda>, [">= 0"])
+    else
+      s.add_dependency(%q<bundler>, [">= 1.1.5"])
+      s.add_dependency(%q<jeweler>, [">= 1.8.4"])
+      s.add_dependency(%q<work_queue>, [">= 0"])
+      s.add_dependency(%q<work_queue>, [">= 0"])
+      s.add_dependency(%q<shoulda>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<bundler>, [">= 1.1.5"])
+    s.add_dependency(%q<jeweler>, [">= 1.8.4"])
+    s.add_dependency(%q<work_queue>, [">= 0"])
+    s.add_dependency(%q<work_queue>, [">= 0"])
+    s.add_dependency(%q<shoulda>, [">= 0"])
+  end
+end
+

data/test/parallizer/proxy_test.rb

@@ -0,0 +1,90 @@
+require 'test_helper'
+
+class Parallizer::ProxyTest < Test::Unit::TestCase
+  DEFAULT_RETURN_VALUE = "return value"
+  
+  class TestObject
+    def a_method(arg)
+      DEFAULT_RETURN_VALUE
+    end
+  end
+  
+  context ".method_missing" do
+    setup do
+      @client = TestObject.new
+    end
+    
+    context "with method that exists on client" do
+      context "with method and arg in execute results" do
+        setup do
+          @method_result = "some value"
+          @method_arg = "some arg"
+          @execution_results = {[:a_method, @method_arg] => {:result => @method_result}}
+        end
+
+        should "return value from execution_results" do
+          assert_equal @method_result, Parallizer::Proxy.new(@client, @execution_results).a_method(@method_arg)
+        end
+
+        context "with exception in execute results" do
+          setup do
+            @execution_results = {[:a_method, @method_arg] => {:exception => Exception.new("an exception")}}
+          end
+          
+          should "raise exception" do
+            assert_raises Exception, "an exception" do
+              Parallizer::Proxy.new(@client, @execution_results).a_method(@method_arg)
+            end
+          end
+        end
+      end
+      
+      context "with method and arg not in execute result" do
+        setup do
+          @execution_results = {[:a_method, :unknown] => "unknown"}
+        end
+
+        should "return value from client object" do
+          assert_equal DEFAULT_RETURN_VALUE, Parallizer::Proxy.new(@client, @execution_results).a_method(:not_unknown)
+        end
+      end
+    end
+    
+    context "with method that does not exist on client" do
+      setup do
+        @execution_results = {[:a_method, @method_arg] => {:result => @method_result}}
+      end
+      
+      should "raise exception" do
+        assert_raises NoMethodError, "an exception" do
+          Parallizer::Proxy.new(@client, @execution_results).unknown_method()
+        end
+      end
+    end
+  end
+  
+  context ".respond_to?" do
+    setup do
+      client = TestObject.new
+      execution_results = {[:a_method, 'valid argument'] => {:result => 'valid result'}}
+      @proxy = Parallizer::Proxy.new(client, execution_results)
+    end
+    
+    should "respond to proxy method as symbol" do
+      assert @proxy.respond_to?(:a_method)
+    end
+    
+    should "respond to proxy method as string" do
+      assert @proxy.respond_to?('a_method')
+    end
+    
+    should "respond to methods inherited from object" do
+      assert @proxy.respond_to?(:to_s)
+    end
+    
+    should "not respond to methods that do not exist" do
+      assert !@proxy.respond_to?(:invalid_method)
+    end
+  end
+  
+end

data/test/parallizer_test.rb

@@ -0,0 +1,104 @@
+require 'test_helper'
+
+class ParallizerTest < Test::Unit::TestCase
+  class TestObject
+    def a_method(arg)
+      Thread.current
+    end
+    
+    def another_method
+      Thread.current
+    end
+  end
+  
+  class AnotherTestObject
+    def a_method
+      Thread.current
+    end
+    
+    def another_method
+      Thread.current
+    end
+  end
+  
+  context ".add_call" do
+    setup do
+      @client = TestObject.new
+      @parallizer = Parallizer.new(@client)
+    end
+    
+    execute do
+      @parallizer.add_call(@method, 'arg')
+    end
+    
+    context "with string method name added" do
+      setup do
+        @method = 'a_method'
+      end
+      
+      should "add call to calls" do
+        assert_equal [:a_method, 'arg'], @parallizer.calls.first
+      end
+    end
+    
+    context "with symbol method name" do
+      setup do
+        @method = 'a_method'
+      end
+      
+      should "add call to calls" do
+        assert_equal [:a_method, 'arg'], @parallizer.calls.first
+      end
+    end
+  end
+  
+  context ".execute" do
+    setup do
+      @client = TestObject.new
+      @parallizer = Parallizer.new(@client)
+    end
+    
+    execute do
+      @proxy = @parallizer.execute
+    end
+    
+    context "with existing method on client" do
+      setup do
+        @parallizer.add_call(:a_method, 'arg')
+      end
+      
+      should "execute method with add_call in a separate thread" do
+        assert_not_equal Thread.current, @proxy.a_method('arg')
+      end
+      
+      should "execute method not added with add_call in current thread" do
+        assert_equal Thread.current, @proxy.another_method
+      end
+    end
+  end
+  
+  context ".execute_all" do
+    setup do
+      @client1 = TestObject.new
+      @parallizer1 = Parallizer.new(@client1)
+      @parallizer1.add_call(:a_method, 'arg')
+      @client2 = AnotherTestObject.new
+      @parallizer2 = Parallizer.new(@client2)
+      @parallizer2.add_call(:a_method)
+    end
+
+    execute do
+      @proxy1, @proxy2 = Parallizer.execute_all(@parallizer1, @parallizer2)
+    end
+
+    should "execute methods with add_call in a separate thread" do
+      assert_not_equal Thread.current, @proxy1.a_method('arg')
+      assert_not_equal Thread.current, @proxy2.a_method
+    end
+
+    should "execute methods not added with add_call in current thread" do
+      assert_equal Thread.current, @proxy1.another_method
+      assert_equal Thread.current, @proxy2.another_method
+    end
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,21 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'test/unit'
+require 'shoulda'
+require 'always_execute'
+require 'mocha'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+require 'parallizer'
+
+class Test::Unit::TestCase
+end

metadata

@@ -0,0 +1,142 @@
+--- !ruby/object:Gem::Specification
+name: parallizer
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Michael Pearce
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-07-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.1.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.1.5
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.8.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.8.4
+- !ruby/object:Gem::Dependency
+  name: work_queue
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: work_queue
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: shoulda
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Execute your service layer in parallel.
+email: michael.pearce@bookrenter.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.md
+files:
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- VERSION
+- lib/parallizer.rb
+- lib/parallizer/proxy.rb
+- parallizer.gemspec
+- test/parallizer/proxy_test.rb
+- test/parallizer_test.rb
+- test/test_helper.rb
+homepage: http://github.com/michaelgpearce/parallizer
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 3246225958344608883
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Execute your service layer in parallel.
+test_files: []