def registerAll(self, listener):
""" Associate listener with all messages created by this Dispatcher.
@param listener callable to receive messages
@return True if associated with one or more handler; otherwise False
"""
return self.register(
listener,
*[maybeName(i) for v in self.messageTypes.values() for i in v])
def __call__(self, name, args):
""" Send message to each listener.
@param name method name
@param args arguments for message instance
@return None
"""
results = []
try:
messageType = self.messageTypes[name]
listeners = self.listeners[maybeName(messageType[0])]
except (KeyError, ):
return results
message = messageType[0](**args)
for listener in listeners:
try:
results.append(listener(message))
except (Exception, ):
errmsg = ("Exception in message dispatch. "
"Handler '%s' for '%s'")
self.logger.exception(errmsg, maybeName(listener), name)
results.append(None)
return results
def register(self, listener, *types):
""" Associate listener with message types created by this Dispatcher.
@param listener callable to receive messages
@param *types zero or more message types to associate with listener
@return True if associated with one or more handler; otherwise False
"""
count = 0
for messagetype in types:
key = maybeName(messagetype)
listeners = self.listeners.setdefault(key, [])
if listener not in listeners:
listeners.append(listener)
count += 1
return count > 0
def unregister(self, listener, *types):
""" Disassociate listener with message types created by this Dispatcher.
@param listener callable to no longer receive messages
@param *types zero or more message types to disassociate with listener
@return True if disassociated with one or more handler; otherwise False
"""
count = 0
for messagetype in types:
try:
listeners = self.listeners[maybeName(messagetype)]
except (KeyError, ):
pass
else:
if listener in listeners:
listeners.remove(listener)
count += 1
return count > 0