feat: add Redirect and deprecate new_redirect

Author: seqre

cot/src/response.rs

@@ -125,6 +125,7 @@ pub trait ResponseExt: Sized + private::Sealed {
     /// * [`crate::reverse_redirect!`] – a more ergonomic way to create
     ///   redirects to internal views
     #[must_use]
+    #[deprecated(since = "0.5.0", note = "Use Redirect::new() instead")]
     fn new_redirect<T: Into<String>>(location: T) -> Self;
 }
 
@@ -144,6 +145,58 @@ impl ResponseExt for Response {
     }
 }
 
+/// A redirect response.
+///
+/// This type creates an HTTP redirect response with a status code of
+/// [`StatusCode::SEE_OTHER`] (303) and a `Location` header set to the
+/// specified URL.
+///
+/// # Examples
+///
+/// ```
+/// use cot::response::{IntoResponse, Redirect};
+///
+/// let response = Redirect::new("https://example.com");
+///
+/// assert_eq!(response.status(), cot::StatusCode::SEE_OTHER);
+/// ```
+///
+/// # See also
+///
+/// * [`crate::reverse_redirect!`] – a more ergonomic way to create redirects to
+///   internal views
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub struct Redirect;
+
+impl Redirect {
+    /// Creates a new redirect response to the specified location.
+    ///
+    /// The location can be any type that implements `Into<String>`, such as
+    /// `&str`, `String`, or other string-like types.
+    ///
+    /// # Panics
+    ///
+    /// Panics if the provided location does not cast into
+    /// [`http::HeaderValue`].
+    ///
+    /// # Examples
+    ///
+    /// ```
+    /// use cot::response::Redirect;
+    ///
+    /// let redirect = Redirect::new("/login");
+    /// ```
+    #[must_use]
+    #[expect(clippy::new_ret_no_self)]
+    pub fn new<T: Into<String>>(location: T) -> Response {
+        http::Response::builder()
+            .status(StatusCode::SEE_OTHER)
+            .header(http::header::LOCATION, location.into())
+            .body(Body::empty())
+            .expect(RESPONSE_BUILD_FAILURE)
+    }
+}
+
 #[cfg(test)]
 mod tests {
     use super::*;
@@ -179,6 +232,7 @@ mod tests {
     }
 
     #[test]
+    #[expect(deprecated)]
     fn response_new_redirect() {
         let location = "http://example.com";
         let response = Response::new_redirect(location);

cot/src/router.rs

@@ -1022,7 +1022,7 @@ macro_rules! reverse_redirect {
             $request,
             $view_name,
             $( $($key = $value),* )?
-        ).map(|url| <$crate::response::Response as $crate::response::ResponseExt>::new_redirect(url))
+        ).map($crate::response::Redirect::new)
     };
 }