Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Python bindings to libpurple
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Type||Name||Latest commit message||Commit time|
|Failed to load latest commit information.|
python-purple - Python bindings for libpurple --------------------------------------------- Copyright (c) 2008 INdT - Instituto Nokia de Tecnologia Requirements ------------ In order to build python-purple, you need the following packages: * cdbs * debhelper * libpurple-dev * libglib2.0-dev * python2.5-dev * python2.5-distutils * cython (optional) Although it's not dependent, cython should also needed if you want to re-create purple.c file (generated from cython using purple.pyx). Building and installing python-purple ------------------------------------- Building cython-generated purple.c file (optional): $ cython purple.pyx -I libpurple/ This is also done by setup.py when running: $ python2.5 setup.py build If you don't need to generate purple.c file, you can use setup_dist.py: $ python2.5 setup_dist.py build Both setups generates purple.so inside build/ directory. The difference is that setup.py also generates purple.c file, if it doesn't exists. To install files inside your system: $ sudo python2.5 setup.py install --root=/usr You can also create a debian package of it: $ dpkg-buildpackage -rfakeroot Testing python-purple --------------------- Python-purple provides a client example (nullclient) which connects to a Gtalk account and displays libpurple's debug messages. In order to execute it, issue the following command: $ LD_PRELOAD=/usr/lib/libpurple.so.0 python2.5 nullclient.py It will ask for a username and then password. Insert it and it will automatically connect to the given account. There is also another example client (nullclient-ecore), which provides some callback examples from libpurple interacting with UI. In order to execute it, issue the following command: $ LD_PRELOAD=/usr/lib/libpurple.so.0 python2.5 nullclient-ecore.py An Etk-based window will pop up showing text windows, a command entry and three buttons ('Send', 'Connect', 'Add account'). In order to test it, follow the steps below: 1. Click on 'Add account' button. A pop-up window appears, and you can enter there a gmail-based account (e.g. email@example.com). Click 'Ok' when done. 2. Click on 'Connect' button. A pop-up window appears asking for account's password. Click 'Ok' when done. Now wait for the account connection. When 'Connected' appears, your buddy list gets updated. 3. You are now connected! Select a buddy from buddy list, write a message on the command entry and click 'Send'. Your message appears in the text box. If your buddy replies, his/her message also gets shown in the text box.