Metadata-Version: 1.1
Name: django-mutant
Version: 0.3a5
Summary: Dynamic model definition and alteration (evolving schemas)
Home-page: https://github.com/charettes/django-mutant
Author: Simon Charette
Author-email: charette.s@gmail.com
License: MIT License
Description: #############
        django-mutant
        #############
        
        Dynamic model definition and alteration (evolving schemas).
        
        .. image:: https://travis-ci.org/charettes/django-mutant.svg?branch=master
            :target: https://travis-ci.org/charettes/django-mutant
        
        .. image:: https://coveralls.io/repos/charettes/django-mutant/badge.svg?branch=master&service=github
            :target: https://coveralls.io/github/charettes/django-mutant?branch=master
        
        ********
        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`_.
        
        .. _`Django`: https://www.djangoproject.com/
        .. _`migrations`: https://docs.djangoproject.com/en/stable/topics/migrations/
        .. _`django-mutant`: https://github.com/charettes/django-mutant
        .. _`dynamic-models`: https://github.com/willhardy/dynamic-models
        .. _`documentation`: http://dynamic-models.readthedocs.org/en/latest/index.html
        .. _`talk`: http://2011.djangocon.eu/talks/22/#talkvideo
        .. _`django-dynamo`: https://bitbucket.org/schacki/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.
        
        .. _DjangoCon Europe 2013 talk: https://www.youtube.com/watch?v=67wcGdk4aCc
        .. _A getting started guide: http://integricho.github.io/2013/07/22/mutant-introduction/
        
        
        ***************************
        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).
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.8
Classifier: Framework :: Django :: 1.9
Classifier: Framework :: Django :: 1.10
Classifier: Framework :: Django :: 1.11
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Software Development :: Libraries :: Python Modules
