[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