class Event::Bus
Event
bus
Implements and in-process pub-sub events broadcaster allowing multiple observers to subscribe to different events that fire as your tests are executed.
Constants
- VERSION
Public Class Methods
new(resolver)
click to toggle source
Create Event::Bus
@param [#transform] resolver
A resolver which transforms Symbol, String, Class into an event Class.
# File lib/event/bus.rb, line 15 def initialize(resolver) @resolver = resolver @handlers = Hash.new { |h, k| h[k] = [] } end
Public Instance Methods
notify(event)
click to toggle source
Broadcast an event
@param [Object] event
An object of registered event class. This object is passed to the event handler.
# File lib/event/bus.rb, line 54 def notify(event) fail NoEventError, 'Please pass an event object, not a class' if event.is_a?(Class) @handlers[event.class.to_s].each { |handler| handler.call(event) } end
register(event_ids, handler_object = nil, &handler_proc)
click to toggle source
Register for an event
@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.
# File lib/event/bus.rb, line 33 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) Array(event_ids).flatten.each do |id| event_class = @resolver.transform(id) 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