/libcurl-ct

Primary LanguagePythonMIT LicenseMIT

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:

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-2022 Adam Karpierz
Licensed under the MIT License
https://opensource.org/licenses/MIT
Please refer to the accompanying LICENSE file.

Authors