/django-mutant

Dynamic model definition and alteration (evolving schemas)

Primary LanguagePythonMIT LicenseMIT

django-mutant

Dynamic model definition and alteration (evolving schemas).

https://travis-ci.org/charettes/django-mutant.svg?branch=master https://coveralls.io/repos/charettes/django-mutant/badge.svg?branch=master&service=github

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:

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

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).