A port of the node.js EventEmitter functionality
Classes:
- EventEmitter
- implements the event emitter functionality
Bases: object
Handles event emitting and listening
Public Methods:
- add_listener()
- add a listener for an event
- on()
- alias for add_listener()
- once()
- adds a listener, but only executes it once, then it is removed
- emit()
- trigger the listeners for an event
- remove_listener()
- remove a listener from an event
- remove_all_listeners()
- remove all listeners from an event
- listeners()
- get a copy of the listeners on an event
- set_max_listeners()
- set the maximum number of listeners for an event before warnings are issued (default: 10, None for no limit)
Adds a listener to an event
Parameters:
- event
- the event to listen for
- listener
- the handler for the event (should be a function / callable)
Emit an event, triggering the handlers on it with certain arguments
Parameters:
- event
- the event to trigger
- args
- arguments to pass to the triggered listeners
- kwargs
- keyword arguments to pass to the triggered listeners
Gets a COPY of the list of listeners on an event
Parameters:
- event
- the event for which to lookup the listeners
Parameters:
- event
- the event to listen for
- listener
- the listener function / callable
Clears all listeners from an event
Parameters:
- event
- the event to clear listeners from