FogHTTP logo

FogHTTP

Rust-powered HTTP client for Python with sync and asyncio APIs.

FogHTTP is an early MVP HTTP client. The public API is Python-first, while the transport core is implemented in Rust on top of hyper.

FogHTTP is positioned as an observable, high-concurrency Rust-powered transport for Python services. It is built for controlled service-to-service HTTP workloads where explicit lifecycle, predictable resource usage, cancellation, redirect history, and request backpressure visibility matter more than browser-like feature parity.

Until version 0.5.0, backward compatibility is not guaranteed. I will still try to keep public interfaces stable and avoid unnecessary breaking changes.

Why FogHTTP

Rust hyper transport with a Python-first API
sync and asyncio clients with the same request model
explicit close()/aclose() lifecycle for Rust transport resources
graceful sync close() for in-flight requests and cancellable async requests
bounded global/per-origin request backpressure, FIFO pending-acquire limits, explicit HTTP/1.1 connection caps, and per-origin pressure diagnostics
typed telemetry event hooks with redacted request/response lifecycle events
versioned telemetry snapshots that separate alert-oriented stats from diagnostic dump APIs
opt-in async lifecycle debug snapshots for staging and tests
lazy process-wide shared Tokio runtime by default, opt-in dedicated runtime tuning, and fail-closed client ownership across fork()
focused HTTP surface for JSON, form, streaming upload, and multipart API workloads in internal services, workers, and benchmarks

Install

pip install foghttp

Runtime requirements:

Python >=3.11
orjson>=3.11,<4

Published CPython wheels use the stable cp311-abi3 ABI: each supported OS/architecture pair has one wheel for the currently validated GIL-enabled CPython 3.11 through 3.14 range. Newer Python versions are not part of the compatibility claim until they pass the same release checks. See Packaging and Python compatibility for the complete wheel matrix and validation policy.

Quick Start

import foghttp


with foghttp.Client(
    base_url="https://api.example.com",
    headers={"accept": "application/json"},
    params={"api-version": "1"},
) as client:
    response = client.get(
        "users",
        params={"limit": 10},
    )

    response.raise_for_status()
    print(response.status_code)
    print(response.json())

Async clients use the same request API:

import foghttp


async with foghttp.AsyncClient() as client:
    response = await client.post(
        "https://api.example.com/users",
        json={"name": "Ada Lovelace"},
    )
    response.raise_for_status()

What Works Today

sync Client and async AsyncClient
GET, HEAD, POST, PUT, PATCH, DELETE, and RFC 10008 QUERY
base_url for reusable API clients and relative request paths
default client headers and query params for reusable API clients
query params with repeated keys, JSON, form-urlencoded data, buffered bytes/text bodies, binary file-like request bodies, and streaming bytes-like upload providers
multipart files= uploads with bytes-like parts, binary file-like objects, direct byte streams, and replayable byte-stream factories
buffered Response with status flags, charset-aware text, json(), raise_for_status(), and request metadata
transparent gzip, deflate, and br decoding for buffered responses
sync and async bytes/text/line response streaming with explicit context-managed lifecycle
prepared Request objects with build_request() and send()
immutable request extensions for policy/application metadata outside the HTTP message
case-insensitive Headers with repeated values
safe policy for transport-managed request headers
redacted repr/error surfaces for sensitive headers, URL credentials, token-like URL params, and buffered body bytes
normalized URL model with origin comparison and relative joins
GET/HEAD/POST/QUERY redirects with final URL, history, typed same-origin and cross-origin header policy, and no cross-origin body replay
HTTP proxy routing and HTTPS proxy CONNECT tunnelling through explicit proxy= or trust_env=True when the proxy endpoint uses http://
HTTPS with default WebPKI roots, explicit custom CA certificates, and custom-only CA trust
graceful sync close() that waits for in-flight sync requests
async request cancellation that aborts the in-flight Rust request
bounded global and per-origin request slots with a bounded FIFO pending queue
opt-in global/per-origin HTTP/1.1 connection caps with separate connection acquire pressure and idle lifecycle diagnostics
opt-in typed telemetry event hooks for request, redirect, response headers, response body, and request completion lifecycle
opt-in typed transport policy hooks for lightweight request admission and response-head checks without default-path Python callbacks
versioned telemetry snapshot metadata for stats(), dump_transport_state(), and dump_pool_diagnostics()
opt-in async lifecycle debug mode for active request snapshots, strict leak checks, and unclosed-client diagnostics
default per-response and aggregate buffered response body limits for memory safety
shared Tokio runtime by default, with opt-in dedicated runtime worker tuning
grouped HTTP status constants and reusable HTTP method constants

Documentation

Current Limitations

FogHTTP is currently focused on controlled HTTP workloads. Buffered responses are the broadest supported response path; sync and async response streaming are available as bytes/text/line context-managed APIs. Streaming content= uploads and multipart files= uploads are available with explicit replayability and cleanup rules. HTTP proxy routing and HTTPS proxy CONNECT tunnelling are available through proxy= and trust_env=True when the proxy endpoint itself uses http://. Cookies, auth helpers, HTTP/2, automatic Accept-Encoding negotiation, streaming decompression, and per-request connect timeout reconfiguration are planned for later versions. Physical connection caps currently apply to the HTTP/1.1 connector path; HTTP/2 will require separate stream-level limits. Response body read timeout is available for buffered and streaming response bodies; request body write timeout is available for buffered and streaming request bodies. Socket lifecycle telemetry is available for the current HTTP/1 path. Disabling TLS verification is intentionally not supported.

Development

Development requires a Rust toolchain with cargo available in PATH.

uv run --extra dev --with "maturin>=1.7,<2" maturin develop --locked --skip-install
uv run --extra dev coverage run -m pytest
uv run --extra dev coverage report -m
uv run --extra dev pre-commit run --all-files --show-diff-on-failure

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

foghttp-0.3.7.tar.gz (1.5 MB view details)

Uploaded Jul 13, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

foghttp-0.3.7-cp311-abi3-win_amd64.whl (2.0 MB view details)

Uploaded Jul 13, 2026 CPython 3.11+Windows x86-64

foghttp-0.3.7-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.4 MB view details)

Uploaded Jul 13, 2026 CPython 3.11+manylinux: glibc 2.17+ x86-64

foghttp-0.3.7-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.4 MB view details)

Uploaded Jul 13, 2026 CPython 3.11+manylinux: glibc 2.17+ ARM64

foghttp-0.3.7-cp311-abi3-macosx_11_0_arm64.whl (2.2 MB view details)

Uploaded Jul 13, 2026 CPython 3.11+macOS 11.0+ ARM64

foghttp-0.3.7-cp311-abi3-macosx_10_12_x86_64.whl (2.2 MB view details)

Uploaded Jul 13, 2026 CPython 3.11+macOS 10.12+ x86-64

File details

Details for the file foghttp-0.3.7.tar.gz.

File metadata

Download URL: foghttp-0.3.7.tar.gz
Upload date: Jul 13, 2026
Size: 1.5 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for foghttp-0.3.7.tar.gz
Algorithm	Hash digest
SHA256	`521f051b35e1cf6df91a1490b06c4e18a50517dbc795a92a9e76123d3ed99d1b`
MD5	`265e9eef5b2da2a7297533050a850a5b`
BLAKE2b-256	`c1865c2173cf93d41ac149f5967350db3206f29a6faf9004fb65d820f2a0a934`

See more details on using hashes here.

Provenance

The following attestation bundles were made for foghttp-0.3.7.tar.gz:

Publisher: release.yml on AmberFog/foghttp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: foghttp-0.3.7.tar.gz
- Subject digest: 521f051b35e1cf6df91a1490b06c4e18a50517dbc795a92a9e76123d3ed99d1b
- Sigstore transparency entry: 2165054019
- Sigstore integration time: Jul 13, 2026
Source repository:
- Permalink: AmberFog/foghttp@98fb7b75f769ca68614bae0262496b7bacf16442
- Branch / Tag: refs/tags/v0.3.7
- Owner: https://github.com/AmberFog
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@98fb7b75f769ca68614bae0262496b7bacf16442
- Trigger Event: release

File details

Details for the file foghttp-0.3.7-cp311-abi3-win_amd64.whl.

File metadata

Download URL: foghttp-0.3.7-cp311-abi3-win_amd64.whl
Upload date: Jul 13, 2026
Size: 2.0 MB
Tags: CPython 3.11+, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for foghttp-0.3.7-cp311-abi3-win_amd64.whl
Algorithm	Hash digest
SHA256	`4918d820cd949d09e0a5af1da6061450c05829feba496d01a41900ce1796d8c7`
MD5	`9c8dd40239446cd5e53bc49ed17e6aa4`
BLAKE2b-256	`6550c21394cc01f6273593ee34429f5ec9768f38cffca6cecc8542bd7db084a1`

See more details on using hashes here.

Provenance

The following attestation bundles were made for foghttp-0.3.7-cp311-abi3-win_amd64.whl:

Publisher: release.yml on AmberFog/foghttp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: foghttp-0.3.7-cp311-abi3-win_amd64.whl
- Subject digest: 4918d820cd949d09e0a5af1da6061450c05829feba496d01a41900ce1796d8c7
- Sigstore transparency entry: 2165054043
- Sigstore integration time: Jul 13, 2026
Source repository:
- Permalink: AmberFog/foghttp@98fb7b75f769ca68614bae0262496b7bacf16442
- Branch / Tag: refs/tags/v0.3.7
- Owner: https://github.com/AmberFog
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@98fb7b75f769ca68614bae0262496b7bacf16442
- Trigger Event: release

File details

Details for the file foghttp-0.3.7-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

Download URL: foghttp-0.3.7-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Upload date: Jul 13, 2026
Size: 2.4 MB
Tags: CPython 3.11+, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for foghttp-0.3.7-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm	Hash digest
SHA256	`8638504a8e3b82603f8b3f92d9ca93af4a9721c9a03daae9ee1565df4a1c349e`
MD5	`fea980f4c3c9409410ad73f330cf6038`
BLAKE2b-256	`23e518415aab83edf7765ab711de248bd14d9aaa79cd51713383c86c07497153`

See more details on using hashes here.

Provenance

The following attestation bundles were made for foghttp-0.3.7-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release.yml on AmberFog/foghttp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: foghttp-0.3.7-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Subject digest: 8638504a8e3b82603f8b3f92d9ca93af4a9721c9a03daae9ee1565df4a1c349e
- Sigstore transparency entry: 2165054135
- Sigstore integration time: Jul 13, 2026
Source repository:
- Permalink: AmberFog/foghttp@98fb7b75f769ca68614bae0262496b7bacf16442
- Branch / Tag: refs/tags/v0.3.7
- Owner: https://github.com/AmberFog
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@98fb7b75f769ca68614bae0262496b7bacf16442
- Trigger Event: release

File details

Details for the file foghttp-0.3.7-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

Download URL: foghttp-0.3.7-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Upload date: Jul 13, 2026
Size: 2.4 MB
Tags: CPython 3.11+, manylinux: glibc 2.17+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for foghttp-0.3.7-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm	Hash digest
SHA256	`cdec8d34e68426262d94d85e15235692b3e8a6100fd33e22ffbfdca4e7992d94`
MD5	`c02f9e8073fafb61f1756d6dc6b472d6`
BLAKE2b-256	`5a811d3aed9e58faeb965df8aca33efbd17afbb0e87c8d35235a750fdcc61749`

See more details on using hashes here.

Provenance

The following attestation bundles were made for foghttp-0.3.7-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: release.yml on AmberFog/foghttp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: foghttp-0.3.7-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
- Subject digest: cdec8d34e68426262d94d85e15235692b3e8a6100fd33e22ffbfdca4e7992d94
- Sigstore transparency entry: 2165054104
- Sigstore integration time: Jul 13, 2026
Source repository:
- Permalink: AmberFog/foghttp@98fb7b75f769ca68614bae0262496b7bacf16442
- Branch / Tag: refs/tags/v0.3.7
- Owner: https://github.com/AmberFog
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@98fb7b75f769ca68614bae0262496b7bacf16442
- Trigger Event: release

File details

Details for the file foghttp-0.3.7-cp311-abi3-macosx_11_0_arm64.whl.

File metadata

Download URL: foghttp-0.3.7-cp311-abi3-macosx_11_0_arm64.whl
Upload date: Jul 13, 2026
Size: 2.2 MB
Tags: CPython 3.11+, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for foghttp-0.3.7-cp311-abi3-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`0effdf3c47e75e92136dc6ec1d616103b14a04791f32bcbd9346283435f9239c`
MD5	`d919cc69ca55000c2998eb50278d8683`
BLAKE2b-256	`bd306e226304a9fe96cc967440a7043b77ee2698388d1e4899e857f1650da40a`

See more details on using hashes here.

Provenance

The following attestation bundles were made for foghttp-0.3.7-cp311-abi3-macosx_11_0_arm64.whl:

Publisher: release.yml on AmberFog/foghttp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: foghttp-0.3.7-cp311-abi3-macosx_11_0_arm64.whl
- Subject digest: 0effdf3c47e75e92136dc6ec1d616103b14a04791f32bcbd9346283435f9239c
- Sigstore transparency entry: 2165054083
- Sigstore integration time: Jul 13, 2026
Source repository:
- Permalink: AmberFog/foghttp@98fb7b75f769ca68614bae0262496b7bacf16442
- Branch / Tag: refs/tags/v0.3.7
- Owner: https://github.com/AmberFog
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@98fb7b75f769ca68614bae0262496b7bacf16442
- Trigger Event: release

File details

Details for the file foghttp-0.3.7-cp311-abi3-macosx_10_12_x86_64.whl.

File metadata

Download URL: foghttp-0.3.7-cp311-abi3-macosx_10_12_x86_64.whl
Upload date: Jul 13, 2026
Size: 2.2 MB
Tags: CPython 3.11+, macOS 10.12+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for foghttp-0.3.7-cp311-abi3-macosx_10_12_x86_64.whl
Algorithm	Hash digest
SHA256	`0708dd57c0c485aee31784e4b802e4fe1df3c75f0e3b6feabad37600f1b99ef6`
MD5	`35d491a0faa6713e218c17c6ed652917`
BLAKE2b-256	`3bbdc0cac7e3b57c37192a5a31bd403106c28924a82eab8f10530858ce5e276f`

See more details on using hashes here.

Provenance

The following attestation bundles were made for foghttp-0.3.7-cp311-abi3-macosx_10_12_x86_64.whl:

Publisher: release.yml on AmberFog/foghttp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: foghttp-0.3.7-cp311-abi3-macosx_10_12_x86_64.whl
- Subject digest: 0708dd57c0c485aee31784e4b802e4fe1df3c75f0e3b6feabad37600f1b99ef6
- Sigstore transparency entry: 2165054060
- Sigstore integration time: Jul 13, 2026
Source repository:
- Permalink: AmberFog/foghttp@98fb7b75f769ca68614bae0262496b7bacf16442
- Branch / Tag: refs/tags/v0.3.7
- Owner: https://github.com/AmberFog
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@98fb7b75f769ca68614bae0262496b7bacf16442
- Trigger Event: release