                               dumper.py
                              version 1.0
                  Greg Ward <gward@mems-exchange.org>

INTRODUCTION
------------

dumper is a module that provides tools for dumping deeply nested Python
data in a readable, customizable, controllable way.  It handles
recursive structures, class instances, and lets you control how deeply
the dump goes in a couple of ways.  (In particular, you can set a simple
depth limit, or you can decide just when class instances contained by
other class instances will be dumped, and when the dump will be
suppressed in order to keep things under control.)

Extensive documenation is embedded in the module source code; see it for
details.


INSTALLATION
------------

Should be a snap.  If you have the Distutils (Python Module Distribution
Utilities) installed, do this (should work on Unix or Windows):

   python setup.py -v install

Otherwise, you'll have to manually copy dumper.py to an appropriate
directory, eg. (for Unix systems installed in the default way):

   cp dumper.py /usr/local/python/lib/python1.5/site-packages
