From 8818ea59e253b855e1b0f09b856560cb71c9e8de Mon Sep 17 00:00:00 2001 From: Robert Jackiewicz Date: Mon, 12 Nov 2012 12:27:23 -0500 Subject: Modified the hooks documentation to currently describe how to access the context in a forbidden view. --- docs/narr/hooks.rst | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/docs/narr/hooks.rst b/docs/narr/hooks.rst index 96fa77a07..ea75e5fe4 100644 --- a/docs/narr/hooks.rst +++ b/docs/narr/hooks.rst @@ -180,11 +180,14 @@ as a forbidden view: config.scan() Like any other view, the forbidden view must accept at least a ``request`` -parameter, or both ``context`` and ``request``. The ``context`` (available -as ``request.context`` if you're using the request-only view argument -pattern) is the context found by the router when the view invocation was -denied. The ``request`` is the current :term:`request` representing the -denied action. +parameter, or both ``context`` and ``request``. If a forbidden view +callable accepts both ``context`` and ``request``, the HTTP Exception is passed +as context. The ``context`` as found by the router when view was +denied (that you normally would expect) is available as +``request.context``. The ``request`` is the current :term:`request` +representing the denied action. + + Here's some sample code that implements a minimal forbidden view: -- cgit v1.2.3 From 18a9aed5810a5680fc027b8c55c10bd67616d1b0 Mon Sep 17 00:00:00 2001 From: Robert Jackiewicz Date: Mon, 12 Nov 2012 12:47:23 -0500 Subject: Added changes to the CHANGES log. --- CHANGES.txt | 7 +++++++ CONTRIBUTORS.txt | 2 ++ 2 files changed, 9 insertions(+) diff --git a/CHANGES.txt b/CHANGES.txt index e40312c34..c28597f0e 100644 --- a/CHANGES.txt +++ b/CHANGES.txt @@ -81,6 +81,13 @@ Internals because that package should never be imported from non-Pyramid code. TopologicalSorter is still not an API, but may become one. +Documentation +------------- + +- Updated the hooks narrative documentation to reflect the fact that + the context passed into the view callable is actually the instance of + Exception called when a Forbidden Exception is envoked + 1.4a3 (2012-10-26) ================== diff --git a/CONTRIBUTORS.txt b/CONTRIBUTORS.txt index d03da3e62..34d904d0f 100644 --- a/CONTRIBUTORS.txt +++ b/CONTRIBUTORS.txt @@ -188,3 +188,5 @@ Contributors - Domen Kozar, 2012/09/11 - David Gay, 2012/09/16 + +- Robert Jackiewicz, 2012/11/12 -- cgit v1.2.3