Curl Object

Curl objects have the following methods:

close() -> None

Corresponds to curl_easy_cleanup in libcurl. This method is automatically called by pycurl when a Curl object no longer has any references to it, but can also be called explicitly.

perform() -> None

Corresponds to curl_easy_perform in libcurl.

reset() -> None

Corresponds to curl_easy_reset in libcurl.

setopt(option, value) -> None

Corresponds to curl_easy_setopt in libcurl, where option is specified with the CURLOPT_* constants in libcurl, except that the CURLOPT_ prefix has been removed. The type for value depends on the option, and can be either a string, integer, long integer, file objects, lists, or functions.

Example usage:

import pycurl
c = pycurl.Curl()
c.setopt(pycurl.URL, "http://www.python.org/")
c.setopt(pycurl.HTTPHEADER, ["Accept:"])
import StringIO
b = StringIO.StringIO()
c.setopt(pycurl.WRITEFUNCTION, b.write)
c.setopt(pycurl.FOLLOWLOCATION, 1)
c.setopt(pycurl.MAXREDIRS, 5)
c.perform()
print b.getvalue()
...

getinfo(option) -> Result

Corresponds to curl_easy_getinfo in libcurl, where option is the same as the CURLINFO_* constants in libcurl, except that the CURLINFO_ prefix has been removed. Result contains an integer, float or string, depending on which option is given. The getinfo method should not be called unless perform has been called and finished.

Example usage:

import pycurl
c = pycurl.Curl()
c.setopt(pycurl.URL, "http://sf.net")
c.setopt(pycurl.FOLLOWLOCATION, 1)
c.perform()
print c.getinfo(pycurl.HTTP_CODE), c.getinfo(pycurl.EFFECTIVE_URL)
...
--> 200 "http://sourceforge.net/"

errstr() -> String

Returns the internal libcurl error buffer of this handle as a string.

$Id: curlobject.html,v 1.15 2008/08/05 20:51:13 kjetilja Exp $