Skip to main content

An extension to the Django web framework that provides version control for model instances.

Project description


django-model-auditor is a Python library for maintaining versions of your django model instances.


Use the package manager pip to install foobar.

pip install django-model-auditor


  1. Add audits in INSTALLED_APPS inside of your django project
  1. run migration to create auditlog model
python migrate
  1. Change metaclass of model(for which audit logs are needed) to ModelHistoryMeta
from audits.models import ModelHistoryMeta
from django.db import models

class ExampleModel(models.Model, metaclass=ModelHistoryMeta):
    field1 = models.CharField(max_length=100)
    field2 = models.CharField(max_length=100)
  1. Example
import ExampleModel
object = ExampleModel(field1="foo", field2="bar") #will create an entry in auditlog model

object.field1 = "Foo"
object.field2 = "Bar" #will create another entry in auditlog model

object.field1 = "FOO"
object.field2 = "BAR" #will create another entry in auditlog model

#To get previous versions of the object 
previous_versions = AuditLog.get_prev_versions(object, limit=2)

#By default get_prev_versions return only last_prev_version to 
#get more versions we need to specify limit

latest_prev_version = previous_versions[0]
print("%s %s"%(latest_prev_version.field1, latest_prev_version.field2)) # "Foo","Bar"

prev_to_prev_version = previous_versions[1]
print("%s %s"%(prev_to_prev_version.field1, prev_to_prev_version.field2)) # "foo","bar"


Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.



Project details

Release history Release notifications

Download files

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

Files for django-model-auditor, version 0.0.4
Filename, size File type Python version Upload date Hashes
Filename, size django_model_auditor-0.0.4-py3-none-any.whl (4.7 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size django-model-auditor-0.0.4.tar.gz (3.7 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page