pyMbus	Version 0.5						Wed Feb 28 2002

The Mbus-Transport-Protocol is a "mutlicast message bus for local coordination"
(see http://www.mbus.org for details). PyMbus fully implements the
Mbus-Transport-Draft (http://www.mbus.org/drafts/
draft-ietf-mmusic-mbus-transport-06.html) and has been successfully tested
against the C++, C, Java implementations.
Due to the lack of crypto algorithms in the standard python distribution
encrypted mbus sessions are not supported at the moment.


Brief description of the files:

mbus/notifier.py	-- mainloop, design is similar to gtk-mainloop
mbus/hmac.py		-- Keyed-Hashing for Message Authentication (Bryan Olson)
mbus/mbuscfg.py		-- configparser for ~/.mbus
mbus/mbusif.py		-- interface to the standard message mbus
mbus/mbustypes.py	-- definition of mbus data types
mbus/mbusguides.py	-- partly implementation of mbus-guidlines (only RPCs)

examples/mbusexample.py -- example of a lowlevel mbus app
examples/rpcserver.py   -- rpcserver example
examples/rpcclient.py	-- client which talks to the server
examples/mbussh.py	-- simple mbus-shell for debugging purposes

The examples directory contains some simple mbus-examples. To test them you need
a valid .mbus-File (just copy dot-mbus to ~/.mbus) and the directory containing
the above files in your PYTHONPATH environment variable. You also need at least
python 2.0 or higher.



mbus/wx/notifier.py	-- mainloop to use wxPython GUI together with pyMbus
		   Warning: needs threads enabled python!
		   (www.wxpython.org, www.wxwindows.org)
mbus/wx/wxTest.py	-- simple wxPython/pyMbus example (needs wxWindows and wxPython)

mbus/gtk/notifier.py	-- mainloop wrapper on top of gtk.mainloop()
mbus/gtk/hello2.py	-- simple gtk/pyMbus example (needs pyGtk and gtk)

The easiest way to use one of the gui notifiers is to put their path in the
PYTHONPATH environment variable before the mbus path.



The source of the library is well documented (I hope). For questions, comments
and bugreports send an email to logic@tzi.org
