Skip to main content

curlyshed

A Python HTTP client on top of libcurl with blocking and asyncio APIs, streaming responses and an optional requests compatibility layer.

Install

uv add curlyshed

curlyshed 0.1 is an alpha and requires Python 3.14+, PycURL 7.48+ and libcurl 8.16+. PycURL wheels bundle libcurl on supported platforms. Building PycURL from source requires libcurl development files and a C compiler.

Quick start

from curlyshed import http

with http.Client() as client:
    response = client.get("https://httpbingo.org/get", params={"q": "honey"})
    response.raise_for_status()
    print(response.json())

Use http.AsyncClient with async with and await for concurrent requests. Existing requests code can opt in with from curlyshed import requests. The upstream suite passes 272 of 366 tests. See the compatibility report.

HTTP features

  • HTTP/1.1 · ClientConfig(http_version="1.1")
  • HTTP/2 · ClientConfig(http_version="2")
  • HTTP/3 / QUIC · ClientConfig(http_version="3")
  • Connection reuse · reuse a Client, AsyncClient or requests.Session
  • HTTP/2 multiplexing · concurrent requests on one AsyncClient
  • Alt-Svc · ClientConfig(alt_svc=True)
  • Redirects · follow_redirects=, ClientConfig(max_redirects=...)
  • Cookies · ClientConfig(cookies=True)
  • Response decompression · decode=True (default)
  • HTTP(S) and SOCKS proxies · proxy environment variables or proxies= in requests
  • Custom CA bundle · ClientConfig(ca_bundle=...) or verify= in requests
  • TLS client certificates · cert= in requests
  • Basic and Digest authentication · auth= in requests
  • Range requests, conditional requests and Bearer auth · headers=
  • Streaming downloads · stream(), output= or stream=True in requests
  • Streaming uploads · binary file as content= in Client or data= in requests
  • Multipart uploads · files= in requests
  • Custom methods and URLs · request(method, ...), URL, params=
  • Transfer limits · ClientConfig(connect_timeout=..., timeout=..., total_timeout=..., max_body_size=...)
  • Verbose transfer trace · ClientConfig(trace=True)
  • Strict HTTP versions and cleartext HTTP/2 · --http3-only, --http2-prior-knowledge, --http1.0
  • DNS and connection routing · --doh-url, --resolve, --connect-to, --interface, -4, -6
  • TLS version and cipher selection · --tlsv1.2, --tls-max, --ciphers, --tls13-ciphers
  • Public-key pinning, OCSP and HSTS · --pinnedpubkey, --cert-status, --hsts
  • Automatic download resume and ETag files · --continue-at -, --etag-save, --etag-compare
  • Bandwidth limiting and progress reporting · --limit-rate, libcurl's CURLOPT_XFERINFOFUNCTION
  • Persistent cookie and Alt-Svc caches · --cookie-jar, --alt-svc <file>
  • NTLM, Negotiate and automatic auth selection · --ntlm, --negotiate, --anyauth
  • Separate proxy headers, proxy chaining and HTTPS proxy TLS settings · --proxy-header, --preproxy, --proxy-cacert
  • Streaming uploads in AsyncClient · file or async iterator as a request body

See the guide for examples and use python -m curlyshed to check your libcurl build.

Benchmarks

Async HTTP benchmark with 50 concurrent requests on Python 3.14, led by curlyshed at 12,713 requests per second

Results, raw measurements and reproduction instructions

License

EUPL-1.2. The vendored requests test suite is Apache-2.0.

Metadata

Release files for curlyshed 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for curlyshed 0.1.0
File Size Uploaded Provenance Actions
curlyshed-0.1.0.tar.gz 54.3 kB Without provenance Details for curlyshed-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for curlyshed 0.1.0
File Interpreter ABI Platform Actions
curlyshed-0.1.0-py3-none-any.whl Python 3 none any Details for curlyshed-0.1.0-py3-none-any.whl

Total release size: 116.3 kB

Release files / curlyshed-0.1.0.tar.gz

Download URL curlyshed-0.1.0.tar.gz
Size 54.3 kB
Tags Source
SHA-256 checksum
How to use checksums
014bcfe8430bff8338b52cff5abb68f7d7f66ec776c1c2bb7a9226378c62d497
BLAKE2b-256 checksum
How to use checksums
6c4bf0daaf457e12d56bf2445140ba7382df8c274efc955acbe1569011667e1e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Fedora Linux","version":"45","id":"","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / curlyshed-0.1.0-py3-none-any.whl

Download URL curlyshed-0.1.0-py3-none-any.whl
Size 62.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4f7bc7482843ce34f902dfb77bff2f7a172c481f21f6c4c20c103aed1e2eb7cd
BLAKE2b-256 checksum
How to use checksums
88b9df45219e607da8c29477e2fdeac37445ed02da9409cd787abfe539df301e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Fedora Linux","version":"45","id":"","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for curlyshed 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page