Fork of mainstream urllib3 but ahead of his time
Project description
urllib3.future is as BoringSSL is to OpenSSL but to urllib3 (except support is available!)
urllib3 is a powerful, user-friendly HTTP client for Python. urllib3.future goes beyond supported features while remaining mostly compatible. urllib3.future brings many critical features that are missing from the Python standard libraries:
- Thread safety.
- Connection pooling.
- Client-side SSL/TLS verification.
- File uploads with multipart encoding.
- Helpers for retrying requests and dealing with HTTP redirects.
- Support for gzip, deflate, brotli, and zstd encoding.
- HTTP/1.1, HTTP/2 and HTTP/3 support.
- Proxy support for HTTP and SOCKS.
- 100% test coverage.
urllib3 is powerful and easy to use:
>>> import urllib3
>>> resp = urllib3.request("GET", "https://httpbin.org/robots.txt")
>>> resp.status
200
>>> resp.data
b"User-agent: *\nDisallow: /deny\n"
>>> resp.version
20
Installing
urllib3.future can be installed with pip:
$ python -m pip install urllib3.future
⚠️ Installing urllib3.future shadows the actual urllib3 package (depending on installation order) and you should carefully weigh the impacts. The semver will always be like MAJOR.MINOR.9PP like 2.0.941, the patch node is always greater or equal to 900.
Support for bugs or improvements is served in this repository. We regularly sync this fork with the main branch of urllib3/urllib3.
Compatibility with downstream
You should always install the downstream project prior to this fork.
e.g. I want requests to be use this package.
python -m pip install requests
python -m pip install urllib3.future
| Package | Is compatible? | Notes |
|---|---|---|
| requests | ✅ | Invalid chunked transmission may raises ConnectionError instead of ChunkedEncodingError. Use of Session() is required to enable HTTP/3 support. |
| HTTPie | ✅ | Require plugin httpie-next to be installed or wont be able to upgrade to HTTP/3 (QUIC/Alt-Svc Cache Layer) |
| pip | 🛑 | Cannot use the fork because of vendored urllib3 v1.x |
| openapigenerator | ✅ | Simply patch generated setup.py requirement and replace urllib3 to urllib3.future |
Want to report an incompatibility? Open an issue in that repository. All projects that depends on listed compatible package should work as-is.
Documentation
urllib3.future has usage and reference documentation at urllib3future.readthedocs.io.
Contributing
urllib3.future happily accepts contributions.
Security Disclosures
To report a security vulnerability, please use the GitHub advisory disclosure form.
Sponsorship
If your company benefits from this library, please consider sponsoring its development.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for urllib3_future-2.1.900-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 7674200d2abb09e5aa30d92d974d01d2aece48d07554a42c44b174400055558f |
|
| MD5 | 6dbd96dbcfa8b3e87803fa91a33f5946 |
|
| BLAKE2b-256 | 726e78224cac7a57cc51ca8c35c4ab3749dc4a20960dc3bac5fa3832061138bc |
