history compare for django-reversion
Project description
django-reversion-compare is an extension to django-reversion that provides a history compare view to compare two versions of a model which is under reversion.
Comparing model versions is not a easy task. Maybe there are different view how this should looks like. This project will gives you a generic way to see whats has been changed.
Many parts are customizable by overwrite methods or subclassing, see above.
requires.io/github/jedie/django-reversion-compare/requirements/ |
installation
Just use:
pip install django-reversion-compare
Optional you can install google-diff-match-patch otherwise difflib would be used. The easiest way it to use the unofficial package diff-match-patch, e.g.:
pip install diff-match-patch
setup
Add reversion_compare to INSTALLED_APPS in your settings.py, e.g.:
INSTALLED_APPS = ( 'django...', ... 'reversion', # https://github.com/etianen/django-reversion 'reversion_compare', # https://github.com/jedie/django-reversion-compare ... ) # Add reversion models to admin interface: # ADD_REVERSION_ADMIN=True
usage
Inherit from CompareVersionAdmin instead of VersionAdmin to get the compare feature.
admin.py e.g.:
from django.contrib import admin from reversion_compare.admin import CompareVersionAdmin from my_app.models import ExampleModel class ExampleModelAdmin(CompareVersionAdmin): pass admin.site.register(ExampleModel, ExampleModelAdmin)
If you’re using an existing third party app, then you can add patch django-reversion-compare into its admin class by using the reversion_compare.helpers.patch_admin() method. For example, to add version control to the built-in User model:
from reversion_compare.helpers import patch_admin patch_admin(User)
e.g.: Add django-cms Page model:
from cms.models.pagemodel import Page from reversion_compare.helpers import patch_admin # Patch django-cms Page Model to add reversion-compare functionality: patch_admin(Page)
customize
It’s possible to change the look for every field or for a entire field type. You must only define a methods to your admin class with this name scheme:
"compare_%s" % field_name
"compare_%s" % field.get_internal_type()
If there exist no method with this name scheme, the fallback_compare() method would be used.
example for specify a compare method for a model field by name:
class YourAdmin(CompareVersionAdmin): def compare_foo_bar(self, obj_compare): """ compare the foo_bar model field """ return "%r <-> %r" % (obj_compare.value1, obj_compare.value2)
and example using patch_admin with custom version admin class:
patch_admin(User, AdminClass=YourAdmin)
screenshots
Here some screenshots of django-reversion-compare:
How to select the versions to compare:
from v0.1.0: DateTimeField compare (last update), TextField compare (content) with small changes and a ForeignKey compare (child model instance was added):
from v0.1.0: Same as above, but the are more lines changed in TextField and the ForeignKey relation was removed:
Example screenshot from v0.3.0: a many-to-many field compare (friends, hobbies):
In the first line, the m2m object has been changed.
line 2: A m2m object was deleted
line 3: A m2m object was removed from this entry (but not deleted)
line 4: This m2m object has not changed
unittests
(Unittests need django-tools)
run unittests
via setup.py:
$ cd path/to/django-reversion-compare django-reversion-compare$ ./setup.py test
via runtests.py:
$ cd path/to/django-reversion-compare django-reversion-compare$ ./runtests.py
Helpfull for writing and debugging unittests is to run a local test server with the same data. e.g.:
~$ cd path/to/django-reversion-compare/ /django-reversion-compare$ ./run_testserver.py
migration will be run and a superuser will be created. Username: test Password: 12345678
Version compatibility
Reversion-Compare |
Django |
---|---|
>=v0.5.2 |
v1.7, v1.8 |
>=v0.4 |
v1.7 |
<v0.4 |
v1.4 |
These are the unittests variants. See also: /.travis.yml Maybe other versions are compatible, too.
changelog
-
UnboundLocalError (‘version’) when creating deleted list in get_many_to_something() #41
-
One to one field custom related name fix #42 (contributed by frwickst and aemdy)
-
Update admin.py to avoid RemovedInDjango19Warning (contributed by luzfcb)
-
contributed by Samuel Spencer:
Added Django 1.8 support: pull #35
list of changes for reverse fields incorrectly includes a “deletion” for the item that was added in: issues #34
-
activate previous/next links and add unitests for them
-
refactory unittests, test with Django v1.7 and Python 2.7 & 3.4
-
Updates for django 1.7 support
Add settings.ADD_REVERSION_ADMIN
v0.3.5 - 03.01.2013:
Remove date from version string. issues 9
v0.3.4 - 20.06.2012:
Use VersionAdmin.revision_manager rather than default_revision_manager, contributed by Mark Lavin - see: pull request 7
Use logging for all debug prints, contributed by Bojan Mihelac - see: pull request 8
v0.3.3 - 11.06.2012:
Bugfix “ValueError: zero length field name in format” with Python 2.6 issues 5
v0.3.2 - 04.06.2012:
Bugfix for Python 2.6 in unified_diff(), see: AttributeError: ‘module’ object has no attribute ‘_format_range_unified’
v0.3.1 - 01.06.2012:
Bugfix: force unicode in html diff
Bugfix in unittests
v0.3.0 - 16.05.2012:
Enhanced handling of m2m changes with follow and non-follow relations.
v0.2.2 - 15.05.2012:
Compare many-to-many in the right way.
v0.2.1 - 10.05.2012:
Bugfix for models which has no m2m field: https://github.com/jedie/django-reversion-compare/commit/c8e042945a6e78e5540b6ae27666f9b0cfc94880
v0.2.0 - 09.05.2012:
many-to-many compare works, too.
v0.1.0 - 08.05.2012:
First release
v0.0.1 - 08.05.2012:
collect all compare stuff from old “diff” branch
see also: https://github.com/etianen/django-reversion/issues/147
Links
IRC |
|
Github |
|
Python Packages |
contact
Come into the conversation, besides the github communication features:
Forum |
|
IRC |
#pylucid on freenode.net (Yes, the PyLucid channel…) |
webchat |
donation
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for django-reversion-compare-0.5.5.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 06c29086639cc5e5a80e0a44e2384935a3fafab465b510ed09e30f1eccfde152 |
|
MD5 | 1b5b63e101ae136847bb0dacb815de1f |
|
BLAKE2b-256 | 11e03440a53b9bb7d357535cc49d16d88a30cfacf7a717ced96b283b53745501 |
Hashes for django_reversion_compare-0.5.5-py3.4.egg
Algorithm | Hash digest | |
---|---|---|
SHA256 | b4813f01657dbb9bb719e4955f079505f79402e3390098cad9ab6d34858e4702 |
|
MD5 | 85cfc8e2f4826c22d0211bf00952ae87 |
|
BLAKE2b-256 | 167f525ebebda11ccf06b826bf6ed70fd2a584620eb9cd278985f6ba5b17f840 |
Hashes for django_reversion_compare-0.5.5-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8e983142476a5caf1ac96f532935b8dd80f1b7f54fdd29f6d9e233b566390594 |
|
MD5 | 15a41f2cb20bb34c436eee7a1cf93124 |
|
BLAKE2b-256 | 1996cfbd11d6e1b6e5768e1a91b3bd1b93d547f985fe5aacc7d6ac0a1b67d702 |