Merge branch 'master' into OpenAPI-integration

docs-site/content/docs/getting-started/axum-users.md

@@ -235,4 +235,4 @@ pub fn routes() -> Routes {
 ### Verdict
 
 * **A drop-in compatibility** - Loco uses Axum and keeps all of its building blocks intact so that you can just use your own existing Axum code with no efforts.
-* **Route metadata for free** - one gap that Axum routers has is the ability to describe the currently configured routes, which can be used for listing or automatic OpenAPI schema generation. Loco has a small metadata layer to suppor this. If you use `Routes` you get it for free, while all of the different signatures remain compatible with Axum router.
+* **Route metadata for free** - one gap that Axum routers has is the ability to describe the currently configured routes, which can be used for listing or automatic OpenAPI schema generation. Loco has a small metadata layer to support this. If you use `Routes` you get it for free, while all of the different signatures remain compatible with Axum router.

loco-new/tests/wizard/new.rs

@@ -151,6 +151,9 @@ fn test_combination(
         // Generate deployment nginx
         tester.run_generate(&vec!["deployment", "--kind", "docker"]);
 
+        // Generate deployment shuttle
+        tester.run_generate(&vec!["deployment", "--kind", "shuttle"]);
+
         if db.enable() {
             // Generate Model
             if !settings.auth {

src/controller/format.rs

@@ -20,6 +20,7 @@
 //!    format::json(Health { ok: true })
 //! }
 //! ```
+use std::convert::TryInto;
 
 use axum::{
     body::Body,
@@ -373,10 +374,23 @@ impl RenderBuilder {
     ///
     /// This function will return an error if IO fails
     pub fn redirect(self, to: &str) -> Result<Response> {
+        self.redirect_with_header_key(header::LOCATION, to)
+    }
+
+    /// Finalizes the HTTP response and redirects to a specified location using a dynamic header key.
+    ///
+    /// # Errors
+    ///
+    /// This function will return an error if IO fails
+    pub fn redirect_with_header_key<K>(self, key: K, to: &str) -> Result<Response>
+    where
+        K: TryInto<HeaderName>,
+        <K as TryInto<HeaderName>>::Error: Into<axum::http::Error>,
+    {
         Ok(self
             .response
             .status(StatusCode::SEE_OTHER)
-            .header(header::LOCATION, to)
+            .header(key, to)
             .body(Body::empty())?)
     }
 }
@@ -637,4 +651,14 @@ mod tests {
         assert_debug_snapshot!(response);
         assert_eq!(response_body_to_string(response).await, String::new());
     }
+
+    #[tokio::test]
+    async fn builder_redirect_with_custom_header_response() {
+        let response = render()
+            .redirect_with_header_key("HX-Redirect", "https://loco.rs")
+            .unwrap();
+
+        assert_debug_snapshot!(response);
+        assert_eq!(response_body_to_string(response).await, String::new());
+    }
 }

src/controller/snapshots/loco_rs__controller__format__tests__builder_redirect_with_custom_header_response.snap

@@ -0,0 +1,14 @@
+---
+source: src/controller/format.rs
+expression: response
+---
+Response {
+    status: 303,
+    version: HTTP/1.1,
+    headers: {
+        "hx-redirect": "https://loco.rs",
+    },
+    body: Body(
+        UnsyncBoxBody,
+    ),
+}