django-shareddb 0.1.2

Setup

First, install django-shareddb:

$ pip install django-shareddb

Then, simply update your settings to use its wrapping engine:

DATABASES = {
    'default': {
        'ENGINE': 'shareddb.backends.shareddb',
        'INNER_ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': 'test-dbsharing',
    }
}

Since altering those settings is very frequent, django-shareddb also provides a simple patch_databases function:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': 'test-dbsharing',
    }
}

if os.environ['FAST_TESTS']:
    import shareddb
    DATABASES = shareddb.patch_databases(DATABASES)

Once the settings are ready, simply replace your calls to Django’s LiveServerTestCase with the django-shareddb variant:

from shareddb import testcases

class MyTests(testcases.LiveServerTestCase):
    def test_something(self):
        # Your test here

The django-shareddb LiveServerTestCase is simply a clone of Django’s version, but uses django.test.TestCase instead of django.test.TransactionTestCase.

Links

• The code of this project is available on GitHub: https://github.com/rbarrois/django-shareddb

• It is available on PyPI: https://pypi.python.org/pypi/django-shareddb

• Issues, questions, and new features should be opened on GitHub: https://github.com/rbarrois/django-shareddb/issues

Testing

This libraries has been succesfully tested with sqlite and postgresql.

If you want to test it with other databases, please clone it and alter dev/settings.py for your setup, then run ./manage.py test.