Skip to main content

django object tracking

Project description


PyPI PyPI Tests LGTM Grade Codecov

track when an object was created or changed and allow querying based on time and versioning (w/ django-reversion support)

HandleRefModel as a base for all your models

from django.db import models
from django_handleref.models import HandleRefModel

class Test(HandleRefModel):
    name = models.CharField(max_length=255)

Querying for modification since

It is now possible for you to see which instances of a model have been created or modified since a specific time or version

import time

# create instance
test = Test.objects.create(name="This is a test")

# keep track of time, we need this later
t = time.time()

# modifying and saving it = "Changed my mind"

# now we can use the handleref manager to retrieve it
Test.handleref.since(timestamp=t).count() # 1
Test.handleref.since(timestamp=time.time().count() #0

Soft delete

By default all models extending HandleRefModel will softdelete when their delete() method is called. Note that this currently wont work for batch deletes - as this does not call the delete() method.

test = Test.objects.get(id=1)

# querying handleref undeleted will not contain the deleted object
Test.handleref.undeleted().filter(id=1).count() #0

# querying handleref since will not contain the deleted object
Test.handleref.since(timestamp=t).filter(id=1).count() #0

# passing deleted=True to handleref since will contain the deleted object
Test.handleref.since(timestamp=t, deleted=True).filter(id=1).count() #1

# querying using the standard objects manager will contain the deleted object
Test.objects.filter(id=1).count() #1

# You may also still hard-delete by passing hard=True to delete
Test.objects.filter(id=1).count() #0

Versioning (with django-reversion)



When django-reversion is installed all your HandleRefModels will be valid for versioning.

import reversion

with reversion.create_revision():
    obj = Test.objects.create(name="This is a test")

    obj.version #1 = "Changed my mind"

    obj.version #2

Test.handleref.since(version=1).count() #1


Copyright 2015-2021 20C, LLC

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this softare except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Project details

Download files

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

Files for django-handleref, version 1.0.1
Filename, size File type Python version Upload date Hashes
Filename, size django_handleref-1.0.1-py3-none-any.whl (27.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size django-handleref-1.0.1.tar.gz (19.7 kB) File type Source Python version None Upload date Hashes View

Supported by

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