pydoc > pycurl

📚 NAME

pycurl — This module implements an interface to the cURL library.

🚀 Quick Reference

Use Case Command Description
Create a new Curl handle c = pycurl.Curl() Create a new curl object.
Perform a GET request c.setopt(pycurl.URL, url); c.perform() Perform a file transfer.
Set custom HTTP headers c.setopt(pycurl.HTTPHEADER, ["Accept: text/html"]) Set custom HTTP headers.
Perform a POST request c.setopt(pycurl.POST, 1); c.setopt(pycurl.POSTFIELDS, "key=val") Set POST method and body.
Handle response body c.setopt(pycurl.WRITEFUNCTION, callback) Set callback to receive response data.
Get response info c.getinfo(pycurl.HTTP_CODE) Retrieve transfer information.
Multi-request (parallel transfers) m = pycurl.CurlMulti(); m.add_handle(c) Perform multiple transfers in parallel.
Share data between handles s = pycurl.CurlShare(); s.setopt(pycurl.SH_SHARE, pycurl.LOCK_DATA_COOKIE) Share cookies, DNS, SSL sessions between handles.
Clean up c.close() Close handle and end curl session.

📖 DESCRIPTION

🔧 Types

Curl() -> New object.  Create a new curl object.
CurlMulti() -> New object.  Create a new curl multi object.
CurlShare() -> New object.  Create a new curl share object.

⚙️ Functions

global_init(option) -> None.  Initialize curl environment.
global_cleanup() -> None.  Cleanup curl environment.
version_info() -> tuple.  Return version information.

📦 CLASSES

builtins.Exception(builtins.BaseException) → error

builtins.object → Curl, CurlMulti, CurlShare

🔗 Curl

Curl() -> New Curl object

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.

Methods

Static methods: __new__(*args, **kwargs) — Create and return a new object.

🔗 CurlMulti

CurlMulti() -> New CurlMulti object

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

Methods

Static methods: __new__(*args, **kwargs).

🔗 CurlShare

CurlShare() -> New CurlShare object

Creates a new CurlShare object which corresponds to a CURLSH handle in libcurl. Used to share data between Curl objects via the SHARE option.

Methods

Static methods: __new__(*args, **kwargs).

⚠️ error

class error(builtins.Exception)

Exception class for pycurl errors. Inherits from builtins.Exception.

Methods inherited from builtins.Exception: __init__, __new__.

Methods inherited from builtins.BaseException: __delattr__, __getattribute__, __reduce__, __repr__, __setattr__, __setstate__, __str__, with_traceback.

Data descriptors inherited from builtins.BaseException: __cause__, __context__, __dict__, __suppress_context__, __traceback__, args.

🔧 FUNCTIONS

global_cleanup

global_cleanup() -> None

Cleanup curl environment. Corresponds to curl_global_cleanup in libcurl.

global_init

global_init(option) -> None

Initialize curl environment. option is one of pycurl.GLOBAL_SSL, pycurl.GLOBAL_WIN32, pycurl.GLOBAL_ALL, pycurl.GLOBAL_NOTHING, pycurl.GLOBAL_DEFAULT. Corresponds to curl_global_init.

version_info

version_info() -> tuple

Returns a 12-tuple with version information. Corresponds to curl_version_info in libcurl. Example:

>>> 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)

📊 DATA

📁 FILE

/usr/lib/python3/dist-packages/pycurl.cpython-310-x86_64-linux-gnu.so

pycurl
📚 NAME 🚀 Quick Reference 📖 DESCRIPTION
🔧 Types ⚙️ Functions
📦 CLASSES
🔗 Curl 🔗 CurlMulti 🔗 CurlShare ⚠️ error
🔧 FUNCTIONS
global_cleanup global_init version_info
📊 DATA 📁 FILE

Generated by phpman v4.10.0-7-g98e9fd5 · Markdown · JSON · MCP Author: Che Dong Under GNU General Public License
2026-09-01 16:57 @216.73.216.239
CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
Valid XHTML 1.0 Transitional!Valid CSS!

^_top_^