resugan 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 16c94f13ca5e42a153322de77d1823e1989bea02
-  data.tar.gz: 9a9d847bc40016e0e112ed811ae7b8ed1eef4f41
+  metadata.gz: 4c7270a33c2bdc1644287e242de2ff11d60cedcd
+  data.tar.gz: dd89cd1a9e3548a6214cc75ac5dc6a8d518f63a9
 SHA512:
-  metadata.gz: 7a5aad719ad1290e86ff7943dfdc9fd85de5af47a236f2f9cf0d3854ea8dc131df6f02f5083e0a909e4cf57128b06ead7bb2bba7ce9162206ba2896e36c89c22
-  data.tar.gz: a7e03d9ce263b7ef90a8cfe7682d8efeadd3b1322f15d9b6f2fd5ab83ec265ec89db6807c8f566fa6a342f1c67aa918190f649d2e63703ea1cf151734bc6ee59
+  metadata.gz: 43c806a87a2b83c278d4d23aa93a3a375009b16eb1514affab58953f77189245576edb7076879c7049fcf2bf8e497180c719c6b84e2a7ee0e192316be62e889e
+  data.tar.gz: 41211f23f39cd001bff7db9f3a098d22404de7b3d1ccd537bf0945a5fcb8ec48681493638fca840388931b5e480aa36b96af22c80ad0fa33fed211cf613e91a0

data/README.md

@@ -24,11 +24,11 @@ Or install it yourself as:
 Register listeners:
 
 ```ruby
-  listener :event1 do |params|
+  _listener :event1 do |params|
     puts "hello! event 2 has been called!"
   end
 
-  listener :hay do |params|
+  _listener :hay do |params|
     puts "hello! someone said hay!"
   end
 ```
@@ -39,9 +39,9 @@ Generate events and wrap them in a resugan block:
 resugan {
   puts "I am now going to generate an event"
 
-  fire :event2
+  _fire :event2
 
-  fire :hay
+  _fire :hay
 }
 ```
 
@@ -49,7 +49,7 @@ Note that events don't have to be fired at the top level of the block, even obje
 
 The two events should fire and should print:
 
-```
+```ruby
 hello! event 2 has been called!
 hello! someone said hay!
 ```
@@ -65,24 +65,53 @@ Resugan supports namespaces, allowing you to group listeners and trigger them se
 
 
 ```ruby
-  listener :event1, namespace: "group1" do |params|
+  _listener :event1, namespace: "group1" do |params|
     puts "hello! event 2 has been called!"
   end
 
-  listener :event1, namespace: "group2" do |params|
+  _listener :event1, namespace: "group2" do |params|
     puts "hello! someone said hay!"
   end
 
   resugan "group1" do
-    fire :event1
+    _fire :event1
   end
 
   resugan "group2" do
-    fire :event1
+    _fire :event1
+  end
+```
+
+Behavior is as expected. Events under group1 will only be handled by listeners under group1 and so on.
+
+## Customizing the Event dispatcher
+
+The way events are consumed is entirely customizable. You can register your own event dispatcher:
+
+```ruby
+class MyCustomerDispatcher
+  def dispatch(namespace, events)
+    events.each do |k,v|
+      Resugan::Kernel.invoke(namespace, k, v)
+    end
   end
+end
 ```
 
-Behavior is as is expected. events under group1 will only be handled by listeners under group1 and so on.
+You need to implement your own dispatch method, captured events are passed as
+parameters.
+
+You can then set it as the default dispatcher:
+
+```ruby
+  Resugan::Kernel.set_default_dispatcher(MyCustomerDispatcher)
+```
+
+Or assign it to a specific namespace:
+
+```ruby
+  Resugan::Kernel.register_dispatcher(MyCustomerDispatcher, 'CustomGroup')
+```
 
 ## Development
 

data/lib/resugan/kernel.rb

@@ -24,16 +24,16 @@ module Resugan
 
     def self.register_with_namespace(namespace, event, listener_id = nil, block)
       @listener_ids = {} unless @listener_ids
-      @listener = {} unless @listener
+      @_listener = {} unless @_listener
 
       return self if listener_id && @listener_ids["#{namespace}_#{listener_id}"]
 
       event = "#{namespace}_#{event}".to_sym
 
-      unless @listener[event]
-        @listener[event] = [block]
+      unless @_listener[event]
+        @_listener[event] = [block]
       else
-        @listener[event] << block
+        @_listener[event] << block
       end
 
       @listener_ids["#{namespace}_#{listener_id}"] = block if listener_id
@@ -43,20 +43,20 @@ module Resugan
 
     def self.invoke(namespace, event, payload = [])
       event = "#{namespace}_#{event}".to_sym
-      if @listener[event]
-        @listener[event].each do |listener|
-          listener.call(payload.map { |p| p[:params] })
+      if @_listener[event]
+        @_listener[event].each do |_listener|
+          _listener.call(payload.map { |p| p[:params] })
         end
       end
     end
 
     def self.listeners
-      @listener
+      @_listener
     end
 
     def self.clear
       @listener_ids.clear if @listener_ids
-      @listener.clear if @listener
+      @_listener.clear if @_listener
     end
   end
 end

data/lib/resugan/object.rb

@@ -9,14 +9,14 @@ class Object
     context.invoke
   end
 
-  def fire(event, params = {})
+  def _fire(event, params = {})
     current_thread = Thread.current
     if current_thread.resugan_context
       current_thread.resugan_context.register(event, params)
     end
   end
 
-  def listener(event, options = {}, &block)
+  def _listener(event, options = {}, &block)
     Resugan::Kernel.register_with_namespace(options[:namespace], event, options[:id], ->(params) {
         block.call(params)
       })

data/lib/resugan/version.rb

@@ -1,3 +1,3 @@
 module Resugan
-  VERSION = "0.1.4"
+  VERSION = "0.1.5"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: resugan
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
 platform: ruby
 authors:
 - Joseph Emmanuel Dayo