README.rst

django-mutant

Dynamic model definition and alteration (evolving schemas).

Overview

Django provides a great ORM and with the power of migrations one can easily perform schema alteration.

However, some projects may require runtime schema alteration and that's what django-mutant provides.

The main concept was inspired by those projects:

• Will Hardy dynamic-models's documentation and talk.
• And by django-dynamo.

Installation

pip install django-mutant

Make sure 'django.contrib.contenttypes' and 'mutant' are in your INSTALLED_APPS

INSTALLED_APPS += ('django.contrib.contenttypes', 'mutant')

Migrating to django-mutant 0.2 and Django 1.7+

If you used mutant with Django < 1.7 and are willing to migrate forward you'll have to run the following steps in order to make sure you database schema is synchronized with Django's migration state.

1. Fake the initial mutant migration.
2. For every mutant.contrib application you installed make sure to fake their initial migration and run their following migration. For example, if you had the mutant.contrib.boolean application installed you want to run manage.py migrate boolean --fake 0001 && manage.py migrate boolean

Resources

• DjangoCon Europe 2013 talk about mutant and other dynamic model alternatives given by Juergen Schackmann.
• A getting started guide with mutant guide by @integricho.

Get in touch and contribute

From now on I think the best way to contribute and get in touch is using github messaging system (issues and pull requests).