nose-pudb 0.1.2

A Nose plugin for dropping the test runner into pdb when it encounters an error.

The nose-pudb plugin provides integration between the Nose testing framework and the pudb console-based visual debugger. Instead of collecting and displaying test results, the test runner can drop into the debugger on errors and/or test failures.

This is similar to Nose’s built-in Debug plugin which uses the pdb debugger from the Python standard library.

Contents

• Overview

• Install

  • Usage

• Contributing

• License

• Changelog

• To Do

Overview

The plugin provides --pudb and --pudb-failures options. The --pudb option will drop the test runner into pudb when it encounters an error. To drop into pudb on failure, use --pudb-failures.

A script introduced in the pudb wiki provides a simple way to drop into pudb instead of pdb when running nose tests. However, when using that script, pudb fails to show information about the exception object along with the traceback when hitting the ‘e’ key.

This plugin passes the exception type and value to pudb’s post_mortem() function so that they are displayed with the traceback.

Install

You can get nose-pudb with easy_install

$ easy_install nose-pudb

Or you can clone the source using git from http://github.com/akaihola/nose-pudb.git and install it with

$ python setup.py develop

Usage

To run nose tests and drop into pudb on errors, type:

$ nosetests --pudb

To drop into pudb on failures, type:

$ nosetests --pudb-failures

Contributing

Please submit bugs and patches. All contributors will be acknowledged. Thanks!

License

The plugin is released under the GNU Lesser General Public license (LGPL). See the file LICENSE for details.

Changelog

• 0.1

  • Initial release

• 0.1.1

  • License added

  • Documentation fixes

  • Setup script fixes

• 0.1.2

  • Setup script fix: include readme and license in the distribution

To Do

• nothing at this point