event-bus 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0acc21d9d8537e3f35b313333a293649a0c4aeb4
-  data.tar.gz: ba114e08659603bda5d5d0b0be739d0f244be7a2
+  metadata.gz: 079dd5fa10807c0fc4c29e661ecd7affcaf6488e
+  data.tar.gz: 6a6e8dcbb44d22cc086f026c967208a142d421b9
 SHA512:
-  metadata.gz: 939ddf5539f90fb5298bf4d741408e2a36cf5d6277fd9b30851b602487b1c349090bc84217ef22cba30a2b263f18c340e259b2937f918168814d8a3737f9eece
-  data.tar.gz: 2da980710a514e0bb75f7befccb5f044017cb5e5d85a7a43eb65484bc1c2549ca9b16770bfbb9fa5ee1adee166f033b200ad26e08ce2f768ff5793fa01f177e5
+  metadata.gz: bb4250749d76973f58250e81d3b7c3140ffbdb7c364f755621415b96a00605bd24d84a72898c8c84bfe18f12ed15acef072c2a6a2f62036309daa0167e272f28
+  data.tar.gz: b437df70ce05bfbc08fff20ff89b0f56ed6a6d1b638e7d570b5588d405ace3316d495aa05592ffd6c84f942cb50acbacf1a705a0a32815e6bef1ef18913c7454

data/lib/event/bus.rb

@@ -8,26 +8,49 @@ module Event
   # to subscribe to different events that fire as your tests are executed.
   #
   class Bus
+    # Create Event::Bus
+    #
+    # @param [#transform] resolver
+    #   A resolver which transforms Symbol, String, Class into an event Class.
     def initialize(resolver)
       @resolver = resolver
       @handlers = Hash.new { |h, k| h[k] = [] }
     end
 
     # Register for an event
-    def register(event_id, handler_object = nil, &handler_proc)
+    # 
+    # @param [String, Symbol, Class, Array] event_ids
+    #   If Array, register multiple events witht the same handler. If String,
+    #   Symbol, Class register handler for given event.
+    #
+    # @param [#call] handler_object
+    #   The handler object, needs to have method `#call`. Either
+    #   `handler_object` or `block` can be defined. The handler object gets the
+    #   event passed to `#call`.
+    #
+    # @yield
+    #   Handler block which gets the event passed as parameter.
+    def register(event_ids, handler_object = nil, &handler_proc)
       handler = handler_proc || handler_object
 
       fail ArgumentError, 'Please pass either an object#call or a handler block' if handler.nil? || !handler.respond_to?(:call)
 
-      event_class = @resolver.transform(event_id)
+      Array(event_ids).flatten.each do |id|
+        event_class = @resolver.transform(id)
 
-      fail EventNameResolveError, %(Transforming "#{event_id}" into an event name failed for unknown reason.) if event_class.nil?
-      @handlers[event_class.to_s] << handler
+        fail EventNameResolveError, %(Transforming "#{id}" into an event name failed for unknown reason.) if event_class.nil?
+        @handlers[event_class.to_s] << handler
+      end
 
       nil
     end
 
     # Broadcast an event
+    #
+    # @param [Object] event
+    #   An object of registered event class. This object is passed to the event
+    #   handler.
+    #
     def notify(event)
       fail NoEventError, 'Please pass an event object, not a class' if event.is_a?(Class)
 

data/lib/event/bus/version.rb

@@ -2,6 +2,6 @@
 module Event
   # Bus
   class Bus
-    VERSION = '0.1.0'
+    VERSION = '0.2.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: event-bus
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Dennis Günnewig
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-11-12 00:00:00.000000000 Z
+date: 2015-11-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler