Add support for Salvo (#476)

* feat: add salvo support

* fix: add http dep for salvo

* fix: remove micro optimisation

Co-authored-by: Chris Wong <lambda.fairy@gmail.com>

---------

Co-authored-by: Chris Wong <lambda.fairy@gmail.com>

Author: arnu515

docs/content/web-frameworks.md

@@ -1,6 +1,6 @@
 # Web framework integration
 
-Maud includes support for these web frameworks: [Actix], [Rocket], [Rouille], [Tide], [Axum] and [Poem].
+Maud includes support for these web frameworks: [Actix], [Rocket], [Rouille], [Tide], [Axum], [Poem], and [Salvo].
 
 [Actix]: https://actix.rs/
 [Rocket]: https://rocket.rs/
@@ -10,6 +10,7 @@ Maud includes support for these web frameworks: [Actix], [Rocket], [Rouille], [T
 [Warp]: https://seanmonstar.com/blog/warp/
 [Submillisecond]: https://github.com/lunatic-solutions/submillisecond
 [Poem]: https://github.com/poem-web/poem
+[Salvo]: https://salvo.rs
 
 # Actix
 
@@ -268,3 +269,38 @@ async fn main() -> Result<(), std::io::Error> {
         .await
 }
 ```
+
+# Salvo
+
+Salvo support is available with the "salvo" feature:
+
+```toml
+# ...
+[dependencies]
+maud = { version = "*", features = ["salvo"] }
+# ...
+```
+
+This adds an implementation of `Scribe` for `Markup`/`PreEscaped<String>`.
+This then allows you to use it directly as a response!
+
+```rust,no_run
+use maud::{html, Markup};
+use salvo::prelude::*;
+
+#[handler]
+async fn hello_world(res: &mut Response) {
+    res.render(html! {
+        h1 { "Hello, World!" }
+    });
+}
+
+#[tokio::main]
+async fn main() {
+    let app = Router::with_path("/").get(hello_world);
+
+    let listener = TcpListener::new("0.0.0.0:3000").bind().await;
+
+    Server::new(listener).serve(app).await;
+}
+```

doctest/Cargo.toml

@@ -7,7 +7,7 @@ edition = "2021"
 [dependencies]
 actix-web = { version = "4.0.0-rc.2", default-features = false, features = ["macros"] }
 ammonia = "3"
-maud = { path = "../maud", features = ["actix-web", "rocket", "tide", "axum", "warp", "submillisecond", "poem"] }
+maud = { path = "../maud", features = ["actix-web", "rocket", "tide", "axum", "warp", "submillisecond", "poem", "salvo"] }
 pulldown-cmark = "0.8"
 rocket = "0.5"
 rouille = "3"
@@ -17,6 +17,7 @@ tokio = { version = "1.9.0", features = ["rt", "macros", "rt-multi-thread"] }
 axum = "0.8"
 warp = "0.3.6"
 poem = "3"
+salvo = "0.78.0"
 
 [dependencies.async-std]
 version = "1.9.0"

maud/Cargo.toml

@@ -20,6 +20,7 @@ default = []
 # Web framework integrations
 actix-web = ["actix-web-dep", "futures-util"]
 axum = ["axum-core", "http"]
+salvo = ["salvo_core", "http"]
 
 [dependencies]
 maud_macros = { version = "0.27.0", path = "../maud_macros" }
@@ -33,6 +34,7 @@ submillisecond = { version = "0.4.1", optional = true }
 http = { version = "1", optional = true }
 warp = { version = "0.3.6", optional = true }
 poem = { version = "3", optional = true }
+salvo_core = { version = "0.78.0", optional = true }
 
 [dev-dependencies]
 trybuild = { version = "1.0.33", features = ["diff"] }

maud/src/lib.rs

@@ -424,6 +424,24 @@ mod submillisecond_support {
     }
 }
 
+#[cfg(feature = "salvo")]
+mod salvo_support {
+    use crate::PreEscaped;
+    use alloc::string::String;
+    use http::{header::CONTENT_TYPE, HeaderValue};
+    use salvo_core::{http::Response, writing::Scribe};
+
+    impl Scribe for PreEscaped<String> {
+        fn render(self, res: &mut Response) {
+            let _ = res.headers.insert(
+                CONTENT_TYPE,
+                HeaderValue::from_static("text/html; charset=utf-8"),
+            );
+            let _ = res.write_body(self.into_string());
+        }
+    }
+}
+
 #[doc(hidden)]
 pub mod macro_private {
     use crate::{display, Render};