.. note:: Please note that development of CleanerVersion has been discontinued as of February 2019. Feel free to fork the repository.
CleanerVersion for Django
.. image:: https://img.shields.io/travis/swisscom/cleanerversion/master.svg :target: https://travis-ci.org/swisscom/cleanerversion .. image:: https://img.shields.io/coveralls/swisscom/cleanerversion/master.svg :target: https://coveralls.io/r/swisscom/cleanerversion .. image:: https://img.shields.io/pypi/v/CleanerVersion.svg :target: https://pypi.python.org/pypi/CleanerVersion
CleanerVersion is a solution that allows you to read and write multiple versions of an entry to and from your relational database. It allows to keep track of modifications on an object over time, as described by the theory of Slowly Changing Dimensions (SCD) - Type 2.
CleanerVersion therefore enables a Django-based Datawarehouse, which was the initial idea of this package.
CleanerVersion's feature-set includes the following bullet points:
Simple versioning of an object (according to SCD, Type 2)
Versioning of One-to-Many relationships
Versioning of Many-to-Many relationships
Migrations, if using in conjunction with Django 1.7 and upwards
Integration with Django Admin (Credits to @boydjohnson and @peterfarrell)
This code was tested with the following technical components
CleanerVersion was originally written for Django 1.6 and has now been ported up to Django 1.11.
CleanerVersion 2.x releases are compatible with Django 1.11 and 2.0. It may also work with Django 1.9 and 1.10, but note that these versions are not officially supported and test cases have been removed.
Old packages compatible with older Django releases:
Django 1.6 and 1.7: https://pypi.python.org/pypi/CleanerVersion/1.5.4
Django 1.8: https://pypi.python.org/pypi/CleanerVersion/1.6.2
Django 1.9 & 1.10: https://pypi.python.org/pypi/CleanerVersion/2.0.0
Find a detailed documentation at http://cleanerversion.readthedocs.org/.