Solid (Device)

#!/usr/bin/env python

# [SNIPPET_NAME: Solid (Device)]
# [SNIPPET_DESCRIPTION: Device integration framework for a device]
# [SNIPPET_AUTHOR: Jim Bublitz <[email protected]>]

from PyQt4.QtCore import SIGNAL, Qt
from PyQt4.QtGui import QTreeWidget, QTreeWidgetItem, QLabel

from PyKDE4.kdecore import i18n
from PyKDE4.solid import Solid
from PyKDE4.kdeui import KVBox

helpText = """The Solid class discovers information about the hardware on a machine.

Solid.Device is the base class for the various types of devices. It provides a list
of the types of devices on the machine. The table below shows the data for your

Individual device type classes can be interrogated to discover specific information
suitable to each device type.

class MainFrame(KVBox):
    def __init__(self, parent=None):
        KVBox.__init__(self, parent)  = QLabel (i18n (helpText), self)
        self.layout ().setAlignment (, Qt.AlignHCenter)
        self.setSpacing (10)
        display = QTreeWidget (self)        
        display.setHeaderLabels (["Product", "Vendor", "UDI"])
        display.setColumnWidth (0, 300)

        # retrieve a list of Solid.Device for this machine
        deviceList = Solid.Device.allDevices ()
        for device in deviceList:
            item = QTreeWidgetItem (display, [device.product (), device.vendor (), device.udi ()])


# This example can be run standalone

if __name__ == '__main__':

    import sys
    from PyKDE4.kdecore import KCmdLineArgs, KAboutData, KLocalizedString, ki18n
    from PyKDE4.kdeui import KApplication, KMainWindow
    class MainWin (KMainWindow):
        def __init__ (self, *args):
            KMainWindow.__init__ (self)

            self.resize(640, 480)
            self.setCentralWidget (MainFrame (self))
    #-------------------- main ------------------------------------------------
    appName     = "Solid_Devices"
    catalog     = ""
    programName = ki18n ("Solid_Devices")                 #ki18n required here
    version     = "1.0"
    description = ki18n ("Solid.Devices Example")         #ki18n required here
    license     = KAboutData.License_GPL
    copyright   = ki18n ("(c) 2007 Jim Bublitz")    #ki18n required here
    text        = ki18n ("none")                    #ki18n required here
    homePage    = ""
    bugEmail    = "[email protected]"

    aboutData   = KAboutData (appName, catalog, programName, version, description,
                              license, copyright, text, homePage, bugEmail)

    # ki18n required for first two addAuthor () arguments
    aboutData.addAuthor (ki18n ("Troy Melhase"), ki18n ("original concept"))
    aboutData.addAuthor (ki18n ("Jim Bublitz"), ki18n ("pykdedocs"))
    KCmdLineArgs.init (sys.argv, aboutData)
    app = KApplication ()
    mainWindow = MainWin (None, "main window")
    app.connect (app, SIGNAL ("lastWindowClosed ()"), app.quit)
    app.exec_ ()