moar

Chris McDonough

2012-09-16 3f3917f9c70ddc83263e440a8bc781bacb33bb6e

moar

 docs/narr/subrequest.rst

@@ -84,10 +84,10 @@

Being able to unconditionally obtain a response object by invoking a view
callable indirectly is the main advantage to using
:meth:`pyramid.request.Request.subrequest` instead of simply importing it and
executing it directly.  Note that there's not much advantage to invoking a
view using a subrequest if you *can* invoke a view callable directly.  It's
much slower to use a subrequest.
:meth:`pyramid.request.Request.subrequest` instead of simply importing the
view callable and executing it directly.  Note that there's not much
advantage to invoking a view using a subrequest if you *can* invoke a view
callable directly.  It's much slower to use a subrequest.

The :meth:`pyramid.request.Request.subrequest` API accepts two arguments: a
positional argument ``request`` that must be provided, and and ``use_tweens``
@@ -141,3 +141,7 @@
the documentation for :class:`pyramid.request.Request` to understand how to
massage your new request object into something that will match the view you'd
like to call via a subrequest.

We've demonstrated use of a subrequest from within a view callable, but you
can use the :meth:`~pyramid.request.Request.subrequest` API from within a
tween or an event handler as well.