feat: add query params to redirect response

litestar/response/redirect.py

@@ -1,7 +1,8 @@
 from __future__ import annotations
 
 import itertools
-from typing import TYPE_CHECKING, Any, Iterable, Literal
+from typing import TYPE_CHECKING, Any, Iterable, Literal, Sequence
+from urllib.parse import urlencode
 
 from litestar.constants import REDIRECT_ALLOWED_MEDIA_TYPES, REDIRECT_STATUS_CODES
 from litestar.enums import MediaType
@@ -13,6 +14,8 @@
 from litestar.utils.helpers import get_enum_string_value
 
 if TYPE_CHECKING:
+    from collections.abc import Mapping
+
     from litestar.app import Litestar
     from litestar.background_tasks import BackgroundTask, BackgroundTasks
     from litestar.connection import Request
@@ -94,6 +97,7 @@ def __init__(
         media_type: str | MediaType | None = None,
         status_code: RedirectStatusType | None = None,
         type_encoders: TypeEncodersMap | None = None,
+        query_params: Mapping[str, str | Sequence[str]] | None = None,
     ) -> None:
         """Initialize the response.
 
@@ -108,12 +112,16 @@ def __init__(
             status_code: An HTTP status code. The status code should be one of 301, 302, 303, 307 or 308,
                 otherwise an exception will be raised.
             type_encoders: A mapping of types to callables that transform them into types supported for serialization.
+            query_params: A dictionary of values from which the request's query will be generated.
 
         Raises:
             ImproperlyConfiguredException: Either if status code is not a redirect status code or media type is not
                 supported.
         """
-        self.url = path
+        if query_params is None:
+            self.url = path
+        else:
+            self.url = f"{path}?{urlencode(query_params, doseq=True)}"
         if status_code is None:
             status_code = HTTP_302_FOUND
         super().__init__(

tests/unit/test_response/test_redirect_response.py

@@ -107,6 +107,17 @@ def handler() -> Redirect:
         assert res.status_code == expected_status_code
 
 
+def test_redirect_with_query_params() -> None:
+    @get("/")
+    def handler() -> Redirect:
+        return Redirect(path="/something-else", query_params={"single": "a", "list": ["b", "c"]})
+
+    with create_test_client([handler]) as client:
+        location_header = client.get("/", follow_redirects=False).headers["location"]
+        expected = "/something-else?single=a&list=b&list=c"
+        assert location_header == expected
+
+
 @pytest.mark.parametrize("handler_status_code", [301, 307, None])
 def test_redirect(handler_status_code: Optional[int]) -> None:
     @get("/", status_code=handler_status_code)