event_aggregator 1.1.1 → 1.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 --- 
-SHA1: 
-  data.tar.gz: 8e02703a95246297b726756d8d37d3a19a518d1e
-  metadata.gz: 7fc37e093b95d0031783fe65badfa94aab39e8d8
 SHA512: 
-  data.tar.gz: e54aa9a193509076e5814213466d2697656b51d6d3f584752103cb5e45063b46bde002c0d8f052b51a0466f097329e9acc4531e39705cd1af2d75303807b8228
-  metadata.gz: 9dd7dd3a8910ccfc61167e623a519ec3cd002b318fecfb1cbe9f2dd4d127cd1c44068d525ebd934afea8799d1538bcf1f139816c9283372913140614f9e0a1ca
+  metadata.gz: e881aefb5e0e91954065b076a7812c034893cb7d453ee2bb83d7cc21547028ebff2255f0b8284a7495c480df6068e7013c791dfde491cd0c82ce1a4ecbe383c0
+  data.tar.gz: 5e6d092c11a2c3740e91385823fb3f5c66f63759eee94c4e17a578b927cccb1c666b4853202a8ec47d7c068220220bc0944d8bd39711d4ad59261b676caa00b9
+SHA1: 
+  metadata.gz: 7c6f7f2e65af541dd7a64557fbae4f5ca2838cb2
+  data.tar.gz: 89ba6cafac97b7bd659843c1510aaa4c75281f7a

data/.travis.yml

@@ -12,10 +12,9 @@ rvm:
   - ruby-head
 matrix:
   allow_failures:
+    - rvm: 1.8.7
     - rvm: jruby-head
     - rvm: ruby-head
-    - rvm: jruby-18mode
-    - rvm: 1.8.7
     - rvm: 1.9.2
     - rvm: rbx
   fast_finish: true

data/README.md

@@ -74,24 +74,16 @@ Or install it yourself as:
 	#=> data
 
 ### IMPORTANT: Asynchronous by Default
-Message.publish is asynchronous by default. This means that if you run event_aggregator in a script that terminates, there is a chance that the script will terminate before the workers have processed the messages and you can receive an error looking like the following: 
-	
-	W, [2013-12-29T11:17:29.659902 #48097]  WARN -- : Terminating task: type=:call, meta={:method_name=>:perform}, status=:callwait
-	D, [2013-12-29T11:17:29.660142 #48097] DEBUG -- : Celluloid::PoolManager: async call `perform` aborted!
-	Celluloid::Task::TerminatedError: task was terminated
-		/Users/user/.rvm/gems/ruby-1.9.3-p429/gems/celluloid-0.15.2/lib/celluloid/tasks/task_fiber.rb:32:in `terminate'
-		/Users/user/.rvm/gems/ruby-1.9.3-p429/gems/celluloid-0.15.2/lib/celluloid/actor.rb:404:in `block in cleanup'
-		/Users/user/.rvm/gems/ruby-1.9.3-p429/gems/celluloid-0.15.2/lib/celluloid/actor.rb:404:in `each'
-		/Users/user/.rvm/gems/ruby-1.9.3-p429/gems/celluloid-0.15.2/lib/celluloid/actor.rb:404:in `cleanup'
-		/Users/user/.rvm/gems/ruby-1.9.3-p429/gems/celluloid-0.15.2/lib/celluloid/actor.rb:375:in `shutdown'
-		/Users/user/.rvm/gems/ruby-1.9.3-p429/gems/celluloid-0.15.2/lib/celluloid/actor.rb:185:in `run'
-		/Users/user/.rvm/gems/ruby-1.9.3-p429/gems/celluloid-0.15.2/lib/celluloid/actor.rb:157:in `block in initialize'
-		/Users/user/.rvm/gems/ruby-1.9.3-p429/gems/celluloid-0.15.2/lib/celluloid/thread_handle.rb:13:in `block in initialize'
-		/Users/user/.rvm/gems/ruby-1.9.3-p429/gems/celluloid-0.15.2/lib/celluloid/internal_pool.rb:100:in `call'
-		/Users/user/.rvm/gems/ruby-1.9.3-p429/gems/celluloid-0.15.2/lib/celluloid/internal_pool.rb:100:in `block in create'
-	W, [2013-12-29T11:17:29.660271 #48097]  WARN -- : Terminating task: type=:finalizer, meta={:method_name=>:__shutdown__}, status=:callwait
-
-To make it synchronous (not recommended) use the following:
+Message.publish is asynchronous by default. This means that if you run event_aggregator in a script that terminates, there is a chance that the script will terminate before the workers have processed the messages. This might cause errors.
+
+A simple way to get around this problem is to do the following:
+
+	#....setup...
+	EventAggregator::Message.new("foo2", "data").publish
+
+	gets #This will wait for user input.
+
+To make the message processing synchronous (not recommended) use the following:
 
 	EventAggregator::Message.new("foo", "data", false).publish
 	#=> data
@@ -129,6 +121,33 @@ This enables the following:
 	#=> "foo bar bar bar bar"
 
 
+## Producers
+In version 1.1+ the concept of producers are added. They are blocks or methods that responds to requests. A producer must be registered, which is done like this:
+
+	#listener is an instance of a class that includes EventAggregator::Listener, similar to the Foo class above.
+	listener.producer_register("MultiplyByTwo", lambda{|data| return data*2})
+
+Then, somewhere in your code, you can do the following:
+
+	number = EventAggregator::Message.new("MultiplyByTwo", 3).request
+	puts number
+	# => 6
+
+The producers are a good way to abstract away the retrieval of certain information.
+
+Note: Message reqests are always blocking.
+
+## Message translation
+In version 1.1+ the concept of message translation is added. This allows you to have messages on a specific type spawn other messages. To translate message type "type_1" into "type_2" you do:
+	
+	#Anywhere in your code
+	EventAggregator::Aggregator.translate_message_with("type_1", "type_2")
+
+It is also possible to transform the data in the conversion. To double the data value between "type_1" and "type_2" you do:
+
+	EventAggregator::Aggregator.translate_message_with("type_1", "type_2", lambda{|data| data*2})
+
+This is often very usefull when you have one module that has a specific task, and it should be truly independent of other objects, even the message type they produce. The message translation allows you to have one file where you list all translations to give you a good overview and high maintainability.
 
 ## Usage Considerations
 All messages are processed asynchronous by default. This means that there might be raise conditions in your code. 

data/event_aggregator.gemspec

@@ -25,5 +25,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'faker', '~> 1.2'
   spec.add_development_dependency 'coveralls', '~> 0.7'
   
-  spec.add_dependency 'eventmachine'
+  spec.add_dependency 'thread'
 end

data/lib/event_aggregator.rb

@@ -1,4 +1,4 @@
-require "eventmachine"
+require "thread/pool"
 require "event_aggregator/version"
 require "event_aggregator/aggregator"
 require "event_aggregator/listener"

data/lib/event_aggregator/aggregator.rb

@@ -11,7 +11,7 @@ module EventAggregator
 	# 	end
 	class Aggregator
 		class <<self; private :new; end
-
+		@@pool = Thread.pool(4)
 		@@listeners = Hash.new{|h, k| h[k] = Hash.new }
 		@@listeners_all = Hash.new
 		@@message_translation = Hash.new{|h, k| h[k] = Hash.new }
@@ -156,8 +156,8 @@ module EventAggregator
 		private
 		def self.perform_message_job(data, callback, async, consisten_data)
 			case [async, consisten_data]
-			when [true, true]   then EventMachine.run{EventAggregator::MessageJob.new.perform(data,       callback) ; EventMachine.stop }
-			when [true, false]  then EventMachine.run{EventAggregator::MessageJob.new.perform(data.clone, callback) ; EventMachine.stop }
+			when [true, true]   then @@pool.process{ EventAggregator::MessageJob.new.perform(data,       callback) }
+			when [true, false]  then @@pool.process{ EventAggregator::MessageJob.new.perform(data.clone, callback) }
 			when [false, true]  then EventAggregator::MessageJob.new.perform(data,       callback)
 			when [false, false] then EventAggregator::MessageJob.new.perform(data.clone, callback)
 			end

data/lib/event_aggregator/listener.rb

@@ -71,7 +71,7 @@ module EventAggregator
 		#
 		# Excample: 
 		# 			listener.producer_register("MultiplyByTwo", lambda{|data| return data*2})
-		# 			number = EventAggregator::Message.new("MultiplyByTwo", 3)
+		# 			number = EventAggregator::Message.new("MultiplyByTwo", 3).request
 		# 			# => 6
 		#
 		def producer_register(message_type, callback)

data/lib/event_aggregator/version.rb

@@ -1,3 +1,3 @@
 module EventAggregator
-  VERSION = "1.1.1"
+  VERSION = "1.1.2"
 end

data/spec/spec_helper.rb

@@ -4,10 +4,20 @@ require 'rspec'
 #require 'rack/test'
 require "faker"
 require "event_aggregator"
+#require "sucker_punch/testing/inline"
 require 'coveralls'
 Coveralls.wear!
 
 
+
+class Thread::Pool
+	
+	# Public: Overriding the process-call of the thread::pool so we can do tests better
+	def process (*args, &block)
+		block.call(*args)
+	end
+end
+
 RSpec.configure do |config|
   config.treat_symbols_as_metadata_keys_with_true_values = true
   config.run_all_when_everything_filtered = true

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: event_aggregator
 version: !ruby/object:Gem::Version 
-  version: 1.1.1
+  version: 1.1.2
 platform: ruby
 authors: 
 - Stephan Eriksen
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2014-02-06 00:00:00 Z
+date: 2014-02-07 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: bundler
@@ -75,7 +75,7 @@ dependencies:
   type: :development
   version_requirements: *id006
 - !ruby/object:Gem::Dependency 
-  name: eventmachine
+  name: thread
   prerelease: false
   requirement: &id007 !ruby/object:Gem::Requirement 
     requirements: