Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Yet another approach to provide soft (logical) delete or masking (thrashing) django models instead of deleting them physically from db.

Project description

Django Permanent

Yet another approach to provide soft (logical) delete or masking (thrashing) django models instead of deleting them physically from db.


To create a non-deletable model just inherit it from PermanentModel:

class MyModel(PermanentModel):

It automatically changes delete behaviour to hide objects instead of deleting them:

>>> a = MyModel.objects.create(pk=1)
>>> b = MyModel.objects.create(pk=2)
>>> MyModel.objects.count()
>>> a.delete()
>>> MyModel.objects.count()

To recover a deleted object just call its restore method:

>>> a.restore()
>>> MyModel.objects.count()

Use the force kwarg to enforce physical deletion:

>>> a.delete(force=True) # Will act as the default django delete
>>> MyModel._base_manager.count()

If you need to restore a deleted object instead of re-creating the same one use the restore_on_create attribute:

class MyModel(PermanentModel):
    class Permanent:
      restore_on_create = True

In this case QuerySet provides check existence of same attribute objects and restores them if they’ve been deleted, creating new ones if not.


It changes the default model manager to ignore deleted objects, adding a deleted_objects manager to see them instead:

>>> MyModel.objects.count()
>>> a.delete()
>>> MyModel.objects.count()
>>> MyModel.deleted_objects.count()
>>> MyModel.all_objects.count()
>>> MyModel._base_manager.count()


The QuerySet.delete method will act as the default django delete, with one exception - objects of models subclassing PermanentModel will be marked as deleted; the rest will be deleted physically:

>>> MyModel.objects.all().delete()

You can still force django query set physical deletion:

>>> MyModel.objects.all().delete(force=True)

Using custom querysets

  1. Inherit your query set from PermanentQuerySet:

    class ServerFileQuerySet(PermanentQuerySet)
  2. Wrap PermanentQuerySet or DeletedQuerySet in you model manager declaration:

    class MyModel(PermanentModel)
        objects = MultiPassThroughManager(ServerFileQuerySet, NonDeletedQuerySet)
        deleted_objects = MultiPassThroughManager(ServerFileQuerySet, DeletedQuerySet)
        all_objects = MultiPassThroughManager(ServerFileQuerySet, PermanentQuerySet)

Method get_restore_or_create

  1. Check for existence of the object.
  2. Restore it if it was deleted.
  3. Create a new one, if it was never created.

Field name

The default field named is ‘removed’, but you can override it with the PERMANENT_FIELD variable in



  • Django 1.7+
  • Python 2.7, 3.4+

Project details

Release history Release notifications

This version


Download files

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

Files for django-permanent-model, version 1.1.7
Filename, size File type Python version Upload date Hashes
Filename, size django-permanent-model-1.1.7.tar.gz (10.2 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 SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page