django-versions 1.0.1

django-versions allows you to version the data stored in django models seamlessly. To get started all you need to do is to set VERSIONS_REPOSITORIES variable in your settings and configure the repositories you would like to use, then just subclass your Model from VersionsModel and start saving data:<br /><br />from django.db import models<br />from versions.models import VersionsModel<br /><br />class MyModel(VersionsModel):<br /> text = models.TextField()<br /><br />Installation<br />Dependencies<br /><br /> * Mercurial >= 1.5.2<br /> * Django == 1.1.X<br /><br />Installing django-versions<br /><br />If your are installing from source, you just need to run the following command from the base of the django-versions source tree:<br /><br />python setup.py install<br /><br />If you want to install the package without checking out the source you should run:<br /><br />pip install django-versions<br /><br /># OR if you don't have pip installed (you should definitely check out pip)<br />easy_install django-versions<br /><br />For the time being, we need to patch Django to allow us to gain access to the related model from Manager classes. There is a patch included at the root of the source tree django.patch that includes the required changes. To patch django, go to the root of your checkout of django 1.1.X and run:<br /><br />patch -p0 < /path/to/django-versions/django.patch<br /><br />Add VERSIONS_REPOSITORIES to your settings file, pointing to the location where you would like django-versions to create and store your model history:<br /><br />VERSIONS_REPOSITORIES = {<br /> 'default': {<br /> 'backend': 'versions.backends.hg',<br /> 'local': '/path/to/my/projects/model/history',<br /> }<br /> }<br /><br />Enabling Version Management<br /><br />Install the VersionsMiddleware:<br /><br />MIDDLEWARE_CLASSES = (<br /> ...<br /> 'versions.middleware.VersionsMiddleware',<br /> ...<br /> )<br /><br />Or handle enabling editing of Versioned models manually:<br /><br />from versions.base import revision<br /><br />@revision.commit_on_success<br />def my_editing_function(request):<br /> m = MyModel.objects.get(pk=1)<br /> m.save()<br /><br /><br />def my_other_editing_function(request):<br /> with revision:<br /> m = MyModel.objects.get(pk=1)<br /> m.save()<br /><br />#md5=f4be9b84a483e4e9d820dda53ae9ffdc

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Create,  Django,  Djangoversions,  Import,  Install,  Location,  Model,  Models,  Mymodelobjectsgetpk,  Patch,  Pathtodjangoversionsdjangopatchadd,  Pointing,  Settings,  Source,  Store,  Versions Repositories
Users rating:	0/10