When Zope is running in debug mode this product hooks PDB debugging into various parts of a Zope instance. Some additional Plone specific hooks are also included.
This version of PDBDebugMode has been tested with Plone 6.2 on Python 3.10-3.13.
For Zope4 and Plone 5.2 in Python 2.7, 3.6 and 3.7 please use Products.PDBDebugMode = 2.1.
For Zope 2 (until Plone 5.1) please use Products.PDBDebugMode = 1.3.
If ipdb (http://pypi.python.org/pypi/ipdb) is available, it will use that instead of standard pdb.
Its recommended that you use an editor or IDE that can cooperate with pdb. Emacs for example, will display the corresponding lines of the source file alongside the pdb prompt.
Remember that this product does nothing
unless zope is being run with debug-mode=on such as with ./bin/instance fg.
To provide for better investigation of errors, any error or exception
logged with the python logging module will invoke pdb.post_mortem() if
a traceback can be retrieved and set_trace will be invoked otherwise.
Since the Zope error_log exception handler uses the logging module
when logging errors, this provides for post mortem debugging of Zope
errors. It is often useful, for example, to remove NotFound or
Unauthorized from the ignored exception in error_log and then
investigate such errors with PDB.
Any request that has the key pdb_runcall will call the result of the
request traversal in the debugger thus allowing for stepping through
the resulting execution. To debug a POST or any other request which
might be tricky to insert the pdb_runcall key into, use
?toggle_runcall=1 at the end of a URL immediately preceding the
POST to set a pdb_runcall cookie which will then invoke the
pdb.runcall when the POST is submitted. Use ?toggle_runcall=1 at
the end of a URL to clear the cookie. Remember that the cookie will
be set at the level in the hierarchy that it was set.
Additionally, a view named pdb is registered for all objects that
will simply raise an exception leaving you with the current context to
inspect. Use it for example by calling http://localhost:8080/Plone/foo/@@pdb.
Import of the pdb module is also allowed in unprotected code such as python scripts.