[Telepathy] Status of Telepathy Python

[Mystilleef]

My decision to use Telepathy (Python) to write an SIP client
is on shaky grounds.

I'm running into snag after snag and it's affecting my
confidence in using this framework for my project.

Apart from the documentation problems (documentation should
emphasize "how" to do things as opposed to explaining
architectural designs and contain plenty examples), it
seems as if some interfaces available in the documentation
don't even work. See this bug for example.

https://bugs.freedesktop.org/show_bug.cgi?id=35314

That bug was submitted 3 months ago and there has been no
response, triage or confirmation of the bug from any
developer. The bug is most likely a blocker on any Python
project that wants to use Telepathy.

This bug might also be of interest for whoever
maintains telepathy farstream.

https://bugs.freedesktop.org/show_bug.cgi?id=37941

The Python examples in the Developer's handbook use
deprecated APIs which will inevitably confuse users new to
the framework. To make matters worse, most of the Python
examples don't even work.

On the documentation, the emphasize should be on "how" to
use an API. Each API should be accompanied with several
examples specifying several use cases.Users should be able
to read an API doc and know what it does, how, and when to
use it. Unfortunately, that's not the case with Telepathy. I
have to bounce from example code that I don't trust to work,
to reading source code, to reading the spec, to trial and
error hacking. Thus making my progress with framework very
slow.

QT does a fantastic job with their documentation it can be a
source of inspiration for the Telepathy framework.

Anyway, back to Telepathy Python. Is it still maintained? Is
it wise for us to use it to build an SIP client or should I
look elsewhere? Also are there any Free Software Python
apps that have been written with Telepathy?

Thanks