Python Curl CFFI

CFFI bindings for libcurl.

Example Usage

import python_curl_cffi
from python_curl_cffi.curl_constants import CurlOpt
from StringIO import StringIO
buffer = StringIO()
c = python_curl_cffi.Curl()
c.setopt(CurlOpt.URL, 'http://www.onfry.com')
c.setopt(CurlOpt.WRITEDATA, buffer)
c.perform()
c.close()
body = buffer.getvalue()

API

Curl object:

• setopt(CurlOpt, value): Sets curl options as in curl_easy_setopt
• perform(): Performs curl request, as in curl_easy_perform
• getinfo(CurlInfo): Gets information in response after curl perform, as in curl_easy_getinfo
• close(): Closes and cleans up the curl object, as in curl_easy_cleanup

Enum values to be used with setopt and getinfo can be accessed from curl_constants module.

This library can act as a drop-in replacement for pycurl by calling the following monkey patch function

import python_curl_cffi
python_curl_cffi.patch_as_pycurl()

Installation

Unix

1. Install libcurl (e.g. apt-get install libcurl4-openssl-dev)
2. pip install git+https://multippt@bitbucket.org/multippt/python_curl_cffi.git

Windows (Python 2 64-bit)

Replace x64 with x86 for 32-bit versions of Python.

Compile libcurl:

1. Install Microsoft Visual C++ Compiler (MSVC 2008). https://www.microsoft.com/en-us/download/details.aspx?id=44266
2. git clone https://github.com/curl/curl.git
3. Open MSVC C++ Command Prompt (MSVC 2008). Subsequent commands to be executed in this command prompt.
4. Build libcurl. cd <path to curl repo>\winbuild\ && nmake /f Makefile.vc mode=static VC=9 MACHINE=x64
5. Set LIB environment variable (e.g. set LIB=<path to curl repo>\builds\libcurl-vc9-x64-release-static-ipv6-sspi-winssl\lib)
6. Set INCLUDE environment variable (e.g. set INCLUDE=<path to curl repo>\builds\libcurl-vc9-x64-release-static-ipv6-sspi-winssl\include)
7. pip install git+https://multippt@bitbucket.org/multippt/python_curl_cffi.git

Windows (Python 3 64-bit)

Replace x64 with x86 for 32-bit versions of Python.

Compile libcurl:

1. Install Microsoft Visual C++ Compiler (MSVC 2017+). https://www.visualstudio.com
2. git clone https://github.com/curl/curl.git
3. Open MSVC C++ Command Prompt. Subsequent commands to be executed in this command prompt.
4. Build libcurl. cd <path to curl repo>\winbuild\ && nmake /f Makefile.vc mode=static VC=14 MACHINE=x64
5. Set LIB environment variable (e.g. set LIB=<path to curl repo>\builds\libcurl-vc14-x64-release-static-ipv6-sspi-winssl\lib)
6. Set INCLUDE environment variable (e.g. set INCLUDE=<path to curl repo>\builds\libcurl-vc14-x64-release-static-ipv6-sspi-winssl\include)
7. pip install git+https://multippt@bitbucket.org/multippt/python_curl_cffi.git