exceptional_synchrony 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6b536ff75b55f1cd20206a7d4b6befd78555c587
+  data.tar.gz: 9dcb17118c8e3be70aa63a9a1491f0d50d697c1e
+SHA512:
+  metadata.gz: 894cf6ac51e3b063e87ad8c125721a3ea3fecdd07ba307aa7e9430182adb8da94a25a6039e3859b5d3920e316e12def9f1b563a7819c5f005c82c4a9567a258c
+  data.tar.gz: c6fee4da47ba5665bc2e5841d31c0a1fce01ca90d9480a9ac52c8e7d6bca4aef883d6a2cfa93e85b5dcf512466833b70317d7a3b558bd1f894bb09640fd3c4bb

data/.gitignore

@@ -0,0 +1,55 @@
+# OS X
+.DS_Store
+.AppleDouble
+.LSOverride
+Icon
+
+# Thumbnails
+._*
+
+# Files that might appear on external disk
+.Spotlight-V100
+.Trashes
+
+# Numerous always-ignore extensions
+*.diff
+*.err
+*.orig
+*.rej
+*.vi
+
+# OS or Editor folders
+.cache
+.project
+.settings
+.tmproj
+nbproject
+Thumbs.db
+
+# Folders to ignore
+.hg
+.svn
+.CVS
+intermediate
+publish
+.bundle
+
+# Vim
+*.s[a-w][a-z]
+*.un~
+Session.vim
+.netrwhist
+*~
+
+# RubyMine
+.idea/
+
+# Ruby
+log/
+coverage/
+
+# jmeter
+*.jt
+
+# else
+*.log

data/.ruby-gemset

@@ -0,0 +1 @@
+exceptional_synchrony

data/Gemfile

@@ -0,0 +1,6 @@
+# ruby '2.0.0'
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in attr_default.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,128 @@
+PATH
+  remote: .
+  specs:
+    exceptional_synchrony (1.0.1)
+      em-http-request
+      em-synchrony (~> 1.0.3)
+      eventmachine (~> 1.0.3)
+      exception_handling
+      hobo_support
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actionmailer (3.2.13)
+      actionpack (= 3.2.13)
+      mail (~> 2.5.3)
+    actionpack (3.2.13)
+      activemodel (= 3.2.13)
+      activesupport (= 3.2.13)
+      builder (~> 3.0.0)
+      erubis (~> 2.7.0)
+      journey (~> 1.0.4)
+      rack (~> 1.4.5)
+      rack-cache (~> 1.2)
+      rack-test (~> 0.6.1)
+      sprockets (~> 2.2.1)
+    activemodel (3.2.13)
+      activesupport (= 3.2.13)
+      builder (~> 3.0.0)
+    activerecord (3.2.13)
+      activemodel (= 3.2.13)
+      activesupport (= 3.2.13)
+      arel (~> 3.0.2)
+      tzinfo (~> 0.3.29)
+    activeresource (3.2.13)
+      activemodel (= 3.2.13)
+      activesupport (= 3.2.13)
+    activesupport (3.2.13)
+      i18n (= 0.6.1)
+      multi_json (~> 1.0)
+    addressable (2.3.5)
+    arel (3.0.3)
+    builder (3.0.4)
+    cookiejar (0.3.0)
+    crack (0.4.1)
+      safe_yaml (~> 0.9.0)
+    em-http-request (1.1.2)
+      addressable (>= 2.3.4)
+      cookiejar
+      em-socksify (>= 0.3)
+      eventmachine (>= 1.0.3)
+      http_parser.rb (>= 0.6.0)
+    em-socksify (0.3.0)
+      eventmachine (>= 1.0.0.beta.4)
+    em-synchrony (1.0.3)
+      eventmachine (>= 1.0.0.beta.1)
+    erubis (2.7.0)
+    eventmachine (1.0.3)
+    exception_handling (0.1.2)
+      actionmailer (= 3.2.13)
+      actionpack (= 3.2.13)
+      activesupport (= 3.2.13)
+      eventmachine (>= 0.12.10)
+    hike (1.2.3)
+    hobo_support (2.0.1)
+      rails (~> 3.2.0)
+    http_parser.rb (0.6.0)
+    i18n (0.6.1)
+    journey (1.0.4)
+    json (1.8.1)
+    mail (2.5.4)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.25.1)
+    minitest (4.7.5)
+    multi_json (1.8.4)
+    polyglot (0.3.3)
+    rack (1.4.5)
+    rack-cache (1.2)
+      rack (>= 0.4)
+    rack-ssl (1.3.3)
+      rack
+    rack-test (0.6.2)
+      rack (>= 1.0)
+    rails (3.2.13)
+      actionmailer (= 3.2.13)
+      actionpack (= 3.2.13)
+      activerecord (= 3.2.13)
+      activeresource (= 3.2.13)
+      activesupport (= 3.2.13)
+      bundler (~> 1.0)
+      railties (= 3.2.13)
+    railties (3.2.13)
+      actionpack (= 3.2.13)
+      activesupport (= 3.2.13)
+      rack-ssl (~> 1.3.2)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (>= 0.14.6, < 2.0)
+    rake (10.1.1)
+    rdoc (3.12.2)
+      json (~> 1.4)
+    rr (1.1.2)
+    safe_yaml (0.9.7)
+    sprockets (2.2.2)
+      hike (~> 1.2)
+      multi_json (~> 1.0)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    thor (0.18.1)
+    tilt (1.4.1)
+    treetop (1.4.15)
+      polyglot
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.38)
+    webmock (1.17.1)
+      addressable (>= 2.2.7)
+      crack (>= 0.3.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  exceptional_synchrony!
+  minitest
+  rr (~> 1.1.2)
+  thor
+  webmock (~> 1.17.1)

data/README.md

@@ -0,0 +1,4 @@
+exceptional_synchrony
+=====================
+
+Extensions to EventMachine/Synchrony to work well with exceptions

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/Thorfile

@@ -0,0 +1,42 @@
+require 'thor'
+
+$LOAD_PATH.unshift('lib')
+
+class Dev < Thor
+  package_name 'dev'
+
+  desc 'test' , 'Run the entire test suite or a single file.'
+  method_options :file => :string, :n => :string
+  def test
+
+    ENV['RACK_ENV'] = 'test'
+
+    require 'bundler'
+    Bundler.setup(:default, :development)
+
+    require './test/test_helper.rb'
+
+    # Minitest is very bad and piggy backs on the Global arguments just like everyone else.
+    # Let's stop it from trying to parse Thor's arguments.
+    clear_args
+
+    add_args('-n', options[:n]) if options[:n]
+
+    # If we have a single file run it, otherwise run them all.
+    if single_file = options[:file]
+      require single_file
+    else
+      Dir.glob('./test/**/*_test.rb') { |f| require f }
+    end
+  end
+
+private
+  def clear_args
+    ARGV.shift(ARGV.length)
+  end
+
+  def add_args(*args)
+    args.each { |arg| ARGV << arg }
+  end
+end
+

data/exceptional_synchrony.gemspec

@@ -0,0 +1,26 @@
+require File.expand_path('../lib/exceptional_synchrony/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.name        = 'exceptional_synchrony'
+  gem.date        = '2014-01-16'
+  gem.summary     = 'Extensions to EventMachine/Synchrony to work well with exceptions'
+  gem.description = %q{}
+  gem.authors     = ['Colin Kelley']
+  gem.email       = 'colin@invoca.com'
+  gem.homepage    = 'https://github.com/Invoca/exceptional_synchrony'
+  gem.license     = 'MIT'
+  gem.files       = `git ls-files`.split($/)
+  gem.version     = ExceptionalSynchrony::VERSION
+
+  gem.add_dependency 'exception_handling'
+  gem.add_dependency 'eventmachine', '~> 1.0.3'
+  gem.add_dependency 'em-synchrony', '~> 1.0.3'
+  gem.add_dependency 'em-http-request'
+  gem.add_dependency 'hobo_support'
+
+  gem.add_development_dependency 'thor'
+  gem.add_development_dependency 'minitest'
+  gem.add_development_dependency 'webmock', '~> 1.17.1'
+
+  gem.add_development_dependency 'rr', '~> 1.1.2'
+end

data/lib/exceptional_synchrony.rb

@@ -0,0 +1,14 @@
+require 'hobo_support'
+require 'em-synchrony'
+require 'em-synchrony/em-http'
+require 'exception_handling'
+
+
+module ExceptionalSynchrony
+end
+
+require_relative 'exceptional_synchrony/callback_exceptions'
+require_relative 'exceptional_synchrony/event_machine_proxy'
+require_relative 'exceptional_synchrony/limited_work_queue'
+require_relative 'exceptional_synchrony/parallel_sync'
+require_relative 'exceptional_synchrony/version'

data/lib/exceptional_synchrony/callback_exceptions.rb

@@ -0,0 +1,43 @@
+module ExceptionalSynchrony
+  module CallbackExceptions
+    class Failure < StandardError; end
+
+    class << self
+      def ensure_callback(deferrable, &block)
+        result = return_exception(&block)
+        deferrable.succeed(*Array(result))
+      end
+
+      def map_deferred_result(deferrable)
+        deferred_status = deferrable.instance_variable_get(:@deferred_status)
+        deferred_args = deferrable.instance_variable_get(:@deferred_args)
+        result = (deferred_args && deferred_args.size == 1) ? deferred_args.first : deferred_args
+
+        case deferred_status
+        when :succeeded
+          if result.is_a?(Exception)
+            raise result
+          else
+            result
+          end
+        when :failed
+          if result.respond_to?(:error) && result.error =~ /timeout/i
+            raise Timeout::Error
+          else
+            raise Failure, result.inspect
+          end
+        else
+          raise ArgumentError, "No deferred status set yet: #{deferred_status.inspect} #{result.inspect}"
+        end
+      end
+
+      def return_exception(*args)
+        begin
+          yield *args
+        rescue Exception => ex
+          ex
+        end
+      end
+    end
+  end
+end

data/lib/exceptional_synchrony/event_machine_proxy.rb

@@ -0,0 +1,96 @@
+# This class is for Dependency Injection of EventMachine.  All EventMachine interactions should go through here.
+
+require 'eventmachine'
+require 'em-http'
+require 'em-synchrony/em-http'
+
+module ExceptionalSynchrony
+  class EventMachineProxy
+
+    attr_reader :connection
+
+    WRAP_WITH_ENSURE_COMPLETELY_SAFE = (ENV['RACK_ENV'] != 'test')
+
+    def initialize(proxy_class, connection_class)
+      @proxy_class = proxy_class
+      @synchrony = defined?(@proxy_class::Synchrony) ?  @proxy_class::Synchrony : @proxy_class
+      @connection = connection_class
+
+      proxy_class.error_handler do |error|
+        ExceptionHandling.log_error(error, "ExceptionalSynchrony uncaught exception: ")
+      end
+    end
+
+    def add_timer(seconds, &block)
+      @synchrony.add_timer(seconds) do
+        ensure_completely_safe("add_timer") do
+          block.call
+        end
+      end
+    end
+
+    def add_periodic_timer(*args, &block)
+      @synchrony.add_periodic_timer(*args) do
+        ensure_completely_safe("add_periodic_timer") do
+          block.call
+        end
+      end
+    end
+
+    def sleep(seconds)
+      @synchrony.sleep(seconds)
+    end
+
+    def next_tick(&block)
+      @synchrony.next_tick do
+        ensure_completely_safe("next_tick") do
+          block.call
+        end
+      end
+    end
+
+    def stop
+      @proxy_class.stop
+      @proxy_class.next_tick { } #Fake out EventMachine's epoll mechanism so we don't block until timers fire
+    end
+
+    def connect(server, port = nil, handler = nil, *args, &block)
+      @proxy_class.connect(server, port, handler, *args, &block)
+    end
+
+    def run(&block)
+      ensure_completely_safe("run") do
+        if @proxy_class.respond_to?(:synchrony)
+          @proxy_class.synchrony(&block)
+        else
+          @proxy_class.run(&block)
+        end
+      end
+    end
+
+    def reactor_running?
+      @proxy_class.reactor_running?
+    end
+
+    def run_and_stop
+      ret = nil
+      run do
+        ret = yield
+        stop
+      end
+      ret
+    end
+
+    def ensure_completely_safe(message)
+      if WRAP_WITH_ENSURE_COMPLETELY_SAFE
+        ExceptionHandling.ensure_completely_safe(message) do
+          yield
+        end
+      else
+        yield
+      end
+    end
+  end
+
+  EMP = EventMachineProxy.new(EventMachine, EventMachine::HttpRequest)
+end

data/lib/exceptional_synchrony/limited_work_queue.rb

@@ -0,0 +1,52 @@
+module ExceptionalSynchrony
+  class LimitedWorkQueue
+    def initialize(em, limit)
+      @em = em
+      limit > 0 or raise ArgumentError, "limit must be positive"
+      @limit = limit
+      @worker_count = 0
+      @job_procs = []
+    end
+
+    # Adds a job_proc to work.
+    def add(proc = nil, &block)
+      job = proc || block
+      job.respond_to?(:call) or raise "Must respond_to?(:call)! #{job.inspect}"
+      if @job_procs.any? && job.respond_to?(:merge) && (merged_queue = job.merge(@job_procs))
+        @job_procs = merged_queue
+      else
+        @job_procs << job
+      end
+      work!
+    end
+
+    def workers_empty?
+      @worker_count.zero?
+    end
+
+    def workers_full?
+      @worker_count >= @limit
+    end
+
+    def queue_empty?
+      @job_procs.empty?
+    end
+
+    private
+    def work!
+      until queue_empty? || workers_full?
+        job_proc = @job_procs.shift
+        @worker_count += 1
+        Fiber.new do
+          job_proc.call
+          worker_done
+        end.resume
+      end
+    end
+
+    def worker_done
+      @worker_count -= 1
+      work!
+    end
+  end
+end