General Upgrade, NEW: WebServers, Better Docs

example/webserver/Cargo.toml

@@ -0,0 +1,10 @@
+[package]
+name = "mtp-webserver-example"
+version = "0.2.0"
+edition = "2024"
+publish = false
+
+[dependencies]
+http = "1"
+mtp = { path = "../..", features = ["web-server"] }
+tokio = { version = "1", features = ["full"] }

example/webserver/src/main.rs

@@ -0,0 +1,38 @@
+use http::StatusCode;
+use mtp::{
+    host::HostConfig,
+    webserver::{Http3Request, Http3Response, MTPWebServer, WebServerConfig},
+};
+
+async fn health(_request: Http3Request, response: Http3Response) -> Http3Response {
+    response
+        .status(StatusCode::OK)
+        .header("content-type", "application/json")
+        .body(r#"{"status":"ok"}"#)
+}
+
+#[tokio::main]
+async fn main() -> Result<(), Box<dyn std::error::Error>> {
+    let config = HostConfig::new(
+        "0.0.0.0".parse()?,
+        4433,
+        std::fs::read("cert.pem")?,
+        std::fs::read("key.pem")?,
+    );
+    let web = WebServerConfig::new().route("/health", health)?.mtp_path("/mtp");
+    let mut server = MTPWebServer::new(config, web).await?;
+    println!("listening on {}", server.local_addr());
+
+    while let Some(connection) = server.accept().await? {
+        println!(
+            "MTP client connected: path={}, version={}, description={:?}",
+            connection.path, connection.version, connection.description
+        );
+        tokio::spawn(async move {
+            while let Ok(message) = connection.receiver.receive().await {
+                println!("received MTP message {}", message.get_id());
+            }
+        });
+    }
+    Ok(())
+}