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 manage.py 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

from tddspry.django import TestCase

from django.contrib.auth.models import User


TEST_EMAIL = 'test-email@domain.com'
TEST_PASSWORD = 'test-password'
TEST_USERNAME = 'test-username'


class TestUserModel(TestCase):

    def test_unique(self):
        self.assert_create(User,
                           username=TEST_USERNAME,
                           password=TEST_PASSWORD,
                           email=TEST_EMAIL)
        self.assert_raises(Exception,
                           self.assert_create,
                           User,
                           username=TEST_USERNAME,
                           password=TEST_PASSWORD,
                           email=TEST_EMAIL)

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
        self.go200('/')

        # Login url does not exist cause user already logged in
        self.notfind(login_url)

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

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

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

TEST_RUNNER = 'tddspry.django.runner.TestSuiteRunner'

$ ./manage.py test

Requirements

• Python 2.4 or above
• Django up to trunk
• nose 0.11.0 or above
• twill 0.9
• django-nose (optional, required by test runner)

Installation

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

To install use:

$ pip install tddspry

Or:

$ python setup.py install

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

$ git clone git://github.com/playpauseandstop/tddspry.git

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

License

tddspry is licensed under the BSD License.

Documentation

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.

Contacts