Source code for ftrack_api.event.base

# :coding: utf-8
# :copyright: Copyright (c) 2014 ftrack

from builtins import str
import uuid

[docs]class Event( """Represent a single event."""
[docs] def __init__( self, topic, id=None, data=None, sent=None, source=None, target="", in_reply_to_event=None, ): """Initialise event. *topic* is the required topic for the event. It can use a dotted notation to demarcate groupings. For example, 'ftrack.update'. *id* is the unique id for this event instance. It is primarily used when replying to an event. If not supplied a default uuid based value will be used. *data* refers to event specific data. It should be a mapping structure and defaults to an empty dictionary if not supplied. *sent* is the timestamp the event is sent. It will be set automatically as send time unless specified here. *source* is information about where the event originated. It should be a mapping and include at least a unique id value under an 'id' key. If not specified, senders usually populate the value automatically at publish time. *target* can be an expression that targets this event. For example, a reply event would target the event to the sender of the source event. The expression will be tested against subscriber information only. *in_reply_to_event* is used when replying to an event and should contain the unique id of the event being replied to. """ super(Event, self).__init__() self._data = dict( id=id or uuid.uuid4().hex, data=data or {}, topic=topic, sent=sent, source=source or {}, target=target, in_reply_to_event=in_reply_to_event, ) self._stopped = False
[docs] def stop(self): """Stop further processing of this event.""" self._stopped = True
[docs] def is_stopped(self): """Return whether event has been stopped.""" return self._stopped
def __str__(self): """Return string representation.""" return "<{0} {1}>".format(self.__class__.__name__, str(self._data)) def __getitem__(self, key): """Return value for *key*.""" return self._data[key] def __setitem__(self, key, value): """Set *value* for *key*.""" self._data[key] = value def __delitem__(self, key): """Remove *key*.""" del self._data[key] def __iter__(self): """Iterate over all keys.""" return iter(self._data) def __len__(self): """Return count of keys.""" return len(self._data)