Robotics Service Bus

h1. Installation of Python Implementation

h2. External Dependencies

* install python setuptools and python-dev
* spread-python (e.g. via GAR installer, sources can be downloaded here: http://www.spread.org/files/SpreadModule-1.5spread4.tgz, *the version automatically installed by setuptools is NOT working!*)
* python-protobuf (via ubuntu package python-protobuf or protobuf sources)

h2. Installation

# Install RSBProtocol as described [[InstallationC++|here]]
# get sources
# create and edit @setup.cfg@
#* in contrast to cmake or partially ant, setuptools does not use command line arguments to configure projects. Instead a file called @setup.cfg@ in the project root is used: http://docs.python.org/distutils/configfile.html
#* especially, replace @protocolroot@ in section @[proto]@ with the path to the RSBPRobotocol files (e.g. protocolroot=${prefix}/share/RSBProtocol)
#* other available options (besides standard ones from python):
#** @protoc@ in section @[proto]@: The protoc compiler used to generate the protocol. If not specified @PATH@ is used.
#** @format@ in section @[doc]@: either "html" or "pdf" for the API documentation generation
#** @verbose@ in section @[doc]@: bool flag to control verbose output of the generation tool epydoc
#** @spread@ in sections @[coverage]@ and @[test]@: path to the spread executable used for coverage generation and unit testing. @PATH@ is used if not specified
#* An exemplary @setup.cfg@ file could look like this:
<pre>
[proto]
protocolroot=/your/prefix/share/RSBProtocol
[test]
spread=/your/prefix/sbin/spread
[coverage]
spread=/your/prefix/sbin/spread
</pre>
# start building and installation
<pre>
export PYTHONPATH=$prefix/lib/python2.X/site-packages
python setup.py build
python setup.py install --prefix=$prefix
</pre>

Afterwards, @import rsb@ should be possible in a python shell.