Python module for Sleepycat's Berkeley DB XML library
Copyright (c) 2003 Sleepycat Software

INTRODUCTION

This module is built using SWIG (http://www.swig.org) to produce a
Python module that maps to the Berkeley DB XML C++ API fairly closely.
At present, separate documentation for the Python API is not provided.
Refer to the C++ API documentation and the Python examples for more
information, or contact Sleepycat Support (support@sleepycat.com).


BUILDING

To build and install this module, you first need:

  * Python 2.2 or newer

  * a recent version of the bsddb3 Python module installed
    (http://pybsddb.sourceforge.net).  Note: this module has been
    accepted into the Python core, and will ship with Python 2.3 and
    above.  Also, note that this module must be compiled against the
    same version of Berkeley DB you are building Berkeley DB XML
    against.

  * a working build of Berkeley DB XML compiled with the same C++
    compiler as Python.

This module uses the standard Python distutils to control building and
installing into the Python tree.  To build, run the following command:

    python setup.py build

If you have built Berkeley DB or Xerces in locations other than under
the 'lib', you will need to edit setup.py by hand to change the paths.

To install, run this:

    python setup.py install


TESTING

The Python examples are in the directory examples/python in the top of the
Berkeley DB XML tree.  Once this module is installed, the examples can
be run in that directory with:

    python examples.py test

If you want to test before installing, you will need to build and set
PYTHONPATH to include the build directory (src/python/build/lib.*).

For more information, contact Sleepycat Support (support@sleepycat.com).


$Id: README,v 1.1 2003/03/31 07:49:52 mjc Exp $
