
 pysp
 Version 1.0
 Lars Marius Garshol - larsga@garshol.priv.no
 http://www.garshol.priv.no/download/software/pysp/


This is a Python module wrapper for James Clark's SP SGML parser. It
uses SP's generic API and so offers a very simple event-based
interface that allows you to build SGML processing applications in
Python. It is somewhat restricted, due to the restrictions in SP's
generic API.


--- BUILDING

There are three ways to build this package, all of which require that
you have first downloaded SP and built libsp.a.

 1. Say 'python setup.py install' and everything should just work.
    Note that you need a distutils version newer than 1.0.1 (which
    means that the one distributed with Python 2.0 does _not_ work).
   
    You probably need to modify the paths in setup.cfg.

 2. Say 'make' and everything should, again, just work.

    You probably need to modify the paths in the makefile.

 3. DIY. :-)


--- USING

There is a very simple example application in doc/demo.py that shows
the entire API. Run it on doc/tst.sgml to see what it does.


