Skip to main content

No project description provided

Project description

Django ModelForm History

Build Status Coverage Status

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


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


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


pip install django-modelformhistory

Then, add modelformhistory to INSTALLED_APPS


Inherit your ModelForm with HistoryModelFormMixin

from modelformhistory.forms import HistoryModelFormMixin

class MyModelForm(HistoryModelFormMixin, forms.ModelForm):

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


  • 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


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

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release. See tutorial on generating distribution archives.

Built Distributions

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page