README.rst

TxDBus

Tom Cocagne <[email protected]> v1.1.0, July 2017

Introduction

TxDBus is a native Python implementation of the DBus protocol for the Twisted networking framework.

In addition to a tutorial, and collection of examples the documentation for this project also includes An Overview of the DBus Protocol.

License: MIT

Usage Example

#!/usr/bin/env python

from twisted.internet import reactor, defer
from txdbus import error, client

@defer.inlineCallbacks
def show_desktop_notification():
    '''
    Displays "Hello World!" in a desktop notification window for 3 seconds
    '''
    con = yield client.connect(reactor, 'session')

    notifier = yield con.getRemoteObject('org.freedesktop.Notifications',
                                         '/org/freedesktop/Notifications')

    nid = yield notifier.callRemote('Notify',
                                    'Example Application',
                                    0,
                                    '',
                                    'Tx DBus Example',
                                    'Hello World!',
                                    [], dict(),
                                    3000)

    reactor.stop()

reactor.callWhenRunning(show_desktop_notification)
reactor.run()