Django ModelForm History

django-modelformhistory will save your modelform updates and store the human-readable values. The main goal is only to show the users what has been updated on a modelForms. If you search for a more lowlevel history app, consider using django-reversion or django-simple-history

Warning

This package is under developpement. It has poor features and may be unstable. Don't use it in production yet.

Requirements

• Django 1.10.* / Django 1.11.*
• Tested under python 2.7 and 3.6

Install

pip install django-modelformhistory

Then, add modelformhistory to INSTALLED_APPS

Usage

Inherit your ModelForm with HistoryModelFormMixin

from modelformhistory.forms import HistoryModelFormMixin

class MyModelForm(HistoryModelFormMixin, forms.ModelForm):
    pass

You can get the user that has made the change by :

• Either pass the request on the form init, then the request.user will be automatically sent to the new history Entry
• or implement a get_history_user method on your ModelForm that will return a auth.User object

TODO

• Provide generic views to see history by object, user & both
• Improve doc
• Querying models history easily
• Add more support and tests for filefield, boolean
• FR translation

ChangeLog

1.0.11 2019-06-27

• Catch Validation error and log error

1.0.9 2019-06-26

• Truncate object_repr charfield length to 200 max chars

1.0.7 2019-06-25

• Added localisation files to package

1.0.6 2019-06-19

• Remove tests from packaging

1.0.5 2019-06-19

• Added docstrings
• Added models.HistoryBaseModel.log_custom_history
• Entry.content_object is now mandatory

1.0.4 2019-06-17

• Added support for BooleanField and FileField

1.0.3 2019-06-17

• Added more coverage
• Added FR translation
• Added HistoryBaseModel

1.0 2019-06-14

• Initial Release