Skip to main content

Improves nose test description output

Project description

Latest PyPI version Latest Travis CI build status

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



Project details

Download files

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

Files for nose-enhanced-descriptions, version 0.1.5
Filename, size File type Python version Upload date Hashes
Filename, size nose-enhanced-descriptions-0.1.5.tar.gz (3.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page