Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Improves nose test description output

Project Description

A nose plugin to improve nose test description output. This plugin deals with two problems in the default verbose nose output. Finding out which test failed, and selectively rerunning tests.

By default, running nosetests verbosely will describe each test with one of

  • An id derived from the name and module of the test
  • The first line of the docstring


I have a docstring ... ok
test_with_blank_docstring (meta_tests.MetaTest) ... ok
I have a docstring ... ok
test_without_docstring (meta_tests.MetaTest) ... ok

If you have multiple tests in different suites with the same or similar docstrings, and one of them fails, it can be difficult to find out which is which.

The description derived from the name of the test is also frustrating. The format of a command line argument to run a specific test in nose is module:TestClass.testmethod, yet the format of the description is testmethod (module.TestClass), meaning that the user must construct this argument by copying the various sections into the right place and replacing one of the dots with a colon.


nosetests --verbose --with-enhanced-descriptions

    (The first line was empty, but this is the line to use.) ... ok
meta_tests:MetaTest.test_with_blank_docstring ... ok
    (I have a docstring) ... ok
meta_tests:MetaTest.test_without_docstring ... ok

The reader can see both the identifier (so that they know exactly which test fails), and the documentation (so that they know what it was supposed to do). The test identifiers can alo now be copied and run, e.g. nosetests meta_tests:MetaTest.test_without_docstring.


pip install nose_enhanced_descriptions



Release History

This version
History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(3.1 kB) Copy SHA256 Hash SHA256
Source None May 13, 2016

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting