pyreqwest 0.5.1

Powerful and fast Rust based HTTP client

---

pyreqwest - Powerful and fast Rust based HTTP client. Built on top of and inspired by reqwest.

Why

• No reinvention of the wheel - built on top of widely used reqwest and other Rust HTTP crates
• Secure and fast - no C-extension code, no Python code/dependencies, no unsafe code
• Ergonomic and easy to use - similar API as in reqwest, fully type-annotated
• Testing ergonomics - mocking included, can also connect into ASGI apps

Using this is a good choice when:

• You care about throughput and latency, especially in high concurrency scenarios
• You want a single solution to serve all your HTTP client needs

This is not a good choice when:

• You want a pure Python solution allowing debugging of the HTTP client internals
• You use alternative Python implementations or Python version older than 3.11

Features

• High performance, see notes and benchmarks
• Asynchronous and synchronous HTTP clients
• Customizable via middlewares and custom JSON serializers
• Ergonomic as reqwest
• HTTP/1.1 and HTTP/2 support (also HTTP/3 when it stabilizes)
• Mocking and testing utilities (can also connect to ASGI apps)
• Fully type-safe with Python type hints
• Full test coverage
• Free threading, see notes

Standard HTTP features you would expect

• HTTPS support (using rustls)
• Request and response body streaming
• Connection pooling
• JSON, URLs, Headers, Cookies etc. (all serializers in Rust)
• Automatic decompression (zstd, gzip, brotli, deflate)
• Automatic response decoding (charset detection)
• Multipart form support
• Proxy support
• Redirects
• Timeouts
• Authentication (Basic, Bearer)
• Cookie management

Quickstart

# uv add pyreqwest

from pyreqwest.client import ClientBuilder, SyncClientBuilder

async def example_async():
    async with ClientBuilder().error_for_status(True).build() as client:
        response = await client.get("https://httpbun.com/get").query({"q": "val"}).build().send()
        print(await response.json())        

def example_sync():
    with SyncClientBuilder().error_for_status(True).build() as client:
        print(client.get("https://httpbun.com/get").query({"q": "val"}).build().send().json())

Context manager usage is optional, but recommended. Also close() methods are available.

Documentation

See docs

See examples