Agent.object_method#

Agent.object_method(obj, method, *a, **kw)[source]#

Call DBus method of an object and handle reply as async events.

The event names are {iface}.{method}:reply and {iface}.{method}:error. expect() of the :reply event gives the return values as event.values; of the :error event, the exception as event.error.

Pass reply_handler or error_handler in **kw to get the reply called directly, as with an ordinary asynchronous dbus call. The events are queued either way.

Parameters:

  • obj (dbus.Interface) – interface whose method to call.

  • method (str) – method name.

  • *a – method arguments.

  • **kw – method keyword arguments, and the optional reply_handler and error_handler callbacks.

Example

obj = dbus.Interface(bus.get_object(BUS_NAME, "/"), "org.freedesktop.DBus.ObjectManager")
self.object_method(obj, "GetManagedObjects")
event = self.expect("org.freedesktop.DBus.ObjectManager.GetManagedObjects:reply")
objects = event.values[0]