skip to navigation
skip to content

tddspry 0.4-beta

Collection of test cases and additional helpers to test Django applications with nose library.

Collection of testcases and helpers to test Django projects and applications with nose and twill libraries.

  1. Key features
  2. Quick examples
    1. Writing tests
    2. Running tests
  3. Requirements
  4. Installation
  5. License
  6. Documentation
  7. Sending bugs and feature requests
  8. Contacts

Key features

  • Support of assert methods from unittest2 library (assertIn, assertIs and others).
  • Full support of all features from django.test.TestCase or django.test.TransationalTestCase classes.
  • Run tests for Django projects and applications via nosetests command instead of python test. You don’t need to place tests in tests module - nosetests automaticly find its in project or application.
  • Assert methods for testing Django models (assert_create, assert_count, etc).
  • Test web responses with twill library instead of using django.test.Client.
  • Helpers for make particular actions in tests (create users or superusers, login or logout from projects).

Quick examples

Writing tests

Database test

Check that username field of standart auth.User model is unique:

from tddspry.django import TestCase

from django.contrib.auth.models import User

TEST_PASSWORD = 'test-password'
TEST_USERNAME = 'test-username'

class TestUserModel(TestCase):

    def test_unique(self):

Http (twill) test

Login into project and check that login url does not exist in index page and logout and profile links exist:

from tddspry.django import TestCase

class TestHttp(TestCase):

    def setup(self):
        # Create user
        self.user = self.helper('create_user')

        # Login this user into project
        self.login(self.helpers.USERNAME, self.helpers.PASSWORD)

    def test_index_links(self):
        # Login, logout and profile urls
        login_url = self.build_url('auth_login')
        logout_url = self.build_url('auth_logout')
        profile_url = self.build_url('auth_profile')

        # Go to index page

        # Login url does not exist cause user already logged in

        # But logout and profile url exist
        # Profile url must find at page 3 times
        self.find(profile_url, count=3)

Running tests

There are three ways to run tests in your project.

First, using nosetests command, e.g.:

$ nosetests --with-django --django-settings=project.settings project
$ DJANGO_SETTINGS_MODULE=project.settings NOSE_WTIH_DJANGO=1 nosetests project

This way requires install tddspry to your system.

Second, using script, e.g.:

$ --django-settings=project.settings project
$ DJANGO_SETTINGS_MODULE=project.settings project

This script is wrapper to previous method (you don’t need to run nosetests with --with-django option or NOSE_WTIH_DJANGO environment var), but does not require install tddspry to your system (it’s good idea if you want use latest development version of tddspry). Script located in bin/ directory.

Third, using TEST_RUNNER setting in Django >= 1.2 (requires django-nose app installed):

TEST_RUNNER = 'tddspry.django.runner.TestSuiteRunner'

Then you can use Django’s internal test manage command to run your tests:

$ ./ test

Otherwise, you can use all power of nosetests command to run tests in your Django project or applications.



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

To install use:

$ pip install tddspry


$ python install

Also, you can retrieve fresh version of tddspry from GitHub:

$ git clone git://

and place tddspry directory somewhere to PYTHONPATH (or sys.path).


tddspry is licensed under the BSD License.


Sphinx-generated documentation for tddspry located at GitHub pages. This documentation updates after every tddspry release.

Fresh documentation always can access in docs/ directory.

Sending bugs and feature requests

Found a bug? Have a good idea for improving tddspry? Head over to tddspry’s trac to create a new ticket or to GitHub to create a new fork.


Authors:Igor Davydenko < playpauseandstop [at] gmail >, Volodymyr Hotsyk < gotsyk [at] gmail >
Idea:Andriy Khavryuchenko < akhavr [at] gmail >
File Type Py Version Uploaded on Size
tddspry-0.4-beta.tar.gz (md5) Source 2010-12-13 27KB