En/http redirects

docs/advanced-guide/overriding-default/page.md

@@ -116,6 +116,33 @@ func listHandler(ctx *gofr.Context) (any, error) {
 }
 ```
 
+## HTTP Redirects
+
+GoFr allows redirecting HTTP requests to other URLs using the `response.Redirect` type.
+
+### Example
+
+```go
+package main
+
+import (
+	"gofr.dev/pkg/gofr"
+
+	"gofr.dev/pkg/gofr/http/response"
+)
+
+func main() {
+	app := gofr.New()
+
+	app.GET("/old-page", func(ctx *gofr.Context) (any, error) {
+		// Redirect to a new URL
+		return response.Redirect{URL: "https://example.com/new-page"}, nil
+	})
+
+	app.Run()
+}
+```
+
 ## Favicon.ico
 
 By default, GoFr load its own `favicon.ico` present in root directory for an application. To override `favicon.ico` user

pkg/gofr/http/responder.go

@@ -30,6 +30,7 @@ func (r Responder) Respond(data any, err error) {
 	statusCode, errorObj := r.determineResponse(data, err)
 
 	var resp any
+
 	switch v := data.(type) {
 	case resTypes.Raw:
 		resp = v.Data
@@ -47,6 +48,19 @@ func (r Responder) Respond(data any, err error) {
 		v.Render(r.w)
 
 		return
+	case resTypes.Redirect:
+		switch r.method {
+		case http.MethodPost, http.MethodPut, http.MethodPatch:
+			statusCode = http.StatusSeeOther // 303
+		default:
+			statusCode = http.StatusFound // 302 by default
+		}
+
+		r.w.Header().Set("Location", v.URL)
+		r.w.WriteHeader(statusCode)
+
+		return
+
 	default:
 		// handling where an interface contains a nullable type with a nil value.
 		if isNil(data) {

pkg/gofr/http/responder_test.go

@@ -348,3 +348,39 @@ func removeTemplateDir(t *testing.T) {
 
 	require.NoError(t, err)
 }
+
+func TestResponder_RedirectResponse_Post(t *testing.T) {
+	recorder := httptest.NewRecorder()
+	r := NewResponder(recorder, http.MethodPost)
+
+	// Set up redirect with specific URL and status code
+	redirectURL := "/new-location?from=start"
+	statusCode := http.StatusSeeOther // 303
+
+	redirect := resTypes.NewRedirect(redirectURL)
+
+	r.Respond(redirect, nil)
+
+	assert.Equal(t, statusCode, recorder.Code, "Redirect should set the correct status code")
+	assert.Equal(t, redirectURL, recorder.Header().Get("Location"),
+		"Redirect should set the Location header")
+	assert.Empty(t, recorder.Body.String(), "Redirect response should not have a body")
+}
+
+func TestResponder_RedirectResponse_Head(t *testing.T) {
+	recorder := httptest.NewRecorder()
+	r := NewResponder(recorder, http.MethodHead)
+
+	// Set up redirect with specific URL and status code
+	redirectURL := "/new-location?from=start"
+	statusCode := http.StatusFound // 302
+
+	redirect := resTypes.NewRedirect(redirectURL)
+
+	r.Respond(redirect, nil)
+
+	assert.Equal(t, statusCode, recorder.Code, "Redirect should set the correct status code")
+	assert.Equal(t, redirectURL, recorder.Header().Get("Location"),
+		"Redirect should set the Location header")
+	assert.Empty(t, recorder.Body.String(), "Redirect response should not have a body")
+}

pkg/gofr/http/response/redirect.go

@@ -0,0 +1,12 @@
+package response
+
+type Redirect struct {
+	URL string
+}
+
+// NewRedirect creates a redirect response with the specified URL and status code.
+func NewRedirect(url string) Redirect {
+	return Redirect{
+		URL: url,
+	}
+}