Merge remote-tracking branch 'origin/pycurl' into planetlab-4_0-branch
[plcapi.git] / pycurl / INSTALL
1 NOTE: You need Python and libcurl installed on your system to use or
2 build pycurl.  Some RPM distributions of curl/libcurl do not include
3 everything necessary to build pycurl, in which case you need to
4 install the developer specific RPM which is usually called curl-dev.
5
6
7 Distutils
8 ---------
9
10 Assuming that distutils is installed (which it is by default on Python
11 versions greater than 1.5.2) build and install pycurl with the
12 following commands:
13
14     (if necessary, become root)
15     tar -zxvf pycurl-$VER.tar.gz
16     cd pycurl-$VER
17     python setup.py install
18
19 $VER should be substituted with the version number, e.g. 7.10.5.
20
21 Note that the installation script assumes that 'curl-config' can be
22 located in your path setting.  If curl-config is installed outside
23 your path or you want to force installation to use a particular
24 version of curl-config, use the '--curl-config' commandline option to
25 specify the location of curl-config.  Example:
26
27     python setup.py install --curl-config=/usr/local/bin/curl-config
28
29 If libcurl is linked dynamically with pycurl, you may have to alter the
30 LD_LIBRARY_PATH environment variable accordingly.  This normally
31 applies only if there is more than one version of libcurl installed,
32 e.g. one in /usr/lib and one in /usr/local/lib.
33
34
35 Windows
36 -------
37
38 When installing on Windows, you need to manually configure the path to
39 the curl source tree, specified with the CURL_DIR variable in the file
40 'setup.py'.  The CURL_DIR variable can also be set using the
41 commandline option '--curl-dir' when invoking setup.py:
42
43     python setup.py install --curl-dir=c:\curl-7.10.5
44