hyper-server

Crates.iohyper-server
lib.rshyper-server
version0.6.0
sourcesrc
created_at2023-10-11 21:37:42.437178
updated_at2023-10-14 00:32:28.020411
descriptionHigh level server for hyper and tower.
homepagehttps://github.com/valorem-labs-inc/hyper-server
repositoryhttps://github.com/valorem-labs-inc/hyper-server
max_upload_size
id1000704
size198,295
Alcibiades (0xAlcibiades)

documentation

README

License Crates.io Docs CI codecov

hyper-server

hyper-server is a high performance hyper server implementation designed to work with axum, tonic and tower.

Features

  • HTTP/1 and HTTP/2
  • HTTPS through rustls and openssl.
  • High performance through hyper.
  • Using tower make service API.
  • Exceptional axum compatibility. Likely to work with future axum releases.
  • Superb tonic compatibility. Likely to work with future tonic releases.
  • Proxy protocol support for use behind network load balancers

Usage Example

A simple hello world application can be served like:

use axum::{routing::get, Router};
use std::net::SocketAddr;

#[tokio::main]
async fn main() {
    let app = Router::new().route("/", get(|| async { "Hello, world!" }));

    let addr = SocketAddr::from(([127, 0, 0, 1], 3000));
    println!("listening on {}", addr);
    hyper_server::bind(addr)
        .serve(app.into_make_service())
        .await
        .unwrap();
}

You can find more examples here.

Minimum Supported Rust Version

hyper-server's MSRV is 1.65.

Safety

This crate uses #![forbid(unsafe_code)] to ensure everything is implemented in 100% safe Rust.

License

This project is licensed under the MIT license.

Why fork

This project is based on the great work in axum-server, which is no longer actively maintained. The rationale for forking is that we use this for critical infrastructure and want to be able to extend the crate and fix bugs as needed.

Commit count: 129

cargo fmt