PyKDE4 - General Information
Prev |  | Next

## General Information

PyKDE4 is a set of Python bindings for KDE4's kdelibs. It includes the modules kdecore, solid, kdefx, kdeui, kio, kparts, kutils, khtml, kdeprint and two modules - kate and ktexteditor - which are useful in developing plugins for the kate and kwrite text editors.

PyKDE4 should be installed in a path known to Python (usually /usr/lib/python/site-packages). PyKDE4/ is the top level directory for all PyKDE4 modules, so an import statement and code references must look like:

    from PyKDE4.kdeui import KApplication
    ...
    app = KApplication ()

or:

    import PyKDE4.kdeui
    ...
    app = PyKDE4.kdeui.Kapplication ()

Other forms are also possible. The form:

    from PyKDE4.kdeui import *

is not recommended, as there may be clashes between object names in the various PyKDE4 modules.

### PyKDE4 Components

kdecore

kdecore contains classes for handling non-graphical needs of PyKDE4 applications, basic program information (KAboutData, KCmdLineArgs), URL handling (KUrl, KMimetype), date and time (KDateTime), file operations (KAutoSaveFile, KSaveFile), localization and translation (KLocale, KLocalizedString, i18n, ki18n), one config file mechanism (KConfig) and access to KService related mechanisms.

solid

solid contains classes for discovering the hardware and hardware capabilities on a system

kdefx

kdefx is a small module that includes some graphics effects.

kdeui

kdeui is the largest module in PyKDE4 and includes the classes necessary to create a KDE4/PyKDE4 application (KApplication, KUniqueApplication) and its main window (KMainWindow, KXmlGuiWindow), classes for actions (KAction, the KStandardAction namespace) most of the KDE4 widgets, pre-written or reusable dialogs and the base class for KDE4 dialogs (KDialog, KMessageBox, KColorDialog) and an alternative config file mechanism (KConfigSkeleton).

kio

The kio module includes classes to interact with and intiate KIO slaves (KIO:Job and descendants, KIO.NetAccess). It also contains the KFile* classes, including those which pop up file or directory selection dialogs, and a bookmark handling class (KBookmark and releated).

kparts

kparts includes classes to allow you to embed KParts in your application (creating a reusable KPart requires C++). It also includes classes that add capabilities to KHTMLPart (BrowserExtension, BrowserHostExtension).

kutils

kutils is a small module that includes some utility classes.

khtml

khtml includes classes (KHTMLPart, KHTMLView) that allow you to build a web browser into your application. This module also includes and extensive set of classes for DOM handling.

kdeprint

kdeprint provides an interface for printing documents from KDE4/PyKDE4 applications.

kate and ktexteditor

The kate and ktexteditor modules provide the ability to create plugins for kate and related classes.

### License

PyKDE4 is licensed under the GNU Lesser (or Library) General Public License (LGPL) version 2. That means non-open source software can use and link to the PyKDE4 libraries, as long as no substantial modifications are made to those libraries. A copy of the LGPL license should have been included with PyKDE4 in the file COPYING.LESSER. If not, you can find a copy online at the GNU web site.

The PyKDE4 documentation viewer (pykdedocs) and example code produced by the PyKDE4 authors are licensed under the GNU General Public License (GPL) version 2. Tutorials and other text information produced by the PyKDE4 authors is licensed under the Creative Commons License. Materials contributed to PyKDE4 are licensed as specified by the material's respective authors - see the individual files for license terms.

All code and text included in the PyKDE4 and pykdedocs packages may be freely distributed in its original form. If you need to modify any of the code or text and want to distribute the modified code, your modified code must be licensed under the GPL version 2 or later. If this is a problem, contact the author(s) of the material to be modified.

All code and text in PyKDE4 and pykdedocs is copyrighted and owned by the code's or text's respective authors - see specific files for more information.

PyKDE4 is built on software developed by

- KDE project programmers (the KDE Desktop Environment and kdelibs)
- Python programmers (the Python language and extensions)
- Riverbank Computiing (sip, PyQt4 and the original PyKDE version)

These packages are required, and each has its own licensing requirements.

### Disclaimer

pykdedocs is capable of interacting with external web sites via the internet. Use of the internet may expose you or your computer to well known risks.

pykdedocs and PyKDE4 are licensed for your use only under the GNU General Public License (GPL) version 2. The GPL includes the following disclaimers which apply to both internet access using pykdedocs, and the use of pykdedocs and PyKDE4 in general. A copy of the GPL can be found in the file documentation/COPYING at the location where pykdedocs documentation files were installed.

### NO WARRANTY

11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Prev | Table of Contents | Next
Table of Contents |  | Installation