summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authordrebs <drebs@leap.se>2013-04-01 17:16:23 -0300
committerdrebs <drebs@leap.se>2013-04-01 17:16:23 -0300
commit9b5a6961a5662edf11ecee36caa5accbbda0281d (patch)
tree744352d753fc052f5b2c3e448fb2fc5d83f6d18d
parent9d6f27cb2a83cb36d5201439e02dc1fb2048765b (diff)
Add README and changes file for events mechanism.
-rw-r--r--changes/feature_events_signals1
-rw-r--r--src/leap/common/events/README45
2 files changed, 46 insertions, 0 deletions
diff --git a/changes/feature_events_signals b/changes/feature_events_signals
new file mode 100644
index 0000000..ae0b7b0
--- /dev/null
+++ b/changes/feature_events_signals
@@ -0,0 +1 @@
+ o Add a mechanism for events signaling between components.
diff --git a/src/leap/common/events/README b/src/leap/common/events/README
new file mode 100644
index 0000000..61b320d
--- /dev/null
+++ b/src/leap/common/events/README
@@ -0,0 +1,45 @@
+Events mechanism
+================
+
+The events mechanism allows for "components" to send signal events to each
+other by means of a centralized server. Components can register with the
+server to receive signals of certain types, and they can also send signals to
+the server that will then redistribute these signals to registered components.
+
+
+Listening daemons
+-----------------
+
+Both components and the server listen for incoming messages by using a
+listening daemon that runs in its own thread. The server daemon has to be
+started explicitly, while components daemon will be started whenever a
+component registers with the server to receive messages.
+
+
+How to use it
+-------------
+
+To start the events server:
+
+>>> from leap.common.events import server
+>>> server.ensure_server(port=8090)
+
+To register a callback to be called when a given signal is raised:
+
+>>> from leap.common.events import (
+>>> register,
+>>> events_pb2 as proto,
+>>> )
+>>>
+>>> def mycallback(sigreq):
+>>> print str(sigreq)
+>>>
+>>> events.register(signal=proto.CLIENT_UID, callback=mycallback)
+
+To signal an event:
+
+>>> from leap.common.events import (
+>>> signal,
+>>> events_pb2 as proto,
+>>> )
+>>> signal(proto.CLIENT_UID)