test / README

Full commit
.. -*- restructuredtext -*-
.. -*- mode: rst -*-

pdb++: debugging has never been so funny

What is it?

This module is an extension of the pdb_ module of the standard library.  It is
meant to be fully compatible with its predecessor, yet it introduces a number
of new features to make your debugging experience as nice as possible.

``pdb++`` features include:

  - colorful TAB completion of Python expressions (through fancycompleter_)

  - optional syntax highlighting of code listings (through pygments_)

  - `sticky mode`_

  - several new commands to be used from the interactive ``(Pdb++)`` prompt

  - additional convenience functions in the ``pdb`` module, to be used from
    your program

  - user friendlier user interface (hint: have you ever typed ``r`` at the
    prompt to print the value of some variable?)


Unfortunately, ``pdb++`` is not a valid identifier for ``pip`` and
``easy_install``, so you have to install ``pdbpp`` instead::

    $ pip install pdbpp

Note that the Python name of the module is ``pdb``. The intention is to
transparently substitute the ``pdb`` module in the standard library: this way,
every program and library which calls ``pdb`` will automatically use ``pdb++``
(e.g., ``py.test --pdb``).

The old ``pdb`` module is still available by doing e.g. ``import pdb;

New interactive commands

The following are new commands that you can use from the interative
``(Pdb++)`` prompt.


bla bla


bla bla