papyon is the library behind the msn connection manager : telepathy-butterfly. It is a fork of the unmaintained pymsn msn library. papyon uses the glib mainloop to process the network events in an asynchronous manner.
Get papyon
Papyon releases are here:
To get the latest development branch:
- git clone git://git.collabora.co.uk/git/papyon.git
Features
Here is a quick features list :
- + MSNP15
- + Best MSNP2P implementation : avatars and custom emoticons
- + Yahoo messenger contacts support : chat and presence
- + Live Address Book support : full contact and group management
- + Server side contacts aliasing
- + Offline messages support
- + MSN Spaces
- + Content Roaming support : avatar, display name and personal message storage
- + Full support for HTTP and HTTPS proxies
- + Support HTTP Polling transport
- + No threads, fully asynchronous
+ Caching system (only used for storing the SSO tickets for now, but will be used to support deltas in the AddressBook later)
- + Very solid and extensible architecture
- + Solid networking through a new sublibrary : gnet
Dependencies
papyon depends on:
python >= 2.5
python gobject >= 2.10.1
ElementTree >= 1.2.0 or cElementTree >= 1.0.5 or python >= 2.5
pyOpenSSL >= 0.6
pyCrypto >= 2.0.0
Try it
to give papyon a try, run the test.py python code, this will connect to the msn IM service, and try to fetch the first online contact's display picture:
- python test.py
Report bugs
To report bugs, use the freedesktop.org bugzilla here and select the papyon component.
Help out
The things that are still to be done in papyon can be found in the TODO page.
Documentation
Generate the documentation with python setup.py doc (you need epydoc)
Doc is generated in doc/user-api/ directory
This link can help : pymsn article : the crack-powered address book
Troubleshooting
OverflowError: long too big to convert
If you get something like that:
Overflow Error: long too big to convert (while registering property 'bytes-transferred' for GType 'papyon+msnp2p+P2PMessage')
you probably would need to update your python gobject binding. This is a known bug of python gobject that was fixed in python gobject 2.10.1.
Contact
You can contact developers using IRC: #papyon on irc.freenode.net