taurus taurus

Previous topic

ErrorIt

Next topic

EventListener

This Page

EventGenerator

Inheritance diagram of EventGenerator

class EventGenerator(name, events_active=True)

Bases: taurus.core.util.object.Object

Base class capable of firing events

WaitTimeout = 0.1
fireEvent(val, event_val=None)

Fires an event. :param val: event value :type val: object

getEventsActive()

Determines is events are active :return: True if events are active or False otherwise :rtype: bool

isSubscribed(cb, data=None)

Determines if the given callback is registered for this event.

Parameters:
  • cb (callable) – a callable object
  • data (object) – extra data to send each time an event is triggered on the given callback. Default is None
Returns:

True if callback is registered or False otherwise

Return type:

bool

lock()

Locks this event generator

read()

Read the last event

Returns:the last event value
Return type:object
setEventsActive(events_active)

(De)activates events on this event generator.

Parameters:events_active (bool) – activate/deactivate events
subscribeEvent(cb, data=None)

Subscribes to the event

Parameters:
  • cb (callable) – a callable object
  • data (object) – extra data to send each time an event is triggered on the given callback. Default is None
unlock()

Unlocks this event generator

unsubscribeDeletedEvent(cb_ref)

for internal usage only

unsubscribeEvent(cb, data=None)

Unsubscribes the given callback from the event. If the callback is not a listener for this event a debug message is generated an nothing happens.

Parameters:
  • cb (callable) – a callable object
  • data (object) – extra data to send each time an event is triggered on the given callback. Default is None
waitEvent(val=None, equal=True, any=False, timeout=None, stack=None)

Waits for an event to occur

Parameters:
  • val (object) – event value
  • equal (bool) – check for equality. Default is True
  • any (bool) – if True unblock after first event, not matter what value it has. Default is False.
  • timeout (float) – maximum time to wait (seconds). Default is None meaning wait forever.
  • stack – For internal usage only.
Returns:

the value of the event that unblocked the wait

Return type:

object