[Checkins] SVN: grok/branches/1.0/doc/upgrade.txt add a note about the debug.ini profile and the fact that IUnauthorized exceptions are always handled by zope.publisher regardless of the handleErrors=False argument.
Jan-Wijbrand Kolman
janwijbrand at gmail.com
Sun Sep 27 16:08:54 EDT 2009
Log message for revision 104580:
add a note about the debug.ini profile and the fact that IUnauthorized exceptions are always handled by zope.publisher regardless of the handleErrors=False argument.
Changed:
U grok/branches/1.0/doc/upgrade.txt
-=-
Modified: grok/branches/1.0/doc/upgrade.txt
===================================================================
--- grok/branches/1.0/doc/upgrade.txt 2009-09-27 20:08:12 UTC (rev 104579)
+++ grok/branches/1.0/doc/upgrade.txt 2009-09-27 20:08:54 UTC (rev 104580)
@@ -102,9 +102,24 @@
bin/projectname-ctl fg
- You can also start it with ``parts/etc/debug.ini`` to get exception
- formatting.
+ Alternatively there's a profile available that can help debugging errors in
+ your application::
+ bin/paster serve parts/etc/debug.ini
+
+ When using this profile it is not the ``zope.publisher`` that handles the
+ exceptions that are raised, but a special middleware is. This middleware
+ then provides a pdb-like debugging user interdace in the browser.
+
+ Note that the ``IUnauthorized`` exception is treated specially: Grok will
+ make sure that this types of exception is actaully still handled by
+ ``zope.publisher`` in order to make login forms or Basic Auth
+ authentication still function properly.
+
+ Also note that as a consequence the ``handleErrors`` attribute on
+ ``zope.testbrowser.testing.Browser`` instances used in functional tests
+ does not effect the ``IUnauthorized`` exception.
+
Interpreter name has been changed from ``bin/python`` to
``bin/grokpy`` to avoid conflicts with virtualenv.
More information about the checkins
mailing list