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,AsyncClientorrequests.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=...)orverify=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=orstream=Truein requests - Streaming uploads · binary file as
content=inClientordata=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'sCURLOPT_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
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.