pycurl / INSTALL

Full commit
NOTE: You need Python and libcurl installed on your system to use or
build pycurl.  Some RPM distributions of curl/libcurl do not include
everything necessary to build pycurl, in which case you need to
install the developer specific RPM which is usually called curl-dev.


Assuming that distutils is installed (which it is by default on Python
versions greater than 1.5.2) build and install pycurl with the
following commands:

    (if necessary, become root)
    tar -zxvf pycurl-$VER.tar.gz
    cd pycurl-$VER
    python install

$VER should be substituted with the version number, e.g. 7.10.5.

Note that the installation script assumes that 'curl-config' can be
located in your path setting.  If curl-config is installed outside
your path or you want to force installation to use a particular
version of curl-config, use the '--curl-config' commandline option to
specify the location of curl-config.  Example:

    python install --curl-config=/usr/local/bin/curl-config

If libcurl is linked dynamically with pycurl, you may have to alter the
LD_LIBRARY_PATH environment variable accordingly.  This normally
applies only if there is more than one version of libcurl installed,
e.g. one in /usr/lib and one in /usr/local/lib.

Also, pycurl is known to trigger a GC related assert failure in the
Python interpreter.  We have not been able to track down and solve this
problem.  However, the problem seems to occur less frequently if the GC
support is disabled in pycurl.  Passing the optional commandline parameter
'--use-gc=0' to will build pycurl without the GC support enabled.

    python build --use-gc=0
    python install


To build pycurl for Python 1.5.2 without the distutils package, be
brave and manually tweak the Makefile in the 'src' directory to match
your installation (the default Makefile should work fine for older
RedHat distributions with Python 1.5.2).


When installing on Windows, you need to manually configure the path to
the curl source tree, specified with the CURL_DIR variable in the file
''.  The CURL_DIR variable can also be set using the
commandline option '--curl-dir' when invoking

    python install --curl-dir=c:\curl-7.10.5