
                             Python darkstat API

WHAT IS IT
   This is a collection of packages and scripts to access darkstat API from
Python.
   The "darkstat" subdirectory contains the main API package. The file
setup.py is Python Distutils setup script. Run "python setup.py --help" to
get help. The file total-bytes.py is just an example script that show how
to use darkstat API.
   The file dstat-wait.py is a real script that uses the API; it
periodically asks darkstat about total number of bytes passed and waits
until the number gets increased by a given amount, then stop. It can be
used, for example, in a script like that:

# /etc/rc.d/firewall open
# /usr/local/sbin/dstat-wait.py localhost 8080 10M
# /etc/rc.d/firewall close


WHERE TO GET
   http://purl.org/net/darkstat


HOW TO INSTALL
   There is a simple Makefile for those who prefer to run "make install".
The real work is done by Python Distutils. You can run
"python setup.py install" by yourself.


AUTHOR
   Oleg Broytmann <phd@phd.pp.ru>

LICENSE
   GPL
