django-reversion-compare

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.

	coveralls.io/r/jedie/django-reversion-compare
	travis-ci.org/jedie/django-reversion-compare
	requires.io/github/jedie/django-reversion-compare/requirements/

Installation

Just use:

pip install django-reversion-compare

Optionally you can install google-diff-match-patch, otherwise difflib would be used. The easiest way is 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 comparison 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 is no method with this name scheme, the fallback_compare() method will be used.

An example for specifying 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)

Class Based View

Beyond the Admin views, you can also create a Class Based View for displaying and comparing version differences. This is a single class-based-view that either displays the list of versions to select for an object or displays both the versions and their differences (if the versions to be compared have been selected). This class can be used just like a normal DetailView:

Inherit from it in your class and add a model (or queryset), for example:

from reversion_compare.views import HistoryCompareDetailView

class SimpleModelHistoryCompareView(HistoryCompareDetailView):
    model = SimpleModel

Then, assign that CBV to a url, for example:

url(r'^test_view/(?P<pk>\d+)$', views.SimpleModelHistoryCompareView.as_view() ),

Last step, you need to create a template to display both the version select form and the changes part (if the form is submitted). An example template is the following:

<style type="text/css">
/* minimal style for the diffs */
del, ins {
    color: #000;
    text-decoration: none;
}
del { background-color: #ffe6e6; }
ins { background-color: #e6ffe6; }
sup.follow { color: #5555ff; }
</style>

{% include "reversion-compare/action_list_partial.html"  %}
{% if request.GET.version_id1 %}
    {% include "reversion-compare/compare_partial.html"  %}
    {% include "reversion-compare/compare_links_partial.html"  %}
{% endif %}

Beyond the styling, you should include:

reversion-compare/action_list_partial.html partial template to display the version select form
reversion-compare/compare_partial.html partial template to display the actual version
reversion-compare/compare_links_partial.html to include previous/next comparison links

compare_partial.html and compare_links_partial.html will show the compare-related information so it’s better to display them only when the select-versions-tocompare-form has been submitted. If you want more control on the appearence of your templates you can check the above partials to understand how the availabble context variables are used and override them completely.

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-reversion	Django	Python
v0.8.x	v2.0	v1.8, v1.10, 1.11	v2.7, v3.4, v3.5, v3.6 (only with Django 1.11)
>=v0.7.2	v2.0	v1.8, v1.9, v1.10	v2.7, v3.4, v3.5
v0.7.x	v2.0	v1.8, v1.9	v2.7, v3.4, v3.5
v0.6.x	v1.9, v1.10	v1.8, v1.9	v2.7, v3.4, v3.5
>=v0.5.2	v1.9	v1.7, v1.8	v2.7, v3.4
>=v0.4	v1.8	v1.7	v2.7, v3.4
<v0.4	v1.6	v1.4	v2.7

These are the unittests variants. See also: /.travis.yml Maybe other versions are compatible, too.

Changelog

v0.8.1 - 02.10.2017:
- Add added polish translation contributed by w4rri0r3k
- Bugfix “Django>=1.11” in setup.py
v0.8.0 - 17.08.2017:
- Run tests with Django v1.11 and drop tests with Django v1.9
v0.7.5 - 24.04.2017:
- Using the ‘render’ function to ensure the execution of context processors properly contributed by Rodrigo Pinheiro Marques de Araújo
v0.7.4 - 10.04.2017:
- Bugfix for Python 2: compare unicode instead of bytes contributed by Maksim Iakovlev
- remove ‘Django20Warning’ contributed by Hugo Tácito
- Add ‘Finnish’ localisations contributed by Olli-Pekka Puolitaival
v0.7.3 - 08.02.2017:
- Fix case when model has template field which is ForeignKey contributed by Lagovas
v0.7.2 - 20.10.2016:
- Add Django v1.10 support
v0.7.1 - 29.08.2016:
- Fix #79: missing import if **ADD_REVERSION_ADMIN != True**
v0.7.0 - 25.08.2016:
- support only django-reversion >= 2.0 based on a contribution by mshannon1123
- remove internal reversion_api
- Use tox
v0.6.3 - 14.06.2016:
- Remove unused and deprecated patters contributed by codingjoe
- Fix django 1.10 warning #66 contributed by pypetey
v0.6.2 - 27.04.2016:
- Added choices field representation #63 contributed by amureki
- Check if related model has an integer as pk for ManyToMany fields. #64 contributed by logaritmisk
v0.6.1 - 16.02.2016:
- pull #61: Fix error when ManyToMany relations didn’t exist contributed by Diederik van der Boor
v0.6.0 - 03.02.2016:
- Added Dutch translation contributed by Sae X
- Add support for Django 1.9
- Nicer boolean compare: #57
- Fix #58 compare followed reverse foreign relation fields that are on a non-abstract parent class contributed by LegoStormtroopr
v0.5.6 - 23.09.2015:
- NEW: Class-Based-View to create non-admin views and greek translation contributed by Serafeim Papastefanos.
v0.5.5 - 24.07.2015:
- UnboundLocalError (‘version’) when creating deleted list in get_many_to_something() #41
v0.5.4 - 22.07.2015:
- One to one field custom related name fix #42 (contributed by frwickst and aemdy)
v0.5.3 - 13.07.2015:
- Update admin.py to avoid RemovedInDjango19Warning (contributed by luzfcb)
v0.5.2 - 14.04.2015:
- 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
v0.5.1 - 28.02.2015:
- activate previous/next links and add unitests for them
v0.5.0 - 27.02.2015:
- refactory unittests, test with Django v1.7 and Python 2.7 & 3.4
v0.4.0 - 02.02.2015:
- 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	#pylucid on freenode.net
Github	http://github.com/jedie/django-reversion-compare
Python Packages	http://pypi.python.org/pypi/django-reversion-compare/

Contact

Come into the conversation, besides the Github communication features:

IRC	#pylucid on freenode.net (Yes, the PyLucid channel…)
webchat	http://webchat.freenode.net/?channels=pylucid

Donation

Metadata

Release files for django-reversion-compare 0.8.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for django-reversion-compare 0.8.1
File	Size	Uploaded
django-reversion-compare-0.8.1.tar.gz	55.8 kB	Oct 2, 2017	Details

Built distributions (wheels)

Table of built distributions (wheels) for django-reversion-compare 0.8.1
File	Interpreter	ABI	Platform	Reset
django_reversion_compare-0.8.1-py3.5.egg 70.9 kB Oct 2, 2017	Legacy Egg format	-	-	Details
django_reversion_compare-0.8.1-py2.py3-none-any.whl 80.1 kB Oct 2, 2017	Python 3, Python 2	none	any	Details

Total release size: 206.9 kB

Release files / django-reversion-compare-0.8.1.tar.gz

Download URL	django-reversion-compare-0.8.1.tar.gz
Size	55.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`133e703fb7805d7c2d3b500f264116c0c444c29e8e780223b67e490ec7ee41fc`
BLAKE2b-256 checksum How to use checksums	`a69434f7e1c4b9eb50414f6992efb87da2ada32f5524fca6889980201d25404f`
Upload date	Oct 2, 2017
Uploaded using Trusted Publishing? What is trusted publishing?	No

Release files / django_reversion_compare-0.8.1-py3.5.egg

Download URL	django_reversion_compare-0.8.1-py3.5.egg
Size	70.9 kB
Tags	Egg
SHA-256 checksum How to use checksums	`2b2fcdac7f7f6877e320f022852890248520be70d8f473c9139bdc6817fdd675`
BLAKE2b-256 checksum How to use checksums	`42f4f62e894bcb805356e792f5bcc8617b3b2b9aa5b281dfb71a00ca97ab0d6d`
Upload date	Oct 2, 2017
Uploaded using Trusted Publishing? What is trusted publishing?	No

Release files / django_reversion_compare-0.8.1-py2.py3-none-any.whl

Download URL	django_reversion_compare-0.8.1-py2.py3-none-any.whl
Size	80.1 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`f9952e6170fee426decfc45b9529c75dd884c49b2d36c13b563fa1128ec982ba`
BLAKE2b-256 checksum How to use checksums	`56d461a8ec9bd735cc601a29aae2d40dc356b41d491bd484209d1c2689766007`
Upload date	Oct 2, 2017
Uploaded using Trusted Publishing? What is trusted publishing?	No