diff --git a/docs/utilities.rst b/docs/utilities.rst index e8d22d2..9a25061 100644 --- a/docs/utilities.rst +++ b/docs/utilities.rst @@ -164,6 +164,17 @@ Returns ``True`` if the given field has changed since the last save: >>> a.tracker.has_changed('body') False +The ``has_changed`` method expects a single field. To check multiple fields: + +.. code-block:: pycon + + >>> a = Post.objects.create(title='First Post', description='First Description') + >>> a.title = 'Welcome' + >>> any(a.tracker.has_changed(field) for field in ('title', 'description')): + True + >>> all(a.tracker.has_changed(field) for field in ('title', 'description')): + False + The ``has_changed`` method relies on ``previous`` to determine whether a field's values has changed.