oxihttp — The COOLJAPAN Pure-Rust HTTP facade

oxihttp is the top-level façade for the OxiHTTP stack. A single dependency gives you a complete, Pure-Rust HTTP client and server, with a unified type surface re-exported from oxihttp-core, oxihttp-client, and oxihttp-server. Feature flags compose the stack: client and server are on by default; TLS, compression, WebSockets, Server-Sent Events, Tower integration, SOCKS5, and HTTP/3 are opt-in.

The entire stack is Pure Rust — no OpenSSL, no C/C++ libraries. TLS is provided by oxitls + rustls, compression by oxiarc-deflate, and HTTP/3 by oxiquic-h3. The crate is #![forbid(unsafe_code)], and ships a reqwest → OxiHTTP migration guide in its migration module.

Installation

[dependencies]
# Client + server (defaults)
oxihttp = "0.1.0"

# Client only
oxihttp = { version = "0.1.0", default-features = false, features = ["client"] }

# Server only
oxihttp = { version = "0.1.0", default-features = false, features = ["server"] }

# With HTTPS (client + server TLS)
oxihttp = { version = "0.1.0", features = ["tls"] }

# Everything
oxihttp = { version = "0.1.0", features = ["all"] }

Quick Start

Client

# async fn example() -> oxihttp::Result<()> {
let client = oxihttp::Client::builder().build()?;
let resp = client.get("http://example.com")?.send().await?;
println!("Status: {}", resp.status());
let body = resp.body_text().await?;
println!("Body: {body}");
# Ok(())
# }

Server

use oxihttp::{Server, Router, response};

# async fn example() -> oxihttp::Result<()> {
let router = Router::new()
    .get("/", |_req| async { response::text_response("Hello!") });

Server::bind("127.0.0.1:3000").serve(router).await?;
# Ok(())
# }

One-shot helpers

# async fn example() -> oxihttp::Result<()> {
let resp = oxihttp::get("http://example.com").await?;
let resp = oxihttp::post("http://example.com/x", "payload").await?;
# Ok(())
# }

Top-level entry points

Client functions (feature client)

For repeated requests, build and reuse a Client via Client::builder().

Misc

Re-exported types at crate root

From oxihttp-core (always available)

Body, PinnedBody, Bytes, BytesMut, ContentType, Cookie, CookieJar, SameSite, FormBody, MultipartBuilder, MultipartPart, HeaderMap, HeaderName, HeaderValue, HeaderMapExt, Method, StatusCode, Uri, UriExt, Version, OxiHttpError.

From oxihttp-client (feature client)

Client, ClientBuilder, RequestBuilder, Response, BodyStream, RedirectPolicy, RetryPolicy.

With feature tls: HttpsClient, OxiHttpsConnector, MaybeHttpsStream, RequestTlsConfig.

From oxihttp-server (feature server)

Server, ServerBuilder, Router, ServerRequest (the server's Request), CorsConfig, RateLimiter, and the response helper module.

With features tls + server: TlsConfig.

Module map

Prelude

use oxihttp::prelude::*;

Imports Bytes, HeaderMap, HeaderValue, Method, StatusCode, Uri, OxiHttpError, Result; plus Client and Response (feature client) and Router and Server (feature server).

Feature Flags

Migration from reqwest

The oxihttp::migration module documents how common reqwest patterns map onto OxiHTTP — client setup, GET/POST, JSON bodies, headers, and timeouts — to ease porting existing code to the Pure-Rust stack.

Architecture

OxiHTTP is layered:

            oxihttp  (this facade)
           /         \
 oxihttp-client     oxihttp-server
           \         /
            oxihttp-core  (shared types: Body, OxiHttpError, headers, cookies, …)

• oxihttp-core — foundational types shared by every layer.
• oxihttp-client — the HTTP client implementation.
• oxihttp-server — the HTTP server implementation.

License

Apache-2.0 — COOLJAPAN OU (Team Kitasan)