Before reporting bugs, please read the Troubleshooting and build.py Options pages.
PyKDE only runs on Linux or other Unix-based systems. The usual tools (compiler, linker, make, etc) are required. In addition you need:
NOTE: sip, PyTQt, and PyKDE must be compatible versions (the PyKDE build script will test for this). That means if you are installing PyKDE-3.16.0, you must have installed:
Of course you must also have Python (version 2.2 or later), KDE (any KDE 3.0 - 3.5.3 version) and TQt (any version from 3.0 through 3.3.x) installed. PyKDE no longer supports KDE1 or KDE2. These files only work with KDE and TQt 3.x.x - they don't work with TQt4 or the upcoming KDE 4.
If you have installed sip and PyTQt from binaries, to build PyKDE you must have the sipconfig.py and pytqtconfig.py files (suitable for your environment) installed. These are in the same location as the PyTQt files (usually python/site-packages). These config files are generated automatically if you build/compile sip and PyTQt from source.
PyKDE also requires the PyTQt sip files to build and compile. If you installed PyTQt from an RPM, you also need to have installed the corresponding "PyTQt-devel" RPM, which contains the PyTQt sip files.
Unpack the PyKDE tarball to a directory you have write access to. /usr/local is a good choice if you have write access or can obtain it. Some place in your home directory is also a good choice. I'll assume /usr/local for these instructions.
Change to the PyKDE directory (eg "cd /usr/local/PyKDE-3.16.0" or whatever the complete version of the downloaded PyKDE package was).
At a command line prompt (as a user, not as root), enter:
python configure.py
|
configure.py will check your system to locate Python and releated files, TQt, KDE, sip and PyTQt. It will also run several tests, and then begin generating the C++ code and make files for PyKDE. The entire process should take about 2 to 10 minutes depending on your computer's speed and available memory. configure.py will report its progress throughout its run. If errors occur, see the sections on troubleshooting below.
After configure.py has run to completion successfully, you next need to compile PyKDE. Simply type:
make
|
PyKDE takes anywhere from 15 minutes to over an hour to compile, depending on the speed of your computer, available memory, and other tasks running. Once PyKDE has compiled, do:
su -c"make install"
|
Your system will ask for your root password, and if entered correctly will proceed to install PyKDE.
If your computer has 256MB or more of memory, you will probably benefit from "file concatenation". When generating C++ files, sip can generate either a single file for each class in a module, or a single huge file that contains all classes in the module. The latter is the "concatenated" version.
As long as swapping doesn't occur and memory isn't exhausted, the concatenated files will compile up to 80% faster than individual files. However, some hardware and some gcc versions are not compatible with the large concatenated files. You can control whether sip concatenates files by passing either the -i switch (concatenation off) or -c switch (concatenation on) to configure.py.
configure.py is currently programmed to detect the gcc version being used, and will turn on concatenation for gcc earlier than 4.0 and turn off concatentation for gcc 4.0 or later. You can override this automatic choice with -i or -c as needed.
There are a number of things you can do to test your installation. The simplest test that also covers the most common errors is (still in the top level PyKDE directory):
python importTest.py
|
If you get errors running this test, see the troubleshooting section below.
There are also sample programs you can run (which also test some of PyKDE's features) in the examples/ and templates/ subdirectories.