Updated example for redirects

Author: michalpokusa

docs/examples.rst

@@ -262,10 +262,13 @@ Sometimes you might want to redirect the user to a different URL, either on the
 You can do that by returning ``Redirect`` from your handler function.
 
 You can specify wheter the redirect is permanent or temporary by passing ``permanent=...``  to ``Redirect``.
+If you need the redirect to preserve the original request method, you can set ``preserve_method=True``.
+
+Alternatively, you can pass a ``status`` object directly to ``Redirect`` constructor.
 
 .. literalinclude:: ../examples/httpserver_redirects.py
     :caption: examples/httpserver_redirects.py
-    :emphasize-lines: 14-18,26,38
+    :emphasize-lines: 22-26,32,38,44,56
     :linenos:
 
 Server-Sent Events

examples/httpserver_redirects.py

@@ -5,7 +5,15 @@
 import socketpool
 import wifi
 
-from adafruit_httpserver import Server, Request, Response, Redirect, NOT_FOUND_404
+from adafruit_httpserver import (
+    Server,
+    Request,
+    Response,
+    Redirect,
+    POST,
+    NOT_FOUND_404,
+    MOVED_PERMANENTLY_301,
+)
 
 
 pool = socketpool.SocketPool(wifi.radio)
@@ -20,12 +28,22 @@
 
 @server.route("/blinka")
 def redirect_blinka(request: Request):
-    """
-    Always redirect to a Blinka page as permanent redirect.
-    """
+    """Always redirect to a Blinka page as permanent redirect."""
     return Redirect(request, "https://circuitpython.org/blinka", permanent=True)
 
 
+@server.route("/adafruit")
+def redirect_adafruit(request: Request):
+    """Permanent redirect to Adafruit website with explicitly set status code."""
+    return Redirect(request, "https://www.adafruit.com/", status=MOVED_PERMANENTLY_301)
+
+
+@server.route("/login", POST)
+def temporary_login_redirect(request: Request):
+    """Temporary moved login page with preserved POST data."""
+    return Redirect(request, "https://circuitpython.org/blinka", preserve_method=True)
+
+
 @server.route("/<slug>")
 def redirect_other(request: Request, slug: str = None):
     """