edef0321888dba8af477e850e7b2ab473e1d07c7
[python-purple] / README
1 python-purple - Python bindings for libpurple
2 ---------------------------------------------
3
4 Copyright (c) 2008 INdT - Instituto Nokia de Tecnologia
5
6 Requirements
7 ------------
8
9 In order to build python-purple, you need the following packages:
10  * cdbs
11  * debhelper
12  * libpurple-dev
13  * libglib2.0-dev
14  * python2.5-dev
15  * python2.5-distutils
16  * cython (optional)
17
18 Although it's not dependent, cython should also needed if you want to
19 re-create purple.c file (generated from cython using purple.pyx).
20
21 Building and installing python-purple
22 -------------------------------------
23
24 Building cython-generated purple.c file (optional):
25
26 $ cython purple.pyx -I libpurple/
27
28 This is also done by setup.py when running:
29
30 $ python2.5 setup.py build
31
32 If you don't need to generate purple.c file, you can use setup_dist.py:
33
34 $ python2.5 setup_dist.py build
35
36 Both setups generates purple.so inside build/ directory. The difference is
37 that setup.py also generates purple.c file, if it doesn't exists.
38
39 To install files inside your system:
40
41 $ sudo python2.5 setup.py install --root=/usr
42
43 You can also create a debian package of it:
44
45 $ dpkg-buildpackage -rfakeroot
46
47 Testing python-purple
48 ---------------------
49
50 Python-purple provides a client example (nullclient) which connects to a
51 Gtalk account and displays libpurple's debug messages. In order to execute it,
52 issue the following command:
53
54 $ LD_PRELOAD=/usr/lib/libpurple.so.0 python2.5 nullclient.py
55
56 It will ask for a username and then password. Insert it and it will
57 automatically connect to the given account.