Download

Current version: %(version)s
(%(date)s)

Install

Current version:
easy_install nose==%(version)s

Unstable (trunk):
easy_install nose==dev

Read

• An Extended Introduction to the nose Unit Testing Framework
  Titus Brown's excellent article provides a great overview of nose and its uses.
• nosetests usage
  How to use the command-line test runner.

Announcement list

Sign up to receive email announcements of new releases

Tracker

Report bugs, request features, wik the wiki, browse source.

Get the code

svn co http://python-nose.googlecode.com/svn/trunk/ nose

Other links

• My blog
• py.test
• testgears
• setuptools

nose: a discovery-based unittest extension.

nose provides an alternate test discovery and running process for unittest, one that is intended to mimic the behavior of py.test as much as is reasonably possible without resorting to too much magic.

Install

On most UNIX-like systems, you'll probably need to run these commands as root or using sudo.

Install nose using setuptools:

easy_install nose

Or, if you don't have setuptools installed, use the download link at right to download the source package, and install in the normal fashion: Ungzip and untar the source package, cd to the new directory, and:

python setup.py install

If you have an older version of setuptools installed, you may see an error like this:

The required version of setuptools (>=0.6c5) is not available, and can't be installed while this script is running. Please install a more recent version first.

In that case, you'll need to update your setuptools install first, either by running:

easy_install -U setuptools

or:

python ez_setup.py

%(body)s

nosetests setuptools command

%(commands)s

nosetests usage

%(usage)s

Bug reports

Please report bugs and make feature requests here.

Hack

Write plugins! It's easy and fun.

Get the code:

svn checkout http://python-nose.googlecode.com/svn/trunk/ nose

Patches are welcome. I'd suggest grabbing a copy of svk so that you can have local version control and submit full patches against an up-to-date tree easily.

Thanks to Google for providing the Google code hosting service.

Changelog

%(changelog)s