Tracking dirty fields on a Django model instance.
Project description
Tracking dirty fields on a Django model instance. Dirty means that field in-memory and database values are different.
This package is compatible and tested with the following Python & Django versions:
Django |
Python |
---|---|
1.11, 2.0, 2.1 |
3.6, 3.7 |
2.2, 3.0, 3.1, 3.2 |
3.6, 3.7, 3.8 ,3.9 |
Install
$ pip install django-dirtyfields
Usage
To use django-dirtyfields, you need to:
Inherit from DirtyFieldsMixin in the Django model you want to track.
from django.db import models from dirtyfields import DirtyFieldsMixin class ModelTest(DirtyFieldsMixin, models.Model): """A simple test model to test dirty fields mixin with""" boolean = models.BooleanField(default=True) characters = models.CharField(blank=True, max_length=80)
Use one of these 2 functions on a model instance to know if this instance is dirty, and get the dirty fields:
is_dirty()
get_dirty_fields()
Example
>>> from tests.models import ModelTest
>>> tm = ModelTest.objects.create(boolean=True,characters="testing")
>>> tm.is_dirty()
False
>>> tm.get_dirty_fields()
{}
>>> tm.boolean = False
>>> tm.is_dirty()
True
>>> tm.get_dirty_fields()
{'boolean': True}
Consult the full documentation for more information.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for django_dirtyfields-1.7.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ed8d780d439281372ca1dd301b21d6536b950dad3c32f95740e8236c0ed423bc |
|
MD5 | 9248b29d835d11c15cf752ca764b97b3 |
|
BLAKE2b-256 | 5cc0aaf3e82a1b6dff5ebf65f7cc92697d9bc10939bae02ac227b2f83137fd9e |