Document Python API

[nichtich]

Covered by tests/test_service.py.

[nichtich]

API documented generated by pydoc should better be generated with another tool, the current documents are rarely useful, for instance there is no class hierarchy.