# Overview

Open University LTS SOAP package

General instructions for installing Python modules and packages are at http://docs.python.org/install/index.html

This package requires Python 2.4 and later, but you'll have to provide WSGI somehow if you don't have Python 2.5 or later.

The simplest, at at present only supported, installation is as CGI scripts. This requires Python 2.5 or later.

You'll also need soaplib 1.0 and its dependencies.
http://pypi.python.org/pypi/soaplib/1.0.0
The most important of these dependencies is lxml.
http://pypi.python.org/pypi/lxml http://lxml.de/
For testing you'll needs suds, a SOAP client.
http://pypi.python.org/pypi/suds/0.4

To install as CGI follow the usual route of extract (if necessary), build and install. You may have to be root to install.

Finally, move the math_cgi.py script to your cgi-bin folder, with appropriate owner and permissions of course. You can rename this script if you wish.

The stub_math_cgi.py script provides stub services.

TESTING

The software can be tested from the unzipped distribution files (provided all the prerequisites are installed).

First, ensure that ou_lts_soap is in the PYTHONPATH environment variable. You will have to place it in as an absolute path.

Next, start the test web server at a port of your choice. The default is 8000. Here, for a change, we use 8080.

$python test_ou_lts_soap/serve_cgi.py 8080 Now run the stub test script$ python test_ou_lts_soap/test_stub_math_cgi.py 8080

Similarly, you can run the production test script

\$ python test_ou_lts_soap/test_math_cgi.py 8080

The expected outputs are recorded in the script files test_stub_math_cgi.py and test_math_cgi.py.

CHANGES

v0.1b

Provide MathML to speech text as a service (provided MathFlow is installed).

v0.1a

Initial release. Provides a stub service, which is sufficient to test installation.