# pycurl Module Functionality

pycurl.global_init(option) → None

  Initialize curl environment.

  option is one of the constants pycurl.GLOBAL_SSL, pycurl.GLOBAL_WIN32, pycurl.GLOBAL_ALL, pycurl.GLOBAL_NOTHING, pycurl.GLOBAL_DEFAULT.

  Corresponds to curl_global_init in libcurl.

pycurl.global_cleanup() → None

  Cleanup curl environment.

  Corresponds to curl_global_cleanup in libcurl.

pycurl.version

  This is a string with version information on libcurl, corresponding to curl_version in libcurl.

  Example usage:

      >>> import pycurl
      >>> pycurl.version
      'PycURL/7.19.3 libcurl/7.33.0 OpenSSL/0.9.8x zlib/1.2.7'

pycurl.version_info() → tuple

  Returns a 12-tuple with the version info.

  Corresponds to curl_version_info in libcurl. Returns a tuple of information which is similar to the `curl_version_info_data` struct returned by `curl_version_info()` in libcurl.

  Example usage:

      >>> import pycurl
      >>> pycurl.version_info()
      (3, '7.33.0', 467200, 'amd64-portbld-freebsd9.1', 33436, 'OpenSSL/0.9.8x',
      0, '1.2.7', ('dict', 'file', 'ftp', 'ftps', 'gopher', 'http', 'https',
      'imap', 'imaps', 'pop3', 'pop3s', 'rtsp', 'smtp', 'smtps', 'telnet',
      'tftp'), None, 0, None)

class pycurl.Curl

  Creates a new Curl Object which corresponds to a `CURL` handle in libcurl. Curl objects automatically set CURLOPT_VERBOSE to 0, CURLOPT_NOPROGRESS to 1, provide a default CURLOPT_USERAGENT and setup CURLOPT_ERRORBUFFER to point to a private error buffer.

  Implicitly calls `pycurl.global_init()` if the latter has not yet been called.

class pycurl.CurlMulti

  Creates a new CurlMulti Object which corresponds to a `CURLM` handle in libcurl.

class pycurl.CurlShare

  Creates a new CurlShare Object which corresponds to a `CURLSH` handle in libcurl. CurlShare objects is what you pass as an argument to the SHARE option on Curl objects.