async_emitter 1.0.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    OGI1OGE0ZDUzZTIwN2JiMmFmMWY5N2VhNDVlYWRjM2NjOTIwNGVjOQ==
+  data.tar.gz: !binary |-
+    NzFlMzk0NzAxNjJiZWQxNWI1ZDI3Y2MxNDRjMDQ1MDUzNDA4YzNjZQ==
+SHA512:
+  metadata.gz: !binary |-
+    ZTRmNTJkOTBjMTRmYmJlYjIyZmRkM2Y4NzBmYjRiMmE0OWMwMmMzZWQ2NTRj
+    YjI0OGMwM2MyODgyOTA5NGIyNjU5Yjk5MTY3OTllNTJiZjI4NWVhZTA5NDlm
+    MmI2ZjMzMTY1MmVjNTRhYmU5NzJkMzlkMWNlOGU1NmQ1YzA1OGI=
+  data.tar.gz: !binary |-
+    OGVjMTJmYjc0MjYxZDdhMzMzYjU3NzkxMjU3OTQ2YmUyMTU2YjkyYmVmZTgw
+    MDcyMmNkZTUwNjdhNTIyMGM0ZmM1MDk3YzQ2ZmViMjQwYjAzOGNjMDU1MjY1
+    N2YwZjkxM2EzMzJkMWUwOWI4OTAwY2M5MzkxMjllYWU0Y2Q2YTc=

data/lib/async_emitter.rb

@@ -0,0 +1,132 @@
+require 'thread'
+
+class AsyncEmitter
+=begin
+	The AsyncEmitter class provides a mechanism for asyncronous communication
+	in Ruby programs. Each instantiation provides notification of events
+	registered using any object that is valid as a Hash key. Multiple
+	events can be registered for each key and listeners can be registered 
+	for one or many events. Listeners for a key event can be released.
+
+	example:
+	emitter = AsyncEmitter.new
+	emitter.on :error, lambda { |e| puts "Error: #{e}" }
+	emitter.on :data, lambda { |data| puts "Data: #{data}" }
+
+	begin
+		data = get_data_from_somewhere
+		emitter.emit :data, data
+	rescue Exception => e
+		emitter.emit :error, e
+	end
+
+	Where more then one listener is registered for an event they are
+	notified in the order they are recieved.
+=end
+
+	def initialize
+		@emissions = {}
+	end
+
+
+	########################################################################
+	# Register for notification
+	#
+	# token - any valid Hash key representing the event
+	# p - a procedure to be called on notification
+	# once_only - if true the notification is removed after being fired once
+	# ######################################################################
+	def on (token, p, once_only=false)
+		@emissions[token] ||= {}
+		@emissions[token][:p] ||= []
+		@emissions[token][:data] ||= []
+		@emissions[token][:semaphore] ||= Mutex.new
+		@emissions[token][:cv] ||= ConditionVariable.new 
+		
+		@emissions[token][:p].push Hash[:p => p, :o => once_only]
+
+		@emissions[token][:thread] ||= Thread.new do
+			
+			@emissions[token][:active] = true
+			
+			while @emissions[token][:active]
+				@emissions[token][:semaphore].synchronize do
+					self.post_data_for token
+					@emissions[token][:cv].wait @emissions[token][:semaphore]
+					if @emissions[token][:active]
+						self.post_data_for token
+					end
+				end
+			end
+
+		end
+
+	end
+
+	########################################################################
+	# Register for single notification - convenience and self documenting
+	# method  for: on token, proc, true
+	#
+	# token - any valid Hash key representing the event
+	# p - a procedure to be called on notification
+	# ######################################################################
+	def once (token, p)
+		self.on token, p, true
+	end
+
+	def emit (token, data)
+		@emissions[token][:semaphore] ||= Mutex.new
+		@emissions[token][:cv] ||= ConditionVariable.new 
+		@emissions[token][:data] ||= []
+
+		@emissions[token][:semaphore].synchronize do
+			@emissions[token][:data].push data
+			@emissions[token][:cv].signal
+		end
+
+	end
+
+
+	########################################################################
+	# Remove notification for an event
+	#
+	# token - Hash key representing the event
+	########################################################################
+	def release (token)
+		@emissions[token][:active] = false
+		Thread.kill @emissions[token][:thread]
+	end
+
+	protected
+	def post_data_for (token)
+		@emissions[token][:p].each_index do |i|
+			o = @emissions[token][:p][i][:o]
+		       	p = @emissions[token][:p][i][:p]
+			
+			if o
+				@emissions[token][:p].slice! i
+			end
+
+			if i >= @emissions[token][:p].length - 1	
+				while @emissions[token][:data].length > 0 do
+					data = @emissions[token][:data].shift 
+					p.call data
+					if o 
+						@emissions[token][:data] = []
+						break
+					end
+				end
+			else
+				@emissions[token][:data].each do |data|
+					p.call data
+					if o 
+						break
+					end
+				end
+			end
+
+		end
+	end
+end
+
+

metadata

@@ -0,0 +1,44 @@
+--- !ruby/object:Gem::Specification
+name: async_emitter
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Greg Martin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-04-25 00:00:00.000000000 Z
+dependencies: []
+description: An asyncronous emitter class for ruby
+email: greg@softsprocket.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/async_emitter.rb
+homepage: http://rubygems.org/gems/async_emitter.rb
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.6
+signing_key: 
+specification_version: 4
+summary: AsyncEmitter
+test_files: []