Kodos - Help

Overview
Running Kodos
The Kodos Main Window
An example
The Kodos Toolbar
Examining a regex
Pause processing of regex
Preferences

Running Kodos

Before you can run Kodos you will need to have a recent versions of python (1.5+, 2.1+ recommended), pyqt(2.3+) and sip (dependent on pyqt). This document assumes that your system meets these requirements.

Prequisites

If you have not already done so, download the latest version of Kodos from http://kodos.sourceforge.net

Unpack the Kodos tgz or zip file that you have downloaded. This will create a "kodos" subdirectory which will contain the application and supprt modules.

Running Kodos

cd into the kodos subdirectory:
$ cd kodos

Run the program:
$ python kodos.py
This assumes that you have a python interpreter executable in your PATH and that this is the version that pyqt has been compiled against. It is not uncommon for systems to have multiple versions of python installed so you should ensure that pyqt has been installed for the python interpreter that you invoke. If you have multiple python interpreters and you are unsure which one you have installed pyqt for you can try each one to verify:

$ python
>>>import qt
Traceback ....

$ python2.1
>>>import qt
>>>
In the first case above, qt fails to import. In the second case, qt imports successfully.

If you receive an exception traceback upon launching the Kodos application then it is most likely caused by an improper pyqt installation. Make sure that you are using the correct version of python for the version of pyqt that you are using and that the libraries are installed such that python can find them (either by placing them in the python site-packages directory or modifying your PYTHONPATH). If the qt shared objects are in an unusual place you may also have to modify your LD_LIBRARY_PATH to include this directory.

Since there are a variety of reasons why kodos could fail to run considering it's many dependencies (python, qt, pyqt and sip) there is no way I could easily list specific solutions. If you do come across a situation where you are unable to run kodos because of these dependenicies and if you find a way to resolve it I'd appreciate knowing the initial problems and the solution so that I can include it here for the reference of others.