Note: If a binary distribution of KInterbasDB (e.g., Windows executable installer, Linux RPM) is not available for your platform, you will need to install the source distribution instead.
KInterbasDB requires a valid combination of the dependencies in the list below.
Detailed instructions on how to install each dependency are beyond the scope of this document; consult the dependency distributor for installation instructions.
Satisfying the dependencies is not difficult! For mainstream operating systems--including Windows and Linux--easily installable binary distributions are available for all of KInterbasDB's dependencies (see the download links below).
KInterbasDB uses the DateTime module of the eGenix.com mx Extensions to represent date and time objects, as recommended by the Python DB API Specification.
Once you have successfully installed the dependencies, you may proceed with the installation of KInterbasDB itself.
Binary distributions of KInterbasDB for Windows come in the form of a conventional executable installer. Just invoke the installer and follow the wizard prompts.
Note that because KInterbasDB contains an extension module written in C, you must use an installer created specifically for your Python version. If you do not have the correct installer, the wizard page entitled "Select Python installation to use:" will not display any Python installations; you must either download the correct installer from the KInterbasDB web site or download and install the source distribution.
Binary distributions of KInterbasDB for Linux come in the form of an
RPM package. Some Linux distributions offer a graphical interface to
RPM, but in general, you should issue the following
command to install the RPM (while logged in as root
):
rpm -i the_rpm_file_name
In order to function properly, the RPM system requires that all of a package's dependencies also be installed using RPM. Binary RPM packages are available for all of KInterbasDB's dependencies.
Also note that because KInterbasDB contains an extension module written in C,
you must use an RPM created specifically for your Python version (and possibly
also specifically for your Linux distribution and version). If you do not
have the correct RPM, and cannot find it at the
KInterbasDB web site
or
RPMFind.net,
you must
install the source distribution
instead. Because the KInterbasDB source distribution supports the
standard Python package installation facility
(distutils
),
installing the source distribution on a typical Linux system is downright
easy.
If you are unable to overcome a problem with the KInterbasDB RPM installation process, either visit the KInterbasDB Help Forum or install the source distribution instead.
Users of Linux distributions without RPM support must install the source distribution instead. The source distribution will probably also install (and function) on most other Unix variants, as long as all of the dependencies are also installed (and functional).
Because the KInterbasDB source distribution supports the
standard Python package installation facility
(distutils
),
installing the source distribution on a typical Linux system is downright
easy.
A test suite is planned for a future version of KInterbasDB, but it was not written in time for version 3.0.
In the meantime, verify the integrity of your KInterbasDB installation by
opening a command prompt and issuing the following command:
python -c "import kinterbasdb"
If the import attempt does not encounter any errors, you are finished. Next, consider reading the KInterbasDB Usage Guide.
You should not encounter any errors at this stage since you have already completed the installation step successfully. If you do, please report them to the KInterbasDB Help Forum.