Metadata-Version: 1.1
Name: dm.pdb
Version: 1.2
Summary: Slightly extended and sanitized Python debugger -- Debugger with Zope support
Home-page: UNKNOWN
Author: Dieter Maurer
Author-email: dieter@handshake.de
License: BSD (see "dm/pdb/LICENSE.txt", for details)
Description: Dieter Maurer's PDB extension.
        ==============================
        
        ``Pdb``, the Python debugger, has severe limitations (apart from some bugs).
        This extension tries to get rid of some of them.
        
        Things done
        -----------
        
         * setting breakpoints
        
           Allow *filename* to specify a module as well.
        
           Allow setting breakpoints from outside via ``do_break``.
           This is useful for debug setups.
        
         * exception display
        
           The current display of an exception is almost useless.
           In the ``Pdb`` code, exceptions are displayed at 4 places --
           and each of them uses slightly different code (whow!).
        
           We consolidate this into a single function ``_handle_exception``
           and present the exception with ``traceback.format_exception_only``.
           We also store the exception in the ``Pdb`` instance.
           A new command ``exception`` (abbreviated ``e``) presents this
           stored exception value in a way similar to the ``where`` command.
        
        
         * ``where`` command improvements
        
           - each frame identifies its level (the top frame is at level 0,
             the one below it at level 1, etc...)
        
           - the current frame is marked as such
        
           - ``where`` gets optional arguments *number* and *end*
        
             *number* controls how many frames are displayed (default: ``maxint``),
             *end* at what level the display ends, negative numbers count from
             the bottom (default: ``-1``, i.e. the bottom frame).
        
         * new command ``frame level`` (abbr: ``f``)
        
           switch to call frame at *level*
        
           without argument, provide info about current frame
        
         * allow to customize the display of the ``where`` command
           and of tracebacks
           e.g. to display additional debugging information as
           provided by Zope (for example).
        
           This can be done by customizing ``getAdditionalFrameInfo``.
        
        Things not yet done
        -------------------
        
         * Returning from ``debug`` occasionally returns to ``stop``
           rather than where we entered the recursive debugger.
           This is often nasty (and should be fixed)
        
        Version history
        ---------------
        
        1.2
        ,,,
        
         * fixed: ``do_break`` sometimes failed to resolve functions correctly.
        
        1.1
        ,,,
        
         * improved handling of errors in command argument parsing
        
         * Python 2.6 compatibility
        
        
        1.0.4
        ,,,,,
        
         * work around Python monkey patching ``set_trace`` inside a doctest.
        
        1.0.3
        ,,,,,
        
         * fix ``debug`` to use the current ``Pdb`` class, not Python's.
        
        1.0.2
        ,,,,,
        
         * let external calls to ``do_break`` work even after the first ``run``.
Keywords: debugger pdb Zope
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development
