Merge lp:~nixternal/python-snippets/pykde4 into lp:~jonobacon/python-snippets/trunk

[Rich Johnson]

Here are your PyKDE4 snippets, all SNIPPET_'d out, with doc links, and all!

=== added directory 'pykde4'
=== added file 'pykde4/kaboutapplicationdialog.py'
--- pykde4/kaboutapplicationdialog.py	1970-01-01 00:00:00 +0000
+++ pykde4/kaboutapplicationdialog.py	2010-03-24 06:55:25 +0000
@@ -0,0 +1,94 @@
+#!/usr/bin/env python
+
+# [SNIPPET_NAME: About Application Dialog]
+# [SNIPPET_CATEGORIES: PyKDE4]
+# [SNIPPET_DESCRIPTION: PyKDE4 example showing the About application dialog]
+# [SNIPPET_AUTHOR: Jim Bublitz <[e-mail]>]
+# [SNIPPET_LICENSE: GPL]
+# [SNIPPET_DOCS: http://api.kde.org/pykde-4.3-api/kdecore/KAboutData.html]
+
+from PyQt4.QtCore import SIGNAL, Qt
+from PyQt4.QtGui import QLabel, QSizePolicy
+
+from PyKDE4.kdecore import i18n, ki18n, KAboutData
+from PyKDE4.kdeui import KVBox, KHBox, KPushButton, KAboutApplicationDialog
+
+helpText = """The KAboutApplicationDialog is normally displayed from the
+applications Help menu.
+
+It requires a KAboutData object to provide the information displayed in
+the dialog. This is usually the same KAboutData object constructed when
+you start your program, although a different object could be used.
+
+Press the button below to display the dialog.
+"""
+
+dialogName = "KAboutApplicationDialog" 
+
+appName     = "kaboutapplicationdialog.py"
+catalog     = ""
+programName = ki18n ("kaboutapplicationdialog")                 #ki18n required here
+version     = "1.0"
+description = ki18n ("KAboutApplicationDialog Example")         #ki18n required here
+license     = KAboutData.License_GPL
+copyright   = ki18n ("(c) 2007 Jim Bublitz")    #ki18n required here
+text        = ki18n ("none")                    #ki18n required here
+homePage    = "www.riverbankcomputing.com"
+bugEmail    = "[e-mail]"
+
+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"))
+
+
+class MainFrame(KVBox):       
+    def __init__(self, parent):
+        KVBox.__init__(self, parent)
+        self.help = QLabel (helpText, self)
+        self.layout ().setAlignment (self.help, Qt.AlignHCenter)
+        
+        hBox = KHBox (self)
+        self.button = KPushButton(i18n("Show %s" % dialogName), hBox)
+        self.button.setMaximumSize (250, 30)
+        
+        self.connect(self.button, SIGNAL('clicked()'), self.showDialog)
+
+    def showDialog(self):
+        dlg = KAboutApplicationDialog (aboutData, self.parent ())
+        dlg.exec_ ()      
+
+
+
+# This example can be run standalone
+
+if __name__ == '__main__':
+
+    import sys
+
+    from PyQt4.QtCore import SIGNAL
+    
+    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 ------------------------------------------------
+    
+    
+    KCmdLineArgs.init (sys.argv, aboutData)
+    
+    app = KApplication ()
+    mainWindow = MainWin (None, "main window")
+    mainWindow.show()
+    app.connect (app, SIGNAL ("lastWindowClosed ()"), app.quit)
+    app.exec_ ()

=== added file 'pykde4/kaboutkdedialog.py'
--- pykde4/kaboutkdedialog.py	1970-01-01 00:00:00 +0000
+++ pykde4/kaboutkdedialog.py	2010-03-24 06:55:25 +0000
@@ -0,0 +1,85 @@
+#!/usr/bin/env python
+
+# [SNIPPET_NAME: About KDE Dialog]
+# [SNIPPET_CATEGORIES: PyKDE4]
+# [SNIPPET_DESCRIPTION: PyKDE4 example showing the About KDE dialog]
+# [SNIPPET_AUTHOR: Jim Bublitz <[e-mail]>]
+# [SNIPPET_LICENSE: GPL]
+# [SNIPPET_DOCS: http://api.kde.org/pykde-4.3-api/kdecore/KAboutData.html]
+
+from PyQt4.QtCore import SIGNAL, Qt
+from PyQt4.QtGui import QLabel
+
+from PyKDE4.kdecore import i18n
+from PyKDE4.kdeui import KVBox, KHBox, KPushButton, KAboutKdeDialog
+
+helpText = """The KAboutKdeDialog is the dialog that is normally
+available from the help menu.
+
+Press the button below to display the dialog.
+"""
+
+dialogName = "KAboutKdeDialog" 
+
+class MainFrame(KVBox):       
+    def __init__(self, parent):
+        KVBox.__init__(self, parent)
+        self.help = QLabel (helpText, self)
+        self.layout ().setAlignment (self.help, Qt.AlignHCenter)
+        
+        hBox = KHBox (self)
+        self.button = KPushButton(i18n("Show %s" % dialogName), hBox)
+        self.button.setMaximumSize (250, 30)
+        
+        self.connect(self.button, SIGNAL('clicked()'), self.showDialog)
+
+    def showDialog(self):
+        dlg = KAboutKdeDialog (self.parent ())
+        dlg.exec_ ()
+
+
+
+# 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     = "kaboutkdedialog.py"
+    catalog     = ""
+    programName = ki18n ("kaboutkdedialog")
+    version     = "1.0"
+    description = ki18n ("KAboutKdeDialog Example")
+    license     = KAboutData.License_GPL
+    copyright   = ki18n ("(c) 2007 Jim Bublitz")
+    text        = ki18n ("none")
+    homePage    = "www.riverbankcomputing.com"
+    bugEmail    = "[e-mail]"
+
+    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")
+    mainWindow.show()
+    app.connect (app, SIGNAL ("lastWindowClosed ()"), app.quit)
+    app.exec_ ()

=== added file 'pykde4/kapplication.py'
--- pykde4/kapplication.py	1970-01-01 00:00:00 +0000
+++ pykde4/kapplication.py	2010-03-24 06:55:25 +0000
@@ -0,0 +1,72 @@
+#!/usr/bin/env python
+
+# [SNIPPET_NAME: Main Window Application]
+# [SNIPPET_CATEGORIES: PyKDE4]
+# [SNIPPET_DESCRIPTION: PyKDE4 example showing KMainWindow and KApplication]
+# [SNIPPET_AUTHOR: Jim Bublitz <[e-mail]>]
+# [SNIPPET_LICENSE: GPL]
+# [SNIPPET_DOCS: http://api.kde.org/pykde-4.3-api/kdeui/KApplication.html, http://api.kde.org/pykde-4.3-api/kdeui/KMainWindow.html]
+
+import sys
+
+from PyKDE4.kdecore import ki18n, KAboutData, KCmdLineArgs
+from PyKDE4.kdeui import KApplication, KMainWindow
+
+from PyQt4.QtGui import QLabel
+
+runner = True
+        
+helpText = """This short program is the basic KDE application.
+
+It uses KAboutData to initialize some basic program information
+that is used by KDE (beyond simply setting up the About dialog
+box in a more complex program).
+
+It creates a KMainWindow, so the program has a place to display
+its output and interact with users.
+
+It also creates a KApplication object, which is necessary for
+the use of most KDE widgets and other classes, and makes
+available access to standard information about things like
+icons, directory locations, colors, fonts and similar data.
+
+Lastly, it starts an event loop (app.exec_) to allow a user
+to interact with the program.
+
+Click the button to launch the application.
+"""        
+
+
+
+class MainWindow (KMainWindow):
+    def __init__ (self):
+        KMainWindow.__init__ (self)
+
+        self.resize (640, 480)
+        label = QLabel ("This is a simple PyKDE4 program", self)
+        label.setGeometry (10, 10, 200, 20)
+
+#--------------- main ------------------
+if __name__ == '__main__':
+
+    appName     = "KApplication"
+    catalog     = ""
+    programName = ki18n ("KApplication")
+    version     = "1.0"
+    description = ki18n ("KApplication/KMainWindow/KAboutData example")
+    license     = KAboutData.License_GPL
+    copyright   = ki18n ("(c) 2007 Jim Bublitz")
+    text        = ki18n ("none")
+    homePage    = "www.riverbankcomputing.com"
+    bugEmail    = "[e-mail]"
+    
+    aboutData   = KAboutData (appName, catalog, programName, version, description,
+                                license, copyright, text, homePage, bugEmail)
+    
+        
+    KCmdLineArgs.init (sys.argv, aboutData)
+        
+    app = KApplication ()
+    mainWindow = MainWindow ()
+    mainWindow.show ()
+    app.exec_ ()

=== added file 'pykde4/katepart.py'
--- pykde4/katepart.py	1970-01-01 00:00:00 +0000
+++ pykde4/katepart.py	2010-03-24 06:55:25 +0000
@@ -0,0 +1,50 @@
+#!/usr/bin/env python
+
+# [SNIPPET_NAME: KPart (Kate)]
+# [SNIPPET_CATEGORIES: PyKDE4]
+# [SNIPPET_DESCRIPTION: KPart example using the Kate part]
+# [SNIPPET_AUTHOR: Jonathan Riddell <[e-mail]>]
+# [SNIPPET_LICENSE: GPL]
+# [SNIPPET_DOCS: http://api.kde.org/pykde-4.3-api/kdecore/KLibLoader.html, http://api.kde.org/pykde-4.3-api/kparts/index.html]
+
+import sys
+
+from PyKDE4.kdecore import *
+from PyKDE4.kdeui import *
+from PyKDE4.kparts import *
+
+from PyQt4.QtGui import QLabel
+
+class MainWindow (KMainWindow):
+    def __init__ (self):
+        KMainWindow.__init__(self)
+
+        self.resize(640, 480)
+
+        factory = KLibLoader.self().factory("katepart")
+        part = factory.create(self, "KatePart")
+        self.setCentralWidget(part.widget())
+
+#--------------- main ------------------
+if __name__ == '__main__':
+
+    appName     = "katepart_example"
+    catalog     = ""
+    programName = ki18n("Kate Part Example")
+    version     = "1.0"
+    description = ki18n("Example loading a Kate Part")
+    license     = KAboutData.License_GPL
+    copyright   = ki18n("(c) 2009 Canonical Ltd")
+    text        = ki18n("none")
+    homePage    = "www.kubuntu.org"
+    bugEmail    = "[e-mail]"
+    
+    aboutData   = KAboutData(appName, catalog, programName, version, description,
+                                license, copyright, text, homePage, bugEmail)
+            
+    KCmdLineArgs.init(sys.argv, aboutData)
+        
+    app = KApplication()
+    mainWindow = MainWindow()
+    mainWindow.show()
+    app.exec_()

=== added file 'pykde4/kcolorbutton.py'
--- pykde4/kcolorbutton.py	1970-01-01 00:00:00 +0000
+++ pykde4/kcolorbutton.py	2010-03-24 06:55:25 +0000
@@ -0,0 +1,130 @@
+#!/usr/bin/env python
+
+# [SNIPPET_NAME: Pushbutton (Color Selection)]
+# [SNIPPET_CATEGORIES: PyKDE4]
+# [SNIPPET_DESCRIPTION: A pushbutton to display or allow user selection of a color]
+# [SNIPPET_AUTHOR: Jim Bublitz <[e-mail]>]
+# [SNIPPET_LICENSE: GPL]
+# [SNIPPET_DOCS: http://api.kde.org/pykde-4.3-api/kdeui/KColorButton.html]
+
+from PyQt4.QtCore import SIGNAL, Qt
+from PyQt4.QtGui import QLabel
+
+from PyKDE4.kdecore import i18n
+from PyKDE4.kdeui import KVBox, KHBox, KColorButton, KColorCells, KColorCombo, KColorPatch
+
+helpText = """These are examples of three ways of changing colors interactively,
+and one widget that displays a chosen color.
+
+When KColorButton is clicked, it pops up a color selection dialog.
+
+KColorCells offers one way to present a pre-selected range of color
+choices, and may have more rows and columns than displayed here.
+Click on a cell to select a color.
+
+KColorCombo provides a programmable drop down list of colors to select
+from.
+
+Finally, KColorPatch will display a specified color. In this example, using
+any of the other three widgets to select a color will change the color of
+the KColorPatch.
+"""
+
+class MainFrame(KVBox):
+    def __init__(self, parent=None):
+        KVBox.__init__(self, parent)
+        self.help  = QLabel (helpText, self)
+        self.layout ().setAlignment (self.help, Qt.AlignHCenter)
+        
+        hBox1 = KHBox (self)
+        hBox1.setSpacing (10)
+        hBox1.setMargin (40)
+
+        
+        colorButtonLabel = QLabel ("KColorButton", hBox1)
+        colorButton = KColorButton (hBox1)
+
+        colorCellsLabel = QLabel ("KColorCells", hBox1)
+        colorCells = KColorCells (hBox1, 1, 8)
+        colorCells.setMaximumSize (160, 20)
+        colorCells.setColor (0, Qt.black)
+        colorCells.setColor (1, Qt.red)
+        colorCells.setColor (2, Qt.yellow)
+        colorCells.setColor (3, Qt.blue)
+        colorCells.setColor (4, Qt.darkGreen)
+        colorCells.setColor (5, Qt.magenta)
+        colorCells.setColor (6, Qt.gray)
+        colorCells.setColor (7, Qt.white)
+        
+        
+        colorComboLabel = QLabel ("KColorCombo", hBox1)
+        colorCombo = KColorCombo (hBox1)
+
+        colorList = [Qt.black, Qt.red, Qt.yellow, Qt.blue, Qt.darkGreen, Qt.magenta, Qt.gray, Qt.white]
+        colorCombo.setColors (colorList)
+        colorCombo.setMaximumWidth (80)
+        
+        hBox2 = KHBox (self)
+        hBox2.setSpacing (10)
+        self.layout ().setAlignment (hBox2, Qt.AlignHCenter | Qt.AlignTop)
+        self.setStretchFactor (hBox2, 1)
+        
+        colorPatchLabel = QLabel ("KColorPatch", hBox2)
+        hBox2.layout ().setAlignment (colorPatchLabel, Qt.AlignHCenter)
+        self.colorPatch = KColorPatch (hBox2)
+        self.colorPatch.setFixedSize (40, 40)
+        hBox2.layout ().setAlignment (self.colorPatch, Qt.AlignHCenter)
+
+        self.colorPatch.setColor (Qt.red)
+        self.colorPatch.show ()
+
+        self.connect (colorButton, SIGNAL ("changed (const QColor&)"), self.colorPatch.setColor)
+        self.connect (colorCells, SIGNAL ("colorSelected (int, const QColor&)"), self.colorCellSelected)
+        self.connect (colorCombo, SIGNAL ("activated (const QColor&)"), self.colorPatch.setColor)
+        
+    def colorCellSelected (self, int, color):
+        self.colorPatch.setColor (color)
+
+# 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     = "default"
+    catalog     = ""
+    programName = ki18n ("default")                 #ki18n required here
+    version     = "1.0"
+    description = ki18n ("Default Example")         #ki18n required here
+    license     = KAboutData.License_GPL
+    copyright   = ki18n ("(c) 2007 Jim Bublitz")    #ki18n required here
+    text        = ki18n ("none")                    #ki18n required here
+    homePage    = "www.riverbankcomputing.com"
+    bugEmail    = "[e-mail]"
+
+    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")
+    mainWindow.show()
+    app.connect (app, SIGNAL ("lastWindowClosed ()"), app.quit)
+    app.exec_ ()

=== added file 'pykde4/kcolordialog.py'
--- pykde4/kcolordialog.py	1970-01-01 00:00:00 +0000
+++ pykde4/kcolordialog.py	2010-03-24 06:55:25 +0000
@@ -0,0 +1,93 @@
+#!/usr/bin/env python
+
+# [SNIPPET_NAME: Dialog (Color Selection)]
+# [SNIPPET_CATEGORIES: PyKDE4]
+# [SNIPPET_DESCRIPTION: A color selection dialog]
+# [SNIPPET_AUTHOR: Jim Bublitz <[e-mail]>]
+# [SNIPPET_LICENSE: GPL]
+# [SNIPPET_DOCS: http://api.kde.org/pykde-4.3-api/kdeui/KColorDialog.html]
+
+from PyQt4.QtCore import SIGNAL, Qt
+from PyQt4.QtGui import QLabel
+from PyQt4.QtGui import QColor
+
+from PyKDE4.kdecore import i18n
+from PyKDE4.kdeui import KVBox, KHBox, KPushButton, KColorDialog, KColorPatch
+
+helpText = """This example uses KColorDialog.getColor (color, parent) to
+popup a dialog that allows the user to set the color of the KColorPatch
+next to the button.
+
+Click the button to run the dialog and select a color.
+"""
+
+dialogName = "KColorDialog" 
+
+class MainFrame(KVBox):       
+    def __init__(self, parent):
+        KVBox.__init__(self, parent)
+        self.help = QLabel (helpText, self)
+        self.layout ().setAlignment (self.help, Qt.AlignHCenter)
+        
+        hBox = KHBox (self)
+        self.button = KPushButton(i18n("Show %s" % dialogName), hBox)
+        self.button.setMaximumSize (250, 30)
+        
+        self.connect(self.button, SIGNAL('clicked()'), self.showDialog)
+
+        self.colorPatch = KColorPatch (hBox)
+        self.colorPatch.setColor (Qt.red)
+        self.colorPatch.setMaximumSize (40, 40)
+
+
+    def showDialog(self):
+        color = QColor ()
+        result = KColorDialog.getColor (color, self)
+        self.colorPatch.setColor (color)
+
+
+
+# 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     = "default.py"
+    catalog     = ""
+    programName = ki18n ("default")                 #ki18n required here
+    version     = "1.0"
+    description = ki18n ("Default Example")         #ki18n required here
+    license     = KAboutData.License_GPL
+    copyright   = ki18n ("(c) 2007 Jim Bublitz")    #ki18n required here
+    text        = ki18n ("none")                    #ki18n required here
+    homePage    = "www.riverbankcomputing.com"
+    bugEmail    = "[e-mail]"
+
+    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")
+    mainWindow.show()
+    app.connect (app, SIGNAL ("lastWindowClosed ()"), app.quit)
+    app.exec_ ()

=== added file 'pykde4/kcombobox.py'
--- pykde4/kcombobox.py	1970-01-01 00:00:00 +0000
+++ pykde4/kcombobox.py	2010-03-24 06:55:25 +0000
@@ -0,0 +1,119 @@
+#!/usr/bin/env python
+
+# [SNIPPET_NAME: Combo Box]
+# [SNIPPET_CATEGORIES: PyKDE4]
+# [SNIPPET_DESCRIPTION: An enhanced combo box which is a combined button, line-edit and popup list widget]
+# [SNIPPET_AUTHOR: Jim Bublitz <[e-mail]>]
+# [SNIPPET_LICENSE: GPL]
+# [SNIPPET_DOCS: http://api.kde.org/pykde-4.3-api/kdeui/KComboBox.html]
+
+from PyQt4.QtCore import SIGNAL, Qt
+from PyQt4.QtGui import QLabel
+
+from PyKDE4.kdecore import i18n, KStandardDirs
+from PyKDE4.kdeui import KVBox, KHBox, KComboBox, KListWidget
+
+helpText = """
+KListWidget and KComboBox are useful for displaying or
+interacting with lists of items. In this case, we
+display the KStandardDirs file types and directory
+locations.
+
+KComboBox is filled from the QStringList that the
+method "allTypes()" returns. It can also be filled
+with a single item at a time, and we can sort or
+add/remove items later. KDE has specialized KComboBox
+subclasses for other purposes. It inherits methods
+from QComboBox
+
+KListWidget also displays lists of information, but all
+are visible at the same time. It inherits classes
+from QListWidget and QListView.
+"""
+
+class MainFrame(KVBox):
+    def __init__(self, parent=None):
+        KVBox.__init__(self, parent)
+        self.help  = QLabel (i18n (helpText), self)
+        self.layout ().setAlignment (self.help, Qt.AlignHCenter)
+        self.setSpacing (10)
+        
+        hBox          = KHBox (self)
+        self.layout ().setAlignment (hBox, Qt.AlignHCenter)
+        
+        cBox          = KVBox (hBox)
+        hBox.layout ().setAlignment (cBox, Qt.AlignTop)
+        hBox.setSpacing (25)
+        hBox.setMargin (10)
+
+        self.stdDirs  = KStandardDirs ()
+        types         = self.stdDirs.allTypes ()
+        
+        comboLbl      = QLabel ("Types", cBox)
+        combo         = KComboBox (cBox)        
+        combo.addItems (types)
+        cBox.layout ().setAlignment (comboLbl, Qt.AlignTop)
+        cBox.layout ().setAlignment (combo, Qt.AlignTop)
+        
+        self.connect (combo, SIGNAL ("currentIndexChanged (const QString&)"), self.slotIndexChanged)
+
+        lBox          = KVBox (hBox)
+        listLbl       = QLabel ("Directories", lBox)
+        self.location = KListWidget (lBox)
+        self.location.setMaximumSize (400, 200)
+        lBox.layout ().setAlignment (listLbl, Qt.AlignTop)
+        lBox.layout ().setAlignment (self.location, Qt.AlignTop)
+
+        self.slotIndexChanged (combo.currentText ())
+
+
+    def slotIndexChanged (self, s):
+        self.location.clear ()
+        self.location.insertItems (0, self.stdDirs.resourceDirs (str (s)))
+
+        
+
+
+# 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     = "default"
+    catalog     = ""
+    programName = ki18n ("default")                 #ki18n required here
+    version     = "1.0"
+    description = ki18n ("Default Example")         #ki18n required here
+    license     = KAboutData.License_GPL
+    copyright   = ki18n ("(c) 2007 Jim Bublitz")    #ki18n required here
+    text        = ki18n ("none")                    #ki18n required here
+    homePage    = "www.riverbankcomputing.com"
+    bugEmail    = "[e-mail]"
+
+    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")
+    mainWindow.show()
+    app.connect (app, SIGNAL ("lastWindowClosed ()"), app.quit)
+    app.exec_ ()

=== added file 'pykde4/kdatepicker.py'
--- pykde4/kdatepicker.py	1970-01-01 00:00:00 +0000
+++ pykde4/kdatepicker.py	2010-03-24 06:55:25 +0000
@@ -0,0 +1,98 @@
+#!/usr/bin/env python
+
+# [SNIPPET_NAME: Date Selection Widget]
+# [SNIPPET_CATEGORIES: PyKDE4]
+# [SNIPPET_DESCRIPTION: Provides a widget for calendar date input]
+# [SNIPPET_AUTHOR: Troy Melhase]
+# [SNIPPET_LICENSE: GPL]
+# [SNIPPET_DOCS: http://api.kde.org/pykde-4.3-api/kdeui/KDatePicker.html]
+
+from PyQt4.QtCore import SIGNAL, Qt
+from PyQt4.QtGui import QLabel
+
+from PyKDE4.kdecore import i18n
+from PyKDE4.kdeui import KVBox, KHBox, KDatePicker, KDateWidget
+
+
+helpText = """Date selection widgets - KDatePicker and KDateWidget - provide widgets for calendar
+date input.
+
+KDatePicker emits two types of signals, either dateSelected() or dateEntered().
+
+A line edit allows the user to select a date directly by entering numbers like
[phone] or 990101 into KDatePicker."""
+
+class MainFrame(KVBox):
+    def __init__(self, parent=None):
+        KVBox.__init__(self, parent)
+        self.help = QLabel (i18n (helpText), self)
+        self.layout ().setAlignment (self.help, Qt.AlignHCenter | Qt.AlignTop)
+        self.setSpacing (40)
+
+        hBox  = KHBox (self)
+        vBox1 = KVBox (hBox)
+        vBox2 = KVBox (hBox)
+
+        hBox.layout ().setAlignment (vBox1, Qt.AlignHCenter)
+        hBox.layout ().setAlignment (vBox2, Qt.AlignHCenter)
+        vBox1.setMargin (20)
+        vBox2.setSpacing (20)
+        
+        self.datePickerLabel = QLabel ("KDatePicker", vBox1)
+
+        self.datePicker = KDatePicker(vBox2)
+        self.datePicker.setFixedSize (400, 200)
+
+        self.other = QLabel('KDateWidget', vBox1)
+        vBox1.layout ().setAlignment (self.other, Qt.AlignBottom)
+        
+        self.dateDisplay = KDateWidget(vBox2)
+
+        
+        self.connect(self.datePicker, SIGNAL('dateChanged(QDate)'),
+                     self.dateDisplay.setDate)
+
+
+# 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, 500)
+            self.setCentralWidget (MainFrame (self))
+    
+    #-------------------- main ------------------------------------------------
+    
+    appName     = "kdatepicker"
+    catalog     = ""
+    programName = ki18n ("kdatepicker")
+    version     = "1.0"
+    description = ki18n ("KDatePicker Example")
+    license     = KAboutData.License_GPL
+    copyright   = ki18n ("(c) 2006 Troy Melhase")
+    text        = ki18n ("none")
+    homePage    = "www.riverbankcomputing.com"
+    bugEmail    = "[e-mail]"
+
+    aboutData   = KAboutData (appName, catalog, programName, version, description,
+                              license, copyright, text, homePage, bugEmail)
+
+    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")
+    mainWindow.show()
+    app.connect (app, SIGNAL ("lastWindowClosed ()"), app.quit)
+    app.exec_ ()

=== added file 'pykde4/kfontdialog.py'
--- pykde4/kfontdialog.py	1970-01-01 00:00:00 +0000
+++ pykde4/kfontdialog.py	2010-03-24 06:55:25 +0000
@@ -0,0 +1,96 @@
+#!/usr/bin/env python
+
+# [SNIPPET_NAME: Dialog (Font Selection)]
+# [SNIPPET_CATEGORIES: PyKDE4]
+# [SNIPPET_DESCRIPTION: A dialog that provides interactive font selection]
+# [SNIPPET_AUTHOR: Jim Bublitz <[e-mail]>]
+# [SNIPPET_LICENSE: GPL]
+# [SNIPPET_DOCS: http://api.kde.org/pykde-4.3-api/kdeui/KFontDialog.html]
+
+from PyQt4.QtCore import SIGNAL, Qt
+from PyQt4.QtGui import QLabel, QDialog, QFont
+
+from PyKDE4.kdecore import i18n
+from PyKDE4.kdeui import KVBox, KHBox, KPushButton, KFontDialog
+
+helpText = """A KFontDialog allows the user to select a new font.
+
+Click the button to change the font of the displayed text.
+"""
+
+quote = """Now is the winter of our discontent
+made summer by this glorious sun of York.
+"""
+
+dialogName = "KFontDialog" 
+
+class MainFrame(KVBox):       
+    def __init__(self, parent):
+        KVBox.__init__(self, parent)
+        self.setSpacing (40)
+        self.help = QLabel (i18n (helpText), self)
+        self.layout ().setAlignment (self.help, Qt.AlignHCenter)
+
+        self.button = KPushButton(i18n("Show %s" % dialogName), self)
+        self.button.setFixedSize (200, 30)
+        self.layout ().setAlignment (self.button, Qt.AlignHCenter)
+        self.fontLabel = QLabel (quote, self)
+        self.layout ().setAlignment (self.fontLabel, Qt.AlignHCenter)
+        
+        self.connect(self.button, SIGNAL('clicked()'), self.showDialog)
+
+    def showDialog(self):
+        font = QFont ()
+        result, checkState = KFontDialog.getFont (font)
+        if result == QDialog.Accepted:
+            self.fontLabel.setFont (font)
+
+
+
+# This example can be run standalone
+
+if __name__ == '__main__':
+
+    import sys
+
+    from PyQt4.QtCore import Qt
+    from PyQt4.QtGui import QFrame, QVBoxLayout
+    
+    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     = "default.py"
+    catalog     = ""
+    programName = ki18n ("default")                 #ki18n required here
+    version     = "1.0"
+    description = ki18n ("Default Example")         #ki18n required here
+    license     = KAboutData.License_GPL
+    copyright   = ki18n ("(c) 2007 Jim Bublitz")    #ki18n required here
+    text        = ki18n ("none")                    #ki18n required here
+    homePage    = "www.riverbankcomputing.com"
+    bugEmail    = "[e-mail]"
+
+    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")
+    mainWindow.show()
+    app.connect (app, SIGNAL ("lastWindowClosed ()"), app.quit)
+    app.exec_ ()

=== added file 'pykde4/kstandarddirs.py'
--- pykde4/kstandarddirs.py	1970-01-01 00:00:00 +0000
+++ pykde4/kstandarddirs.py	2010-03-24 06:55:25 +0000
@@ -0,0 +1,113 @@
+#!/usr/bin/env python
+
+# [SNIPPET_NAME: KDE Standard Directories]
+# [SNIPPET_CATEGORIES: PyKDE4]
+# [SNIPPET_DESCRIPTION: Site-independent access to standard KDE directories]
+# [SNIPPET_AUTHOR: Jim Bublitz <[e-mail]>]
+# [SNIPPET_LICENSE: GPL]
+# [SNIPPET_DOCS: http://api.kde.org/pykde-4.3-api/kdecore/KStandardDirs.html]
+
+from PyQt4.QtCore import SIGNAL, Qt
+from PyQt4.QtGui import QLabel
+
+from PyKDE4.kdecore import i18n, KStandardDirs
+from PyKDE4.kdeui import KVBox, KHBox, KComboBox, KListWidget
+
+helpText = """KStandardDirs provides methods for locating KDE objects
+ within the filesystem - for example, icons, configuration
+ files, etc.
+
+ KStandardDirs recognizes a number of data types (shown in the
+ combo box at left) and associates the types with directories.
+
+ You can use this information to locate a resource, or to
+ determine where to install a resource for you program.
+"""
+
+class MainFrame(KVBox):
+    def __init__(self, parent=None):
+        KVBox.__init__(self, parent)
+        self.help  = QLabel (i18n (helpText), self)
+        self.layout ().setAlignment (self.help, Qt.AlignHCenter)
+        self.setSpacing (10)
+        
+        hBox          = KHBox (self)
+        self.layout ().setAlignment (hBox, Qt.AlignHCenter)
+        
+        cBox          = KVBox (hBox)
+        hBox.layout ().setAlignment (cBox, Qt.AlignTop)
+        hBox.setSpacing (25)
+        hBox.setMargin (10)
+
+        self.stdDirs  = KStandardDirs ()
+        types         = self.stdDirs.allTypes ()
+        
+        comboLbl      = QLabel ("Types", cBox)
+        combo         = KComboBox (cBox)        
+        combo.addItems (types)
+        cBox.layout ().setAlignment (comboLbl, Qt.AlignTop)
+        cBox.layout ().setAlignment (combo, Qt.AlignTop)
+        
+        self.connect (combo, SIGNAL ("currentIndexChanged (const QString&)"), self.slotIndexChanged)
+
+        lBox          = KVBox (hBox)
+        listLbl       = QLabel ("Directories", lBox)
+        self.location = KListWidget (lBox)
+        self.location.setMaximumSize (400, 200)
+        lBox.layout ().setAlignment (listLbl, Qt.AlignTop)
+        lBox.layout ().setAlignment (self.location, Qt.AlignTop)
+
+        QLabel (self.stdDirs.installPath ("ui"), self)
+
+        self.slotIndexChanged (combo.currentText ())
+
+    def slotIndexChanged (self, s):
+        self.location.clear ()
+        self.location.insertItems (0, self.stdDirs.resourceDirs (str (s)))
+
+        
+
+
+# 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     = "default"
+    catalog     = ""
+    programName = ki18n ("default")                 #ki18n required here
+    version     = "1.0"
+    description = ki18n ("Default Example")         #ki18n required here
+    license     = KAboutData.License_GPL
+    copyright   = ki18n ("(c) 2007 Jim Bublitz")    #ki18n required here
+    text        = ki18n ("none")                    #ki18n required here
+    homePage    = "www.riverbankcomputing.com"
+    bugEmail    = "[e-mail]"
+
+    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")
+    mainWindow.show()
+    app.connect (app, SIGNAL ("lastWindowClosed ()"), app.quit)
+    app.exec_ ()

=== added file 'pykde4/solid_audiointerface.py'
--- pykde4/solid_audiointerface.py	1970-01-01 00:00:00 +0000
+++ pykde4/solid_audiointerface.py	2010-03-24 06:55:25 +0000
@@ -0,0 +1,136 @@
+#!/usr/bin/env python
+
+# [SNIPPET_NAME: Solid (Audio Interface)]
+# [SNIPPET_CATEGORIES: PyKDE4]
+# [SNIPPET_DESCRIPTION: Device integration framework for an audio interface]
+# [SNIPPET_AUTHOR: Jim Bublitz <[e-mail]>]
+# [SNIPPET_LICENSE: GPL]
+# [SNIPPET_DOCS: http://api.kde.org/pykde-4.3-api/solid/index.html, http://api.kde.org/pykde-4.3-api/solid/Solid.AudioInterface.html]
+
+from PyQt4.QtCore import Qt
+from PyQt4.QtGui import QSizePolicy, QTreeWidget, QTreeWidgetItem, QLabel
+
+from PyKDE4.kdecore import i18n
+from PyKDE4.solid import Solid, Solid
+from PyKDE4.kdeui import KVBox, KHBox, KTextEdit
+
+helpText = """The Solid class discovers information about the hardware on a machine.
+
+Solid.AudioInterface objects retrieve information about the sound system
+on a machine.
+
+We use Solid.Device.allDevices () to get a list of all devices, and then
+filter it for Solid.AudioInterface types.
+"""
+
+class MainFrame(KVBox):
+    def __init__(self, parent=None):
+        KVBox.__init__(self, parent)
+        self.help  = QLabel (i18n (helpText), self)
+        self.layout ().setAlignment (self.help, Qt.AlignHCenter)
+        self.setSpacing (10)
+
+        audioDriverStr = {
+                            Solid.AudioInterface.Alsa: "Alsa",\
+                            Solid.AudioInterface.OpenSoundSystem: "Open Sound",\
+                            Solid.AudioInterface.UnknownAudioDriver: "Unknown"
+                         }
+
+
+        audioInterfaceTypeStr = {
+                                  Solid.AudioInterface.UnknownAudioInterfaceType: "Unknown",\
+                                  Solid.AudioInterface.AudioControl: "Control",\
+                                  Solid.AudioInterface.AudioInput: "In",\
+                                  Solid.AudioInterface.AudioOutput: "Out"
+                                }
+
+        soundcardTypeStr = {
+                             Solid.AudioInterface.InternalSoundcard: "Internal",\
+                             Solid.AudioInterface.UsbSoundcard: "USB",\
+                             Solid.AudioInterface.FirewireSoundcard: "Firewire",\
+                             Solid.AudioInterface.Headset: "Headset",\
+                             Solid.AudioInterface.Modem: "Modem"
+                           }
+        
+        hBox = KHBox (self)
+                
+        display = QTreeWidget (hBox)
+        display.setSizePolicy (QSizePolicy.Expanding, QSizePolicy.Expanding)
+        display.setHeaderLabels (["Item", "Name", "Driver", "I/F Type", "Sound Card Type"])
+        display.setColumnWidth (0, 300)
+        display.setColumnWidth (1, 300)
+        display.setColumnWidth (3, 75)
+
+        # retrieve a list of Solid.Device for this machine
+        deviceList = Solid.Device.allDevices ()
+
+        
+        # filter the list of all devices and display matching results
+        # note that we never create a Solid.AudioInterface object, but
+        # receive one from the 'asDeviceInterface' call
+        for device in deviceList:
+            if device.isDeviceInterface (Solid.DeviceInterface.AudioInterface):
+                audio = device.asDeviceInterface (Solid.DeviceInterface.AudioInterface)
+                devtype = audio.deviceType ()
+                devstr  = []
+                for key in audioInterfaceTypeStr:
+                    flag = key & devtype
+                    if flag:
+                        devstr.append (audioInterfaceTypeStr [key])
+                        
+                QTreeWidgetItem (display, [device.product (),
+                                           audio.name (),
+                                           audioDriverStr [audio.driver ()],
+                                           "/".join (devstr),
+                                           soundcardTypeStr [audio.soundcardType ()]])
+
+        
+        
+
+# This example can be run standalone
+
+if __name__ == '__main__':
+
+    import sys
+
+    from PyQt4.QtCore import SIGNAL
+    
+    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_StorageDrive"
+    catalog     = ""
+    programName = ki18n ("Solid_StorageDrive")                 #ki18n required here
+    version     = "1.0"
+    description = ki18n ("Solid.StorageDrive Example")         #ki18n required here
+    license     = KAboutData.License_GPL
+    copyright   = ki18n ("(c) 2007 Jim Bublitz")    #ki18n required here
+    text        = ki18n ("none")                    #ki18n required here
+    homePage    = "www.riverbankcomputing.com"
+    bugEmail    = "[e-mail]"
+
+    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")
+    mainWindow.show()
+    app.connect (app, SIGNAL ("lastWindowClosed ()"), app.quit)
+    app.exec_ ()

=== added file 'pykde4/solid_demo.py'
--- pykde4/solid_demo.py	1970-01-01 00:00:00 +0000
+++ pykde4/solid_demo.py	2010-03-24 06:55:25 +0000
@@ -0,0 +1,101 @@
+#!/usr/bin/env python
+
+# [SNIPPET_NAME: Solid Demo]
+# [SNIPPET_CATEGORIES: PyKDE4]
+# [SNIPPET_DESCRIPTION: Demos some of the features of Solid]
+# [SNIPPET_AUTHOR: Simon Edwards <[e-mail]>]
+# [SNIPPET_LICENSE: GPL3]
+# [SNIPPET_DOCS: http://api.kde.org/pykde-4.3-api/solid/index.html]
+
+###########################################################################
+# solid_demo.py - Demonstrates use of Solid.
+#
+###########################################################################
+# Copyright (C) 2007 Simon Edwards <[e-mail]>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License or (at
+# your option) version 3 or, at the discretion of KDE e.V. (which shall
+# act as a proxy as in section 14 of the GPLv3), any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+
+from PyKDE4.kdecore import *
+from PyKDE4.solid import *
+
+def main():
+    componentData = KComponentData("solid_demo")
+
+    print("All devices found by Solid")
+    print("--------------------------")
+    for device in Solid.Device.allDevices():
+        print(device.udi())
+    print("")
+    
+    print("All audio devices found by Solid")
+    print("--------------------------------")
+    for device in Solid.Device.listFromType(Solid.DeviceInterface.AudioInterface, ""):
+        print(device.udi())
+    print("")
+
+    print("Processor found by Solid")
+    print("------------------------")
+    
+    # Get a Processor
+    device_list = Solid.Device.listFromType(Solid.DeviceInterface.Processor, "")
+
+    # take the first processor
+    device = device_list[0]
+    if device.isDeviceInterface(Solid.DeviceInterface.Processor):
+        print("We've got a processor! %i to be exact..." % len(device_list))
+    else:
+        print("Device is not a processor.")
+
+    processor = device.asDeviceInterface(Solid.DeviceInterface.Processor)
+    print("This processors maximum speed is: " + str(processor.maxSpeed()))
+
+    extensions = processor.instructionSets()
+    print("Intel MMX supported: " + ("yes" if extensions & Solid.Processor.IntelMmx else "no"))
+    print("Intel SSE supported: " + ("yes" if extensions & Solid.Processor.IntelSse else "no"))
+    print("Intel SSE2 supported: " + ("yes" if extensions & Solid.Processor.IntelSse2 else "no"))
+    print("Intel SSE3 supported: " + ("yes" if extensions & Solid.Processor.IntelSse3 else "no"))
+    print("Intel SSE4 supported: " + ("yes" if extensions & Solid.Processor.IntelSse4 else "no"))
+    print("AMD 3DNOW supported: " + ("yes" if extensions & Solid.Processor.Amd3DNow else "no"))
+    print("PPC AltiVec supported: " + ("yes" if extensions & Solid.Processor.AltiVec else "no"))
+    print("")
+    
+    print("Checking network status")
+    print("-----------------------")
+    
+    if Solid.Networking.status() == Solid.Networking.Connected:
+        print("Networking is enabled.  Feel free to go online!")
+    else:
+        print("Network not available.")
+    print("")
+    
+    # get a Network Device
+    netlist = Solid.Device.listFromType(Solid.DeviceInterface.NetworkInterface, "")
+    
+    # check to see if no network devices were found
+    if len(netlist)==0:
+        print("No network devices found!")
+    else:
+        print("Found %s network device(s)" % len(netlist))
+        for device in netlist:
+            netdev = device.asDeviceInterface(Solid.DeviceInterface.NetworkInterface)
+            
+            # keep the program from crashing in the event that there's a bug in solid
+            if netdev is None:
+                print("Device could not be converted.  There is a bug.")
+            else:
+                print("The iface of %s is %s" % (str(device.udi()),str(netdev.ifaceName())))
+    
+main()

=== added file 'pykde4/solid_device.py'
--- pykde4/solid_device.py	1970-01-01 00:00:00 +0000
+++ pykde4/solid_device.py	2010-03-24 06:55:25 +0000
@@ -0,0 +1,91 @@
+#!/usr/bin/env python
+
+# [SNIPPET_NAME: Solid (Device)]
+# [SNIPPET_CATEGORIES: PyKDE4]
+# [SNIPPET_DESCRIPTION: Device integration framework for a device]
+# [SNIPPET_AUTHOR: Jim Bublitz <[e-mail]>]
+# [SNIPPET_LICENSE: GPL]
+# [SNIPPET_DOCS: http://api.kde.org/pykde-4.3-api/solid/index.html, http://api.kde.org/pykde-4.3-api/solid/Solid.Device.html]
+
+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
+machine.
+
+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)
+        self.help  = QLabel (i18n (helpText), self)
+        self.layout ().setAlignment (self.help, 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    = "www.riverbankcomputing.com"
+    bugEmail    = "[e-mail]"
+
+    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")
+    mainWindow.show()
+    app.connect (app, SIGNAL ("lastWindowClosed ()"), app.quit)
+    app.exec_ ()

=== added file 'pykde4/solid_networkinterface.py'
--- pykde4/solid_networkinterface.py	1970-01-01 00:00:00 +0000
+++ pykde4/solid_networkinterface.py	2010-03-24 06:55:25 +0000
@@ -0,0 +1,118 @@
+#!/usr/bin/env python
+
+# [SNIPPET_NAME: Solid (Network Interface)]
+# [SNIPPET_CATEGORIES: PyKDE4]
+# [SNIPPET_DESCRIPTION: Device integration framework for a network interface]
+# [SNIPPET_AUTHOR: Jim Bublitz <[e-mail]>]
+# [SNIPPET_LICENSE: GPL]
+# [SNIPPET_DOCS: http://api.kde.org/pykde-4.3-api/solid/index.html, http://api.kde.org/pykde-4.3-api/solid/Solid.NetworkInterface.html]
+
+from PyQt4.QtCore import Qt
+from PyQt4.QtGui import QSizePolicy, QTreeWidget, QTreeWidgetItem, QLabel
+
+from PyKDE4.kdecore import i18n
+from PyKDE4.solid import Solid, Solid
+from PyKDE4.kdeui import KVBox, KHBox, KTextEdit
+
+helpText = """The Solid class discovers information about the hardware on a machine.
+
+Solid.NetworkInterface objects retrieve information about the network
+on a machine.
+
+We use Solid.Device.allDevices () to get a list of all devices, and then
+filter it for Solid.NetworkInterface types.
+"""
+
+class MainFrame(KVBox):
+    def __init__(self, parent=None):
+        KVBox.__init__(self, parent)
+        self.help  = QLabel (i18n (helpText), self)
+        self.layout ().setAlignment (self.help, Qt.AlignHCenter)
+        self.setSpacing (10)
+
+        statusString = {
+                          Solid.Networking.Unknown: "Unknown",\
+                          Solid.Networking.Unconnected: "Unconnected",\
+                          Solid.Networking.Disconnecting: "Disconnecting",\
+                          Solid.Networking.Connecting: "Connecting",\
+                          Solid.Networking.Connected: "Connected"\
+                       }
+
+        status = Solid.Networking.status ()
+        self.label = QLabel ("Status:   %s" % statusString [status], self)
+        
+        hBox = KHBox (self)
+                
+        display = QTreeWidget (hBox)
+        display.setSizePolicy (QSizePolicy.Expanding, QSizePolicy.Expanding)
+        display.setHeaderLabels (["Interface", "Name", "Wireless", "HW Addr", "MAC Addr"])
+        display.setColumnWidth (0, 200)
+        display.setColumnWidth (1, 75)
+        display.setColumnWidth (3, 150)
+
+        # retrieve a list of Solid.Device for this machine
+        deviceList = Solid.Device.allDevices ()
+
+        
+        # filter the list of all devices and display matching results
+        # note that we never create a Solid.NetworkInterface object, but
+        # receive one from the 'asDeviceInterface' call
+        for device in deviceList:
+            if device.isDeviceInterface (Solid.DeviceInterface.NetworkInterface):
+                iface = device.asDeviceInterface (Solid.DeviceInterface.NetworkInterface)
+                QTreeWidgetItem (display, [device.product (),
+                                           iface.ifaceName (),
+                                           str (iface.isWireless ()),
+                                           iface.hwAddress (),
+                                           str (iface.macAddress ())])
+
+        
+        
+
+# This example can be run standalone
+
+if __name__ == '__main__':
+
+    import sys
+
+    from PyQt4.QtCore import SIGNAL
+    
+    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_StorageDrive"
+    catalog     = ""
+    programName = ki18n ("Solid_StorageDrive")                 #ki18n required here
+    version     = "1.0"
+    description = ki18n ("Solid.StorageDrive Example")         #ki18n required here
+    license     = KAboutData.License_GPL
+    copyright   = ki18n ("(c) 2007 Jim Bublitz")    #ki18n required here
+    text        = ki18n ("none")                    #ki18n required here
+    homePage    = "www.riverbankcomputing.com"
+    bugEmail    = "[e-mail]"
+
+    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")
+    mainWindow.show()
+    app.connect (app, SIGNAL ("lastWindowClosed ()"), app.quit)
+    app.exec_ ()

=== added file 'pykde4/solid_processor.py'
--- pykde4/solid_processor.py	1970-01-01 00:00:00 +0000
+++ pykde4/solid_processor.py	2010-03-24 06:55:25 +0000
@@ -0,0 +1,96 @@
+#!/usr/bin/env python
+
+# [SNIPPET_NAME: Solid (Processor)]
+# [SNIPPET_CATEGORIES: PyKDE4]
+# [SNIPPET_DESCRIPTION: Device integration framework for a processor]
+# [SNIPPET_AUTHOR: Jim Bublitz <[e-mail]>]
+# [SNIPPET_LICENSE: GPL]
+# [SNIPPET_DOCS: http://api.kde.org/pykde-4.3-api/solid/index.html, http://api.kde.org/pykde-4.3-api/solid/Solid.Processor.html]
+
+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.Processor objects retrieve information about the processor on a machine. The
+table below shows the data for your machine. Not all computers make processor info
+accessible, so the table may be empty.
+
+We use Solid.Device.allDevices () to get a list of all devices, and then
+filter it for Solid.Processor types.
+"""
+
+class MainFrame(KVBox):
+    def __init__(self, parent=None):
+        KVBox.__init__(self, parent)
+        self.help  = QLabel (i18n (helpText), self)
+        self.layout ().setAlignment (self.help, Qt.AlignHCenter)
+        self.setSpacing (10)
+        
+        display = QTreeWidget ()        
+        display.setHeaderLabels (["Processor", "Max Speed", "Number", "Change Freq"])
+        
+        # retrieve a list of Solid.Device for this machine
+        deviceList = Solid.Device.allDevices ()
+
+        # filter the list of all devices and display matching results
+        for device in deviceList:
+            if device.isDeviceInterface (Solid.DeviceInterface.Processor):
+                cpu = device.asDeviceInterface (Solid.DeviceInterface.Processor)
+                QTreeWidgetItem (display, [device.product (),
+                                           str (cpu.maxSpeed ()),
+                                           str (cpu.number ()),
+                                           str (cpu.canChangeFrequency ())])
+
+        
+        
+
+# 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_StorageDrive"
+    catalog     = ""
+    programName = ki18n ("Solid_StorageDrive")                 #ki18n required here
+    version     = "1.0"
+    description = ki18n ("Solid.StorageDrive Example")         #ki18n required here
+    license     = KAboutData.License_GPL
+    copyright   = ki18n ("(c) 2007 Jim Bublitz")    #ki18n required here
+    text        = ki18n ("none")                    #ki18n required here
+    homePage    = "www.riverbankcomputing.com"
+    bugEmail    = "[e-mail]"
+
+    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")
+    mainWindow.show()
+    app.connect (app, SIGNAL ("lastWindowClosed ()"), app.quit)
+    app.exec_ ()

=== added file 'pykde4/solid_storageaccess.py'
--- pykde4/solid_storageaccess.py	1970-01-01 00:00:00 +0000
+++ pykde4/solid_storageaccess.py	2010-03-24 06:55:25 +0000
@@ -0,0 +1,104 @@
+#!/usr/bin/env python
+
+# [SNIPPET_NAME: Solid (Storage Access)]
+# [SNIPPET_CATEGORIES: PyKDE4]
+# [SNIPPET_DESCRIPTION: Device integration framework for storage access]
+# [SNIPPET_AUTHOR: Jim Bublitz <[e-mail]>]
+# [SNIPPET_LICENSE: GPL]
+# [SNIPPET_DOCS: http://api.kde.org/pykde-4.3-api/solid/index.html, http://api.kde.org/pykde-4.3-api/solid/Solid.StorageAccess.html]
+
+from PyQt4.QtCore import Qt
+from PyQt4.QtGui import QSizePolicy, QTreeWidget, QTreeWidgetItem, QLabel
+
+from PyKDE4.kdecore import i18n
+from PyKDE4.solid import Solid
+from PyKDE4.kdeui import KVBox, KHBox
+
+helpText = """The Solid class discovers information about the hardware on a machine.
+
+Solid.StorageAccess objects retrieve information about the accessibility of
+storage on a machine. It also allows interaction, like mounting and unmounting. The
+table below shows the data for your machine.
+
+We use Solid.Device.allDevices () to get a list of all devices, and then
+filter it for Solid.StorageAccess types.
+"""
+
+class MainFrame(KVBox):
+    def __init__(self, parent=None):
+        KVBox.__init__(self, parent)
+        self.help  = QLabel (i18n (helpText), self)
+        self.layout ().setAlignment (self.help, Qt.AlignHCenter)
+        self.setSpacing (10)
+
+        hBox = KHBox (self)
+                
+        display = QTreeWidget (hBox)        
+        display.setSizePolicy (QSizePolicy.Expanding, QSizePolicy.Expanding)
+        display.setHeaderLabels (["Volume", "File Path", "Accessible"])
+        display.setColumnWidth (0, 200)
+        display.setColumnWidth (1, 300)   
+
+        # retrieve a list of Solid.Device for this machine
+        deviceList = Solid.Device.allDevices ()
+
+        # filter the list of all devices and display matching results
+        # note that we never create a Solid.StorageAccess object, but
+        # receive one from the 'asDeviceInterface' call
+        for device in deviceList:
+            if device.isDeviceInterface (Solid.DeviceInterface.StorageAccess):
+                access = device.asDeviceInterface (Solid.DeviceInterface.StorageAccess)
+                QTreeWidgetItem (display, [device.product (),
+                                           access.filePath (),
+                                           str (access.isAccessible ())])
+
+        
+        
+
+# This example can be run standalone
+
+if __name__ == '__main__':
+
+    import sys
+
+    from PyQt4.QtCore import SIGNAL
+    
+    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_StorageDrive"
+    catalog     = ""
+    programName = ki18n ("Solid_StorageDrive")                 #ki18n required here
+    version     = "1.0"
+    description = ki18n ("Solid.StorageDrive Example")         #ki18n required here
+    license     = KAboutData.License_GPL
+    copyright   = ki18n ("(c) 2007 Jim Bublitz")    #ki18n required here
+    text        = ki18n ("none")                    #ki18n required here
+    homePage    = "www.riverbankcomputing.com"
+    bugEmail    = "[e-mail]"
+
+    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")
+    mainWindow.show()
+    app.connect (app, SIGNAL ("lastWindowClosed ()"), app.quit)
+    app.exec_ ()

=== added file 'pykde4/solid_storagedrive.py'
--- pykde4/solid_storagedrive.py	1970-01-01 00:00:00 +0000
+++ pykde4/solid_storagedrive.py	2010-03-24 06:55:25 +0000
@@ -0,0 +1,126 @@
+#!/usr/bin/env python
+
+# [SNIPPET_NAME: Solid (Storage Drive)]
+# [SNIPPET_CATEGORIES: PyKDE4]
+# [SNIPPET_DESCRIPTION: Device integration framework for a storage drive]
+# [SNIPPET_AUTHOR: Jim Bublitz <[e-mail]>]
+# [SNIPPET_LICENSE: GPL]
+# [SNIPPET_DOCS: http://api.kde.org/pykde-4.3-api/solid/index.html, http://api.kde.org/pykde-4.3-api/solid/Solid.StorageDrive.html]
+
+from PyQt4.QtCore import Qt
+from PyQt4.QtGui import QSizePolicy, QTreeWidget, QTreeWidgetItem, QLabel
+
+from PyKDE4.kdecore import i18n
+from PyKDE4.solid import Solid
+from PyKDE4.kdeui import KVBox, KHBox, KColorButton
+
+helpText = """The Solid class discovers information about the hardware on a machine.
+
+Solid.StorageDrive objects retrieve information about storage devices on a
+machine. the table below shows the data for your machine.
+
+We use Solid.Device.allDevices () to get a list of all devices, and then
+filter it for Solid.StorageDrive types.
+"""
+
+class MainFrame(KVBox):
+    def __init__(self, parent=None):
+        KVBox.__init__(self, parent)
+        self.help  = QLabel (i18n (helpText), self)
+        self.layout ().setAlignment (self.help, Qt.AlignHCenter)
+        self.setSpacing (10)
+       
+        hBox = KHBox (self)
+       
+        display = QTreeWidget (hBox)        
+        display.setSizePolicy (QSizePolicy.Expanding, QSizePolicy.Expanding)
+        display.setHeaderLabels (["Device", "Bus", "Type", "Hot Plug", "Removable"])
+        display.setColumnWidth (0, 150)
+
+        # convert enum values to strings for display
+        bus2Str = {Solid.StorageDrive.Ide : "IDE",\
+                   Solid.StorageDrive.Usb : "USB",\
+                   Solid.StorageDrive. Ieee1394 : "IEE1394",\
+                   Solid.StorageDrive.Scsi : "SCSI",\
+                   Solid.StorageDrive.Sata : "SATA",\
+                   Solid.StorageDrive.Platform : "Platform"
+                  }
+
+
+        driveType2Str = {Solid.StorageDrive.HardDisk : "Hard Disk",\
+                         Solid.StorageDrive.CdromDrive : "CD ROM",\
+                         Solid.StorageDrive.Floppy : "Floppy",\
+                         Solid.StorageDrive.Tape : "Tape",\
+                         Solid.StorageDrive.CompactFlash : "Compact Flash",\
+                         Solid.StorageDrive.MemoryStick : "Memory Stick",\
+                         Solid.StorageDrive.SmartMedia : "Smart Media",\
+                         Solid.StorageDrive.SdMmc : "SD MMC",\
+                         Solid.StorageDrive.Xd : "XD"
+                        }
+        
+
+        # retrieve a list of Solid.Device for this machine
+        deviceList = Solid.Device.allDevices ()
+
+        # filter the list of all devices and display matching results
+        # note that we never create a Solid.StorageDrive object, but
+        # receive one from the call to 'asDeviceInterface'
+        for device in deviceList:
+            if device.isDeviceInterface (Solid.DeviceInterface.StorageDrive):
+                drive = device.asDeviceInterface (Solid.DeviceInterface.StorageDrive)
+                QTreeWidgetItem (display, [device.product (),
+                                           bus2Str [drive.bus ()],
+                                           driveType2Str [drive.driveType ()],
+                                           str (drive.isHotpluggable ()),
+                                           str (drive.isRemovable ())])
+
+        
+        
+
+# This example can be run standalone
+
+if __name__ == '__main__':
+
+    import sys
+
+    from PyQt4.QtCore import SIGNAL
+    
+    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_StorageDrive"
+    catalog     = ""
+    programName = ki18n ("Solid_StorageDrive")                 #ki18n required here
+    version     = "1.0"
+    description = ki18n ("Solid.StorageDrive Example")         #ki18n required here
+    license     = KAboutData.License_GPL
+    copyright   = ki18n ("(c) 2007 Jim Bublitz")    #ki18n required here
+    text        = ki18n ("none")                    #ki18n required here
+    homePage    = "www.riverbankcomputing.com"
+    bugEmail    = "[e-mail]"
+
+    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")
+    mainWindow.show()
+    app.connect (app, SIGNAL ("lastWindowClosed ()"), app.quit)
+    app.exec_ ()

=== added file 'pykde4/solid_storagevolume.py'
--- pykde4/solid_storagevolume.py	1970-01-01 00:00:00 +0000
+++ pykde4/solid_storagevolume.py	2010-03-24 06:55:25 +0000
@@ -0,0 +1,114 @@
+#!/usr/bin/env python
+
+# [SNIPPET_NAME: Solid (Storage Volume)]
+# [SNIPPET_CATEGORIES: PyKDE4]
+# [SNIPPET_DESCRIPTION: Device integration framework for a storage volume]
+# [SNIPPET_AUTHOR: Jim Bublitz <[e-mail]>]
+# [SNIPPET_LICENSE: GPL]
+# [SNIPPET_DOCS: http://api.kde.org/pykde-4.3-api/solid/index.html, http://api.kde.org/pykde-4.3-api/solid/Solid.StorageVolume.html]
+
+from PyQt4.QtCore import Qt
+from PyQt4.QtGui import QSizePolicy, QTreeWidget, QTreeWidgetItem, QLabel
+
+from PyKDE4.kdecore import i18n
+from PyKDE4.solid import Solid
+from PyKDE4.kdeui import KVBox, KHBox, KColorButton
+
+helpText = """The Solid class discovers information about the hardware on a machine.
+
+Solid.StorageVolume objects retrieve information about storage volumes on a
+machine. The table below shows the data for your machine.
+
+We use Solid.Device.allDevices () to get a list of all devices, and then
+filter it for Solid.StorageVolume types.
+"""
+
+class MainFrame(KVBox):
+    def __init__(self, parent=None):
+        KVBox.__init__(self, parent)
+        self.help  = QLabel (i18n (helpText), self)
+        self.layout ().setAlignment (self.help, Qt.AlignHCenter)
+        self.setSpacing (10)
+
+        hBox = KHBox (self)
+
+        display = QTreeWidget (hBox)        
+        display.setSizePolicy (QSizePolicy.Expanding, QSizePolicy.Expanding)
+        display.setHeaderLabels (["Volume", "FS Type", "Label", "Ignored", "Size", "Usage"])
+        display.setColumnWidth (0, 150)
+
+        # convert enum values to strings for display
+        usageType2Str = { Solid.StorageVolume.Other : "Other",\
+                          Solid.StorageVolume.Unused : "Unused",\
+                          Solid.StorageVolume.FileSystem : "File System",
+                          Solid.StorageVolume.PartitionTable : "Partition Tbl",\
+                          Solid.StorageVolume.Raid : "Raid",\
+                          Solid.StorageVolume.Encrypted : "Encrypted"
+                        }        
+
+        # retrieve a list of Solid.Device for this machine
+        deviceList = Solid.Device.allDevices ()
+
+        # filter the list of all devices and display matching results
+        # note that we never create a Solid.StorageVolume object,
+        # but receive one from the 'asDeviceInterface" call
+        for device in deviceList:
+            if device.isDeviceInterface (Solid.DeviceInterface.StorageVolume):
+                volume = device.asDeviceInterface (Solid.DeviceInterface.StorageVolume)
+                QTreeWidgetItem (display, [device.product (),
+                                           volume.fsType (),
+                                           volume.label (),
+                                           str (volume.isIgnored ()),
+                                           "%i MB" % (volume.size ()/1024/1024),
+                                           usageType2Str [volume.usage ()]])
+
+        
+        
+
+# This example can be run standalone
+
+if __name__ == '__main__':
+
+    import sys
+
+    from PyQt4.QtCore import SIGNAL
+   
+    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_StorageDrive"
+    catalog     = ""
+    programName = ki18n ("Solid_StorageDrive")                 #ki18n required here
+    version     = "1.0"
+    description = ki18n ("Solid.StorageDrive Example")         #ki18n required here
+    license     = KAboutData.License_GPL
+    copyright   = ki18n ("(c) 2007 Jim Bublitz")    #ki18n required here
+    text        = ki18n ("none")                    #ki18n required here
+    homePage    = "www.riverbankcomputing.com"
+    bugEmail    = "[e-mail]"
+
+    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")
+    mainWindow.show()
+    app.connect (app, SIGNAL ("lastWindowClosed ()"), app.quit)
+    app.exec_ ()