def register(signal, callback, uid=None, replace=False, reqcbk=None,
timeout=1000):
"""
Register a callback to be called when the given signal is received.
Will timeout after timeout ms if response has not been received. The
timeout arg is only used for asynch requests. If a reqcbk callback has
been supplied the timeout arg is not used. The response value will be
returned for a synch request but nothing will be returned for an asynch
request.
:param signal: the signal that causes the callback to be launched
:type signal: int (see the `events.proto` file)
:param callback: the callback to be called when the signal is received
:type callback: function
:param uid: a unique id for the callback
:type uid: int
:param replace: should an existent callback with same uid be replaced?
:type replace: bool
:param reqcbk: a callback to be called when a response from server is
received
:type reqcbk: function(leap.common.events.events_pb2.EventResponse)
:param timeout: the timeout for synch calls
:type timeout: int
:return: the response from server for synch calls or nothing for asynch
calls.
:rtype: leap.common.events.events_pb2.EventsResponse or None
"""
return client.register(signal, callback, uid, replace, reqcbk, timeout)
def register(event, callback, uid=None, replace=False):
"""
Register a callback to be executed when an event is received.
:param event: The event that triggers the callback.
:type event: str
:param callback: The callback to be executed.
:type callback: callable(event, content)
:param uid: The callback uid.
:type uid: str
:param replace: Wether an eventual callback with same ID should be
replaced.
:type replace: bool
:return: The callback uid.
:rtype: str
:raises CallbackAlreadyRegistered: when there's already a callback
identified by the given uid and replace is False.
"""
return client.register(event, callback, uid, replace)
def setUpEventListener(self):
leap_events.register(catalog.VPN_STATUS_CHANGED,
self._handle_vpn_event)
