Merge 5fe2756 into f89b28d

falconry · Feb 12, 2019 · 5ce1c8f · 5ce1c8f
2 parents f89b28d + 5fe2756
commit 5ce1c8f
Show file tree

Hide file tree

Showing 2 changed files with 11 additions and 0 deletions.
diff --git a/docs/api/middleware.rst b/docs/api/middleware.rst
@@ -20,6 +20,11 @@ Falcon's middleware interface is defined as follows:
         def process_request(self, req, resp):
             """Process the request before routing it.
 
+            Note:
+                Because Falcon routes each request based on req.path, a
+                request can be effectively re-routed by setting that
+                attribute to a new value from within process_request().
+
             Args:
                 req: Request object that will eventually be
                     routed to an on_* responder method.

diff --git a/falcon/api.py b/falcon/api.py
@@ -63,6 +63,12 @@ class ExampleComponent(object):
                     def process_request(self, req, resp):
                         \"\"\"Process the request before routing it.
 
+                        Note:
+                            Because Falcon routes each request based on
+                            req.path, a request can be effectively re-routed
+                            by setting that attribute to a new value from
+                            within process_request().
+
                         Args:
                             req: Request object that will eventually be
                                 routed to an on_* responder method.