PyQt - Python Bindings for the Qt Toolkit
INTRODUCTION
These are the Python bindings for Qt. You must also have the SIP Python
bindings generator installed.
The homepage is http://www.riverbankcomputing.co.uk/pyqt/.
The homepage of SIP is http://www.riverbankcomputing.co.uk/sip/.
COMMERCIAL VERSION
If you have the Commercial version of PyQt then you should also have a
license file that you downloaded separately. The license file must be copied
to the "sip" directory before starting to build PyQt.
INSTALLATION
Check for any other README files in this directory that relate to your
particular platform. Feel free to contribute a README for your platform or to
provide updates to any existing documentation.
Starting with v2.0, PyQt is installed in the site-packages directory of your
Python installation (if it exists). If you have an earlier version you should
remove it otherwise it may still be used in preference to the new version
depending on the value of sys.path for your Python installation.
The process for building PyQt is the same for all platforms. First of all, run
the `build.py' Python script. If you have multiple versions of Python
installed then make sure you use the interpreter for which you wish to build
the bindings for. The build script generates the C++ code appropriate for your
system and all the relevant makefiles. The script takes a number of options
that allows you to override particular settings. Run "python build.py -h" to
get a list of the available options.
Compiling and installing PyQt is then a simple case of running "make" followed
by "make install". Note that on a system where you would normally only need
administrator privileges to install PyQt, you also need them to compile PyQt.
The build system uses either "tmake" or "qmake" to actually generate the
required Makefiles. "qmake" is provided with Qt v3.x. If you are using an
earlier version of Qt then you will need a copy of "tmake" (v1.8 or later)
which is available from Trolltech (http://www.trolltech.com). You will need
to configure "tmake" for your system by setting the TMAKEPATH environment
variable to an appropriate value - see the "tmake" documentation for the
details.
THE REST OF THE DISTRIBUTION
The "examples2" and "examples3" directories contain some examples (for Qt v2.x
and Qt v3.x respectively) of Python scripts, including versions of the standard
Qt tutorials and examples.
The "doc" directory contains SGML and HTML documentation for the bindings.
This documentation includes a section describing the differences visible to
the Python programmer between this and the previous version - please read it.
The "eric" directory contains a Python debugger called "eric" written using
PyQt. eric is maintained by Detlev Offenbach.
The "sip" directory contains the .sip files that the "sip" executable generates
the C++ code from. If you are creating bindings for another module that
sub-classes from any of the Qt classes (eg. PyKDE) then these files will be
needed by that module's build process.
Phil Thompson
phil@riverbankcomputing.co.uk
