Changes between Version 8 and Version 9 of UrlRouting

Timestamp:

Aug 7, 2008, 5:09:20 PM (16 years ago)

Author:

cmlenz

Comment:

Document WSGI delegation

UrlRouting

@@ -58 +58 @@
 Finally, the `redirect(target, *args, **kwargs)` function is a shortcut for redirecting to the absolutized result of `path_to(). It will raise an HTTP exception, and thus immediately break out of the current code.
 
+== Delegating to Other WSGI Applications ==
+
+You can mount other WSGI-based applications into the URI namespace of the Diva application using the `delegate` request handler in the `diva.routing` module.
+
+For example, the following routing configuration would mount [http://trac.edgewall.org/ Trac] under the `/trac` prefix:
+
+{{{
+#!routingconf
+trac:           /trac{path:.*}          -> diva.routing:delegate
+    application = "trac.web.main.dispatch_request"
+    environ = {"trac.env_path": "/var/trac/teo"}
+}}}
+
+The `application` parameter is needed to determine which WSGI application is delegated to. The `environ` parameter can be used to specify a dictionary of variables that should be added to the WSGI environ, which may be needed by the target app. Finally, a delegating route should use a `path` URL part that will be used as the `PATH_INFO` for the target application.
+
 == API Documentation ==
 
 [[PythonDoc(trunk, diva.routing)]]
-