README.rst

Nose django helper plugin

With this plugin you can write standard Nose unit tests inside a
Django application.

The plugin takes care of finding your applications settings.py file
and creating/tearing down test database. It also has support for
fixtures and it has experimental mechanism that wraps the tests in
transactions to speed up testing.

This plugin works with Django versions 1.0 or newer.

Usage

Unit tests can be run with following command:

nosetests --with-django [nose-options]

Custom settings be used by setting DJANGO_SETTINGS_MODULE
environmental variable.

Command line options

In addition to default nose command line options, nosedjango offers
following options:

--django-settings=MODULE

Specify a custom Django settings MODULE.
The specified MODULE needs to be found
in sys.path.

Building Debian package

Plugin can also be installed as a Debian package:

dpkg-checkbuilddeps
dpkg-buildpackage -us -uc -rfakeroot
sudo debi

Testing

The project sample Django project was created using Django 1.0b1.

Using a more recent version of Django may cause problems. You've been
warned.

If you change directory into the 'project' directory, you should be
able to run the nose test runner and get reasonable results.

Note that you won't be running your doctests unless you tell nose to
do so.

As usual, you need to tell nose to run doctest test strings in modules
that contain standard test classes.