summaryrefslogtreecommitdiff
path: root/docs/api/request.rst
diff options
context:
space:
mode:
authorChris McDonough <chrism@plope.com>2011-07-31 03:57:06 -0400
committerChris McDonough <chrism@plope.com>2011-07-31 03:57:06 -0400
commit95a3791409f4a936c47e7018e75f14fc3b701380 (patch)
tree326a676a5ecce049dbda625cb7f033248efb2c4c /docs/api/request.rst
parentdc27f6ccd181f553da1c2ef0debb5ecc355012a9 (diff)
downloadpyramid-95a3791409f4a936c47e7018e75f14fc3b701380.tar.gz
pyramid-95a3791409f4a936c47e7018e75f14fc3b701380.tar.bz2
pyramid-95a3791409f4a936c47e7018e75f14fc3b701380.zip
- A new attribute is available on request objects: ``exc_info``. Its value
will be ``None`` until an exception is caught by the Pyramid router, after which it will be the result of ``sys.exc_info()``.
Diffstat (limited to 'docs/api/request.rst')
-rw-r--r--docs/api/request.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/docs/api/request.rst b/docs/api/request.rst
index 404825d1b..2ab3977d5 100644
--- a/docs/api/request.rst
+++ b/docs/api/request.rst
@@ -85,6 +85,17 @@
of ``request.exception`` will be ``None`` within response and
finished callbacks.
+ .. attribute:: exc_info
+
+ If an exception was raised by a :term:`root factory` or a :term:`view
+ callable`, or at various other points where :app:`Pyramid` executes
+ user-defined code during the processing of a request, result of
+ ``sys.exc_info()`` will be available as the ``exc_info`` attribute of
+ the request within a :term:`exception view`, a :term:`response callback`
+ or a :term:`finished callback`. If no exception occurred, the value of
+ ``request.exc_info`` will be ``None`` within response and finished
+ callbacks.
+
.. attribute:: response
This attribute is actually a "reified" property which returns an