oxihttp-client — Pure-Rust HTTP client for the OxiHTTP stack

oxihttp-client is the HTTP client of the OxiHTTP stack. It provides a fluent, reqwest-style API over a pooled connection layer: connection pooling, redirect following, retry with exponential backoff, per-request timeouts, automatic cookie management (RFC 6265), a lightweight middleware chain, custom DNS resolution, HTTP/HTTPS CONNECT and SOCKS5 proxies, optional transparent decompression, and optional HTTP/3.

The client builds on hyper and hyper-util's legacy pooled client for the HTTP/1.1 and HTTP/2 transports; all shared types (OxiHttpError, Body, cookies, multipart, forms) come from oxihttp-core. TLS is optional and Pure Rust via oxitls + rustls/tokio-rustls (no OpenSSL); decompression is Pure Rust via oxiarc-deflate; HTTP/3 is Pure Rust via oxiquic-h3. The crate is #![forbid(unsafe_code)].

Installation

[dependencies]
# Plain HTTP only
oxihttp-client = "0.1.0"

# With HTTPS (Pure-Rust rustls/oxitls)
oxihttp-client = { version = "0.1.0", features = ["tls"] }

# Everything: TLS, decompression, SOCKS5, HTTP/3
oxihttp-client = { version = "0.1.0", features = ["tls", "decompression", "socks", "h3"] }

Quick Start

use oxihttp_client::Client;

# async fn example() -> Result<(), oxihttp_core::OxiHttpError> {
let client = Client::builder().build()?;

// Fluent request building
let resp = client
    .get("http://example.com")?
    .header("accept", "application/json")?
    .send()
    .await?;

assert_eq!(resp.status(), http::StatusCode::OK);
let body = resp.body_text().await?;
println!("{body}");
# Ok(())
# }

POST JSON and deserialize the response

use oxihttp_client::Client;

# async fn example() -> Result<(), oxihttp_core::OxiHttpError> {
#[derive(serde::Serialize)]
struct CreateUser { name: String }
#[derive(serde::Deserialize)]
struct User { id: u64 }

let client = Client::builder().build()?;
let user: User = client
    .post_json("http://example.com/users", &CreateUser { name: "Alice".into() })
    .await?;
println!("created id={}", user.id);
# Ok(())
# }

API Overview

Client<C> — the HTTP client

Cloneable and cheap to share. The default Client<HttpConnector> is HTTP-only; type aliases provide TLS- and resolver-backed variants (see below).

Client type aliases

HttpsClient extras (feature tls)

ClientBuilder

Construct with Client::builder() or ClientBuilder::new(). All setters are chainable.

RequestBuilder<C> — per-request builder

Returned by Client::get() etc. Terminal method is send().

Response

BodyStream implements futures_core::Stream<Item = Result<Bytes, OxiHttpError>>.

RedirectPolicy (redirect module)

Free functions: is_redirect_status(StatusCode), redirect_method(StatusCode, &Method) (301–303 demote POST→GET), should_preserve_body(StatusCode) (307/308 only).

RetryPolicy (retry module)

Public fields: max_retries, backoff_base, backoff_max, retryable_status_codes, retry_on_connection_error, retry_on_timeout. Default retries 3 times.

Http2Settings (client_builder module)

A Default struct of optional HTTP/2 knobs: initial_stream_window_size, initial_connection_window_size, adaptive_window, keep_alive_interval, keep_alive_timeout, max_frame_size, max_concurrent_reset_streams, max_send_buf_size.

Middleware (middleware module)

Custom DNS (resolver module)

Proxies (proxy module)

TLS types (feature tls)

HTTP/3 (feature h3, h3 module)

A thin wrapper over oxiquic-h3.

Feature Flags

Error type

All fallible APIs return oxihttp_core::OxiHttpError. See the oxihttp-core README for the full variant table; the client most commonly produces Hyper, Io, Timeout, Redirect, Tls, Dns, ConnectionPool, Body, Json, InvalidHeader, InvalidUri, and (HTTP/3) H3.

Related crates

• oxihttp — the unified facade re-exporting this client.
• oxihttp-core — shared types (OxiHttpError, Body, cookies, multipart, forms).
• oxihttp-server — the matching HTTP server.

License

Apache-2.0 — COOLJAPAN OU (Team Kitasan)