Crate tower_hyper_http_body_compat

source ·
Expand description

Adapters between hyper 0.14-1.0, http-body 0.4-1.0, and tower-service 0.3.

The required release candidates are:

  • hyper 1.0.0-rc.4
  • http-body 1.0.0-rc.2

Example

Running an axum Router with hyper 1.0:

use axum::{Router, routing::get};
use hyper::server::conn::http1;
use std::net::SocketAddr;
use tokio::net::TcpListener;
use tower_http::trace::TraceLayer;
use tower_hyper_http_body_compat::TowerService03HttpServiceAsHyper1HttpService;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
    let app = Router::new()
        .route("/", get(|| async { "Hello, World!" }))
        // we can still add regular tower middleware
        .layer(TraceLayer::new_for_http());

    // `Router` implements tower-service 0.3's `Service` trait. Convert that to something
    // that implements hyper 1.0's `Service` trait.
    let service = TowerService03HttpServiceAsHyper1HttpService::new(app);

    let addr: SocketAddr = ([127, 0, 0, 1], 8080).into();

    let mut tcp_listener = TcpListener::bind(addr).await?;
    loop {
        let (tcp_stream, _) = tcp_listener.accept().await?;

        // hyper-util isn't on crates.io yet. Instead depend on it via git
        // `hyper-util = { git = "https://github.com/hyperium/hyper-util" }`
        let tcp_stream = hyper_util::rt::TokioIo::new(tcp_stream);

        let service = service.clone();
        tokio::task::spawn(async move {
            if let Err(http_err) = http1::Builder::new()
                    .keep_alive(true)
                    .serve_connection(tcp_stream, service)
                    .await
            {
                eprintln!("Error while serving HTTP connection: {}", http_err);
            }
        });
    }
}

Note that this library doesn’t require axum. Its supports any tower::Service.

Feature flags

To enable the Service adapters you must enable either http1 or http2 and server or client (i.e. (http1 || http2) && (server || client)).

The Body adapters are always enabled.

Modules

Structs