h2x 0.3.0

h2x

h2x provides a wrapper around the h2 crate, offering additional functionality and utility functions for working with the HTTP/2 protocol.

It aims to simplify the usage of the h2 crate and provide a more ergonomic API for building HTTP/2 servers.

Goals

• Managing TCP connections
• TLS

If you only need HTTP/2 server and can't sacrifice any overhead this library is for you.

Getting Started

To use h2x in your Rust project, add it as a dependency in your Cargo.toml file:

[dependencies]
h2x = "0.3"

Example

You can run this example with: cargo run --example hello_world

use h2x::*;
use http::{Method, StatusCode};
use std::{fs, io::Result, ops::ControlFlow};

#[tokio::main]
async fn main() -> Result<()> {
    let addr = "127.0.0.1:4433";
    let cert = fs::read("examples/cert.pem")?;
    let key = fs::read("examples/key.pem")?;

    println!("Goto: https://{addr}");

    Server::bind(addr, &mut &*cert, &mut &*key).await.unwrap().serve(
        |addr| async move {
            println!("[{addr}] NEW CONNECTION");
            ControlFlow::Continue(Some(addr))
        },
        |_conn, addr, req, mut res| async move {
            match (&req.method, req.uri.path()) {
                (&Method::GET, "/") => res.write("<H1>Hello, World</H1>").await,
                _ => {
                    res.status = StatusCode::NOT_FOUND;
                    res.write(format!("{req:#?}")).await
                }
            };
        },
        |addr| async move { println!("[{addr}] CONNECTION CLOSE") },
    )
    .await;

    Ok(())
}

For more examples, see ./examples directory.