libcurl-ct 8.12.1.4b1

Python binding for the libcurl C library.

libcurl-ct

Python binding for the libcurl C library.

Overview

Python libcurl-ct module is a low-level binding for libcurl C library.

It is an effort to allow python programs full access to the API implemented and provided by the well known *libcurl* library.

PyPI record.

Documentation.

libcurl-ct is a lightweight Python package, based on the ctypes library.

It is fully compliant implementation of the original C libcurl API by implementing whole its functionality in a clean Python instead of C.

libcurl API documentation can be found at:

libcurl API overview

libcurl-ct uses the underlying libcurl C shared library as specified in libcurl.cfg (included libcurl-X.X.* is the default), but there is also ability to specify it programmatically by one of the following ways:

import libcurl
libcurl.config(LIBCURL="libcurl C shared library absolute path")
# or
libcurl.config(LIBCURL=None)  # included libcurl-X.X.* will be use

About original libcurl:

Borrowed from the original website:

libcurl - the multiprotocol file transfer library

Overview

libcurl is a free and easy-to-use client-side URL transfer library, supporting DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, POP3, POP3S, RTMP, RTMPS, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET and TFTP.

libcurl supports SSL certificates, HTTP POST, HTTP PUT, FTP uploading, HTTP form based upload, proxies, HTTP/2, HTTP/3, cookies, user+password authentication (Basic, Digest, NTLM, Negotiate, Kerberos), file transfer resume, http proxy tunneling and more!

libcurl is highly portable, it builds and works identically on numerous platforms, including Solaris, NetBSD, FreeBSD, OpenBSD, Darwin, HPUX, IRIX, AIX, Tru64, Linux, UnixWare, HURD, Windows, Amiga, OS/2, BeOs, Mac OS X, Ultrix, QNX, OpenVMS, RISC OS, Novell NetWare, DOS and more…

libcurl is free, thread-safe, IPv6 compatible, feature rich, well supported, fast, thoroughly documented and is already used by many known, big and successful companies.

Requirements

• It is a fully independent package.

  All necessary things are installed during the normal installation process.

• ATTENTION: currently works and tested only for Windows.

Installation

Prerequisites:

• Python 3.9 or higher

  • https://www.python.org/

  • with C libcurl 8.12.1 is a primary test environment.

• pip and setuptools

  • https://pypi.org/project/pip/

  • https://pypi.org/project/setuptools/

To install run:

python -m pip install --upgrade libcurl-ct

Development

Prerequisites:

• Development is strictly based on tox. To install it run:

  python -m pip install --upgrade tox

Visit Development page.

Installation from sources:

clone the sources:

git clone https://github.com/karpierz/libcurl.git libcurl-ct

and run:

python -m pip install ./libcurl-ct

or on development mode:

python -m pip install --editable ./libcurl-ct

License

Copyright (c) 2021-2025 Adam Karpierz

Licensed under the MIT License

https://opensource.org/license/mit

Please refer to the accompanying LICENSE file.

Authors

• Adam Karpierz <[e-mail]>

Changelog

8.12.1.4b1 (2025-03-01)

• Add support for Python 3.12 and 3.13

• Drop support for Python 3.7 and 3.8

• Add support for PyPy 3.10 and 3.11

• Drop support for PyPy 3.7, 3.8 and 3.9

• Upgrade: libcurl v.7.84.0 -> v.8.12.1

• Bugfix for type of version_info_data.feature_names.

• Bugfix for write_to_fd.

• Previously unavailable obsoleted strequal() and strnequal()

  are curently available.
• Previously unavailable deprecated escape() and unescape()

  are curently available.
• Tox configuration has been moved to pyproject.toml

  and now based on tox >= 4.0

• Many bugs fixed.

• Copyright year update.

• 100% code linting.

• Cleanup.

• Setup (dependencies) update.

7.84.0a2 (2022-08-27)

• Upgrade: libcurl v.7.81.0 -> v.7.84.0

• Add support for Linux.

• Add support for Python 3.10 and 3.11

• Add support for PyPy 3.7, 3.8 and 3.9

• Added a performance util tests/sprinter.py

• Setup update (currently based mainly on pyproject.toml).

7.81.0a2 (2022-01-26)

• Rename PyPi package to libcurl-ct due to name conflict.

7.81.0a1 (2022-01-26)

• First release.

0.0.1 (2021-06-16)

• Initial release.