Module client 

Available on crate features dns and http-backend and http and std and tcp only.

rama http client support

Contains re-exports from rama-http-backend::client and adds EasyHttpWebClient, an opiniated http web client which supports most common use cases and provides sensible defaults.

Modules

builder

proxy

Client Http Proxy Connector Support.

Structs

BindBodyToConn

A connection wrapper that binds the connection to the lifetime of the response body it produces.

BindBodyToConnLayer

Layer that wraps a connector’s connection in BindBodyToConn.

BindBodyToConnector

Connector produced by BindBodyToConnLayer: wraps each established connection in BindBodyToConn.

BlockingBody

A blocking HTTP response body.

BlockingHttpClient

A cloneable blocking boundary around an asynchronous HTTP service.

BlockingResponse

An HTTP response with a blocking body reader and an attached runtime lease.

EasyHttpConnectorBuilder

Builder that is designed to easily create a connector for super::EasyHttpWebClient from most basic use cases

EasyHttpWebClient

An opiniated http client that can be used to serve HTTP requests.

Http3Connector

Establish authenticated QUIC transports for the common HTTP handshake.

Http3ConnectorBuilder

Configure an HTTP/3 connector, including its reusable UDP endpoint.

Http3Transport

An established QUIC transport and the HTTP/3 settings to apply during handshake.

HttpClientService

Internal http sender used to send the actual requests.

HttpConnId

Connection identity produced by HttpConnIdentifier.

HttpConnIdentifier

HTTP connection-pool identifier derived from the network route, any version requirement that constrains the physical connection, and whether plaintext HTTP uses forward-proxy or CONNECT-tunnel semantics.

HttpConnectRequestAdapter

Adapt an HTTP Request to a protocol-independent ConnectRequest.

HttpConnectRequestAdapterLayer

Layer that adapts HTTP requests to protocol-independent connection inputs.

HttpConnector

A Service which establishes an HTTP Connection.

HttpConnectorLayer

A Layer that produces an HttpConnector.

HttpPooledConnectorConfig

Config used to create a multiplexing http connection pool (MultiplexPool).

HttpTransportConnector

Select a stream or QUIC transport before the common HTTP handshake. Each connector owns its transport capabilities, including proxy support.

MaybeProxiedConnectionsocks5

A connection which will be proxied if a proxied ProxyRoute was configured.

ProxyConnectorsocks5

Proxy connector which supports http(s) and socks5(h) proxy address

ProxyConnectorLayersocks5

Proxy connector layer which supports http(s) and socks5(h) proxy address

Enums

HttpTransport

The transport on which the common HTTP connector performs its handshake.

Traits

IntoHttpTransport

Convert an established transport into the HTTP handshake’s transport types. Ordinary byte-stream connectors are supported without an adapter.

Functions

http2_eager_handshake

Establish an HTTP/2 connection on the pre-established IO (bytes) stream without a triggering request, and return both the HttpClientService and a H2PeerSettingsHandle that resolves to the peer’s initial SETTINGS frame once received.

http_connect

Perform the HTTP handshake on an established byte stream or QUIC transport. The selected protocol must agree with the transport; metadata remains attached to the resulting service for pooling and request adaptation. The input’s protocol distinguishes secure origins without inferring TLS from a port. Custom secure transports must publish ConnectionReuse to enable pooling.

Type Aliases

BlockingHttpWebClient

A blocking HTTP(S) client using Rama’s default pooled web connector stack.

DefaultHttpWebClient

Rama’s default asynchronous HTTP(S) client, including its default multiplexing connection pool.

HttpPooledConnector

Default HTTP pooled connector assembled by HttpPooledConnectorConfig::build_connector.