django-nose 1.4

Features

• All the goodness of nose in your Django tests, like…

  • Testing just your apps by default, not all the standard ones that happen to be in INSTALLED_APPS

  • Running the tests in one or more specific modules (or apps, or classes, or folders, or just running a specific test)

  • Obviating the need to import all your tests into tests/__init__.py. This not only saves busy-work but also eliminates the possibility of accidentally shadowing test classes.

  • Taking advantage of all the useful nose plugins

• Fixture bundling, an optional feature which speeds up your fixture-based tests by a factor of 4

• Reuse of previously created test DBs, cutting 10 seconds off startup time

• Hygienic TransactionTestCases, which can save you a DB flush per test

• Support for various databases. Tested with MySQL, PostgreSQL, and SQLite. Others should work as well.

Installation

You can get django-nose from PyPI with…

pip install django-nose

The development version can be installed with…

pip install -e git://github.com/django-nose/django-nose.git#egg=django-nose

Since django-nose extends Django’s built-in test command, you should add it to your INSTALLED_APPS in settings.py:

INSTALLED_APPS = (
    ...
    'django_nose',
    ...
)

Then set TEST_RUNNER in settings.py:

TEST_RUNNER = 'django_nose.NoseTestSuiteRunner'

Use

The day-to-day use of django-nose is mostly transparent; just run ./manage.py test as usual.

See ./manage.py help test for all the options nose provides, and look to the nose docs for more help with nose.

Enabling Database Reuse

You can save several seconds at the beginning and end of your test suite by reusing the test database from the last run. To do this, set the environment variable REUSE_DB to 1:

REUSE_DB=1 ./manage.py test

The one new wrinkle is that, whenever your DB schema changes, you should leave the flag off the next time you run tests. This will cue the test runner to reinitialize the test database.

Also, REUSE_DB is not compatible with TransactionTestCases that leave junk in the DB, so be sure to make your TransactionTestCases hygienic (see below) if you want to use it.

Enabling Fast Fixtures

django-nose includes a fixture bundler which drastically speeds up your tests by eliminating redundant setup of Django test fixtures. To use it…

1. Subclass django_nose.FastFixtureTestCase instead of django.test.TestCase. (I like to import it as TestCase in my project’s tests/__init__.py and then import it from there into my actual tests. Then it’s easy to sub the base class in and out.) This alone will cause fixtures to load once per class rather than once per test.

2. Activate fixture bundling by passing the --with-fixture-bundling option to ./manage.py test. This loads each unique set of fixtures only once, even across class, module, and app boundaries.

Speedy Hygienic TransactionTestCases

Unlike the stock Django test runner, django-nose lets you write custom TransactionTestCase subclasses which expect to start with an unmarred DB, saving an entire DB flush per test.

class MyNiceTestCase(TransactionTestCase):
    cleans_up_after_itself = True

Test-Only Models

If you have a model that is used only by tests (for example, to test an abstract model base class), you can put it in any file that’s imported in the course of loading tests. For example, if the tests that need it are in test_models.py, you can put the model in there, too. django-nose will make sure its DB table gets created.

Assertions

django-nose.tools provides pep8 versions of Django’s TestCase asserts and some of its own as functions.

assert_redirects(response, expected_url, status_code=302, target_status_code=200, host=None, msg_prefix='')

assert_contains(response, text, count=None, status_code=200, msg_prefix='')
assert_not_contains(response, text, count=None, status_code=200, msg_prefix='')

assert_form_error(response, form, field, errors, msg_prefix='')

assert_template_used(response, template_name, msg_prefix='')
assert_template_not_used(response, template_name, msg_prefix='')

assert_queryset_equal(qs, values, transform=repr)

assert_num_queries(num, func=None, *args, **kwargs)

assert_code(response, status_code, msg_prefix='')

assert_ok(response, msg_prefix='')

assert_mail_count(count, msg=None)

Using With South

South installs its own test command that turns off migrations during testing. Make sure that django-nose comes after south in INSTALLED_APPS so that django_nose’s test command is used.

Always Passing The Same Options

To always set the same command line options you can use a nose.cfg or setup.cfg (as usual) or you can specify them in settings.py like this:

NOSE_ARGS = ['--failed', '--stop']

Custom Plugins

If you need to make custom plugins, you can define each plugin class somewhere within your app and load them from settings.py like this:

NOSE_PLUGINS = [
    'yourapp.tests.plugins.SystematicDysfunctioner',
    # ...
]

Just like middleware or anything else, each string must be a dot-separated, importable path to an actual class. Each plugin class will be instantiated and added to the Nose test runner.

Older Versions of Django

Recent Version History

1.4 (2015-04-23)

• Django 1.8 support (timc3, adepue, jwhitlock)

• Support –testrunner option (st3lk)

• Fix REUSE_DB second run in py3k (edrmp)

1.3 (2014-12-05)

• Django 1.6 and 1.7 support (conrado, co3k, Nepherhotep, mbertheau)

• Python 3.3 and 3.4 testing and support (frewsxcv, jsocol)

1.2 (2013-07-23)

• Python 3 support (melinath and jonashaag)

• Django 1.5 compat (fabiosantoscode)

1.1 (2012-05-19)

• Django TransactionTestCases don’t clean up after themselves; they leave junk in the DB and clean it up only on _pre_setup. Thus, Django makes sure these tests run last. Now django-nose does, too. This means one fewer source of failures on existing projects. (Erik Rose)

• Add support for hygienic TransactionTestCases. (Erik Rose)

• Support models that are used only for tests. Just put them in any file imported in the course of loading tests. No more crazy hacks necessary. (Erik Rose)

• Make the fixture bundler more conservative, fixing some conceivable situations in which fixtures would not appear as intended if a TransactionTestCase found its way into the middle of a bundle. (Erik Rose)

• Fix an error that would surface when using SQLAlchemy with connection pooling. (Roger Hu)

• Gracefully ignore the new --liveserver option introduced in Django 1.4; don’t let it through to nose. (Adam DePue)

1.0 (2012-03-12)

• New fixture-bundling plugin for avoiding needless fixture setup (Erik Rose)

• Moved FastFixtureTestCase in from test-utils, so now all the fixture-bundling stuff is in one library. (Erik Rose)

• Added the REUSE_DB setting for faster startup and shutdown. (Erik Rose)

• Fixed a crash when printing options with certain verbosities. (Daniel Abel)

• Broke hard dependency on MySQL. Support PostgreSQL. (Roger Hu)

• Support SQLite, both memory- and disk-based. (Roger Hu and Erik Rose)

• Nail down versions of the package requirements. (Daniel Mizyrycki)

0.1.3 (2010-04-15)

• Even better coverage support (rozza)

• README fixes (carljm and ionelmc)

• optparse OptionGroups are handled better (outofculture)

• nose plugins are loaded before listing options

See more in changelog.txt.