Mod_Python XML-RPC Server 0.0.2
===============================

March 6th, 2003
Jack Neely
<slack@quackmaster.net>

This is a very simple XMLRPC server designed to be run under Apache
and Mod_Python.  It's been developed on Red Hat Linux 8.0 which uses
Apache 2.0.40, Python 2.2, and mod_python 3.0.0.  Its a fairly small
and simple thing that should be able to run on Red Hat Linux 7.x and
future versions.

The reasoning for this is that there isn't all that much in the wild
that tells you how to do this with mod_python.  In fact, its really,
really simple, but its nice to have some wrappers to make the
programmer's job easier.


Installing:

Make a directory that Apache can will serve out.  Set the
AllowOverride directive for that directory to contain FileInfo.  In an
.htaccess file in that directory you'll want to have something that
looks like this:

      AddHandler python-program .py
      PythonHandler handler

Untar the files from the tarball.  (This should contain a .htaccess
file for you.)  After this you should be able to change the URL in the
go.py driver file and do the quick Hello World test that's included.


Making it Useful:

To make the server actually useful I'll leave it up to you to write a
client that does what you want.  You will also have to write the rest
of your server.  The API module is the starting point for what methods
are exposed by the XML-RPC server.  You can define functions there and
import modules.  You must also put the module name and function names
that you wish exported in the __API list.  If this does include a
module, you will need to go into that module and define a __API list
that contains the modules and functions from that file to export.


Anyway, I hope that others find this useful.

Jack Neely