diff options
Diffstat (limited to 'repoze')
| -rw-r--r-- | repoze/bfg/events.py | 12 |
1 files changed, 11 insertions, 1 deletions
diff --git a/repoze/bfg/events.py b/repoze/bfg/events.py index 1c9ca174c..6c64fa2ec 100644 --- a/repoze/bfg/events.py +++ b/repoze/bfg/events.py @@ -20,7 +20,17 @@ class NewResponse(object): whenever any :mod:`repoze.bfg` view returns a :term:`response`. The instance has an attribute, ``response``, which is the response object returned by the view. This class implements the - :class:`repoze.bfg.interfaces.INewResponse` interface.""" + :class:`repoze.bfg.interfaces.INewResponse` interface. + + .. note:: + + Postprocessing a response is usually better handled in a WSGI + :term:`middleware` component than in subscriber code that is + called by a :class:`repoze.bfg.interfaces.INewResponse` event. + The :class:`repoze.bfg.interfaces.INewResponse` event exists + almost purely for symmetry with the + :class:`repoze.bfg.interfaces.INewRequest` event. + """ implements(INewResponse) def __init__(self, response): self.response = response |