feat: add redirect handlers

crates/shared/src/core/engine.rs

@@ -5,14 +5,14 @@ use std::sync::Arc;
 
 use super::RouteHandler;
 use crate::{
-    server::{context::AppState, Method, Middlewares, NgynContext, NgynResponse, Routes},
+    server::{context::AppState, Method, NgynContext, NgynResponse},
     traits::{Middleware, NgynController, NgynInterpreter, NgynMiddleware, NgynModule},
 };
 
 #[derive(Default)]
 pub struct PlatformData {
-    routes: Routes,
-    middlewares: Middlewares,
+    routes: Vec<(String, Option<Method>, Box<crate::core::RouteHandler>)>,
+    middlewares: Vec<Box<dyn crate::traits::Middleware>>,
     interpreters: Vec<Box<dyn NgynInterpreter>>,
     state: Option<Arc<Box<dyn AppState>>>,
 }

crates/shared/src/core/handler.rs

@@ -1,11 +1,13 @@
 use std::{future::Future, pin::Pin};
 
+use http::{HeaderValue, StatusCode};
+
 use crate::server::{NgynContext, NgynResponse, ToBytes};
 
 /// Represents a handler function that takes in a mutable reference to `NgynContext` and `NgynResponse`.
-pub type Handler = dyn Fn(&mut NgynContext, &mut NgynResponse) + Send + Sync + 'static;
+pub(crate) type Handler = dyn Fn(&mut NgynContext, &mut NgynResponse) + Send + Sync + 'static;
 
-pub type AsyncHandler = Box<
+pub(crate) type AsyncHandler = Box<
     dyn for<'a, 'b> Fn(
             &'a mut NgynContext,
             &'b mut NgynResponse,
@@ -73,3 +75,48 @@ pub fn async_handler<S: ToBytes + 'static, Fut: Future<Output = S> + Send + 'sta
         })
     })
 }
+
+/// Create a not-implemented handler that returns a `501 Not Implemented` status code.
+///
+/// This is very similar to unimplemented! macro in Rust.
+pub fn not_implemented() -> Box<Handler> {
+    Box::new(|_ctx: &mut NgynContext, res: &mut NgynResponse| {
+        *res.status_mut() = StatusCode::NOT_IMPLEMENTED;
+    })
+}
+
+/// Redirects to a specified location with a `303 See Other` status code.
+pub fn redirect_to(location: &'static str) -> Box<Handler> {
+    Box::new(|_ctx: &mut NgynContext, res: &mut NgynResponse| {
+        res.headers_mut()
+            .insert("Location", HeaderValue::from_str(location).unwrap());
+        *res.status_mut() = StatusCode::SEE_OTHER;
+    })
+}
+
+/// Redirects to a specified location with a `307 Temporary Redirect` status code.
+pub fn redirect_temporary(location: &'static str) -> Box<Handler> {
+    Box::new(|_ctx: &mut NgynContext, res: &mut NgynResponse| {
+        res.headers_mut()
+            .insert("Location", HeaderValue::from_str(location).unwrap());
+        *res.status_mut() = StatusCode::TEMPORARY_REDIRECT;
+    })
+}
+
+/// Redirects to a specified location with a `301 Moved Permanently` status code.
+pub fn redirect_permanent(location: &'static str) -> Box<Handler> {
+    Box::new(|_ctx: &mut NgynContext, res: &mut NgynResponse| {
+        res.headers_mut()
+            .insert("Location", HeaderValue::from_str(location).unwrap());
+        *res.status_mut() = StatusCode::MOVED_PERMANENTLY;
+    })
+}
+
+/// Redirects to a specified location with a `302 Found` status code.
+pub fn redirect_found(location: &'static str) -> Box<Handler> {
+    Box::new(|_ctx: &mut NgynContext, res: &mut NgynResponse| {
+        res.headers_mut()
+            .insert("Location", HeaderValue::from_str(location).unwrap());
+        *res.status_mut() = StatusCode::FOUND;
+    })
+}

crates/shared/src/server/mod.rs

@@ -14,6 +14,3 @@ pub use transformer::{Body, Param, Query, Transducer, Transformer};
 
 pub type NgynRequest = http::Request<Vec<u8>>;
 pub type NgynResponse = http::Response<Full<Bytes>>;
-
-pub(crate) type Routes = Vec<(String, Option<Method>, Box<crate::core::RouteHandler>)>;
-pub(crate) type Middlewares = Vec<Box<dyn crate::traits::Middleware>>;