co2

reference implementation in python


to find out about co2, visit: http://co2.mur.at/



##################################################################
prerequisites and dependencies

*nix type OS (tested: linux)
network connection ('real' IP address or appropriate forwarding)
python >= 2.3
[pd (tested version 0.36) for pd.bridge]


##################################################################
files:

* checker.py: does periodic stuff for the server (ping)
* client.py: XMLRPC proxy
* co2.py: startscript (run this)
* config.py: server configuration file
* doc/: documentation
* html_lib/:
  * html_factory.py: handle html stuff (webinterface)
* httplib.py: patched standard python2.3 module (sockettimeout)
* java/: application that polls info from a co2 relay written in java
	(see th README file)
	* Co2Test.java: the source
	* Co2Test.class: precompiled with jikes / blackdown jdk 1.4.1
* loader.py: plugin loader / initializer
* logs/:
  * log: co2 log/debug file
* plugins/: contains plugin packages
  * plugin.py: module with all things necessary to write a plugin
  * example/:
    * example.py: a commented example plugin
  * pd/:
    * bridge.py: plugin for use with a pd-patch
      (passes on data between co2 and pd)
		* bridge_config.py: configuration file for bridge
    * process.py: translates data, used by bridge
	* test/:
		* interact.py: simple plugin in to send co2 data from the console
* registry.py: the server's registry
  (pool of xmlrpc methods and related stuff)
* relay_registry.py: registry with relay functionality
* satellite.py: represetation of a co2 satellite, used by relay_registry
* satellite_registry.py: registry with satellite functionality
* server.py: XMLRPC server and handler
* util.py: misc. utility stuff
* xmlrpclib.py: patched standard python2.3 module (sockettimeout)



homepage: http://co2.mur.at/
author: ludwig zeininger, lu_AT_mur.at
