[Checkins] SVN: zope.publisher/branches/unauth-exc-handler/src/zope/publisher/interfaces/__init__.py Explain what the IReRaiseException is good for.
Uli Fouquet
uli at gnufix.de
Mon Jul 6 11:34:59 EDT 2009
Log message for revision 101627:
Explain what the IReRaiseException is good for.
Changed:
U zope.publisher/branches/unauth-exc-handler/src/zope/publisher/interfaces/__init__.py
-=-
Modified: zope.publisher/branches/unauth-exc-handler/src/zope/publisher/interfaces/__init__.py
===================================================================
--- zope.publisher/branches/unauth-exc-handler/src/zope/publisher/interfaces/__init__.py 2009-07-06 15:32:06 UTC (rev 101626)
+++ zope.publisher/branches/unauth-exc-handler/src/zope/publisher/interfaces/__init__.py 2009-07-06 15:34:59 UTC (rev 101627)
@@ -501,4 +501,17 @@
class IReRaiseException(Interface):
"""An exception that should be reraised, when handled in publisher.
+
+ Under some circumstances (for instance if acting in a WSGI
+ pipeline with debugger middleware) certain exceptions occuring
+ while publishing should be handled by the Zope machinery and never
+ reach the 'outside world'.
+
+ Adapters providing this interface for a certain exception type
+ which also return ``False`` when being called, indicate by this
+ that the exception should not be reraised during publishing.
+
+ This makes it possible, for instance, to authenticate with
+ basic-auth when a debugger middleware is used and `IUnauthorized`
+ is raised.
"""
More information about the Checkins
mailing list