Add an example of asynchronous calls. Run the examples during 'make check'.

1 files changed, 109 insertions, 0 deletions

diff --git a/examples/example-async-client.py b/examples/example-async-client.py
new file mode 100644
index 0000000..0c324e0
--- /dev/null
+++ b/examples/example-async-client.py
@@ -0,0 +1,109 @@
+#!/usr/bin/env python
+
+usage = """Usage:
+python example-service.py &
+python example-async-client.py
+python example-async-client.py --exit-service
+"""
+
+import sys
+import traceback
+
+import gobject
+
+import dbus
+import dbus.mainloop.glib
+
+# Callbacks for asynchronous calls
+
+def handle_hello_reply(r):
+    global hello_replied
+    hello_replied = True
+
+    print str(r)
+
+    if hello_replied and raise_replied:
+        loop.quit()
+
+def handle_hello_error(e):
+    global failed
+    global hello_replied
+    hello_replied = True
+    failed = True
+
+    print "HelloWorld raised an exception! That's not meant to happen..."
+    print "\t", str(e)
+
+    if hello_replied and raise_replied:
+        loop.quit()
+
+def handle_hello_error(e):
+    global failed
+    global hello_replied
+    hello_replied = True
+    failed = True
+
+    print "HelloWorld raised an exception! That's not meant to happen..."
+    print "\t", str(e)
+
+    if hello_replied and raise_replied:
+        loop.quit()
+
+def handle_raise_reply():
+    global failed
+    global raise_replied
+    raise_replied = True
+    failed = True
+
+    print "RaiseException returned normally! That's not meant to happen..."
+
+    if hello_replied and raise_replied:
+        loop.quit()
+
+def handle_raise_error(e):
+    global raise_replied
+    raise_replied = True
+
+    print "RaiseException raised an exception as expected:"
+    print "\t", str(e)
+
+    if hello_replied and raise_replied:
+        loop.quit()
+
+def make_calls():
+    # To make an async call, use the reply_handler and error_handler kwargs
+    remote_object.HelloWorld("Hello from example-async-client.py!",
+                             dbus_interface='com.example.SampleInterface',
+                             reply_handler=handle_hello_reply,
+                             error_handler=handle_hello_error)
+
+    # Interface objects also support async calls
+    iface = dbus.Interface(remote_object, 'com.example.SampleInterface')
+    
+    iface.RaiseException(reply_handler=handle_raise_reply,
+                         error_handler=handle_raise_error)
+
+    return False
+
+if __name__ == '__main__':
+    dbus.mainloop.glib.DBusGMainLoop(set_as_default=True)
+
+    bus = dbus.SessionBus()
+    try:
+        remote_object = bus.get_object("com.example.SampleService","/SomeObject")
+    except dbus.DBusException:
+        traceback.print_exc()
+        print usage
+        sys.exit(1)
+
+    # Make the method call after a short delay
+    gobject.timeout_add(1000, make_calls)
+
+    failed = False
+    hello_replied = False
+    raise_replied = False
+
+    loop = gobject.MainLoop()
+    loop.run()
+    if failed:
+        raise SystemExit("Example async client failed!")