From 20d1cb33c2ec1242e16c49deb88e8c70517b2d1a Mon Sep 17 00:00:00 2001 From: Tim Graham Date: Tue, 21 Jun 2016 13:46:22 -0400 Subject: Fixed #26787 -- Documented deleting and reloading of model instance fields. Thanks Julien Hartmann for the report. --- docs/ref/models/instances.txt | 12 ++++++++++++ docs/releases/1.10.txt | 3 +++ 2 files changed, 15 insertions(+) (limited to 'docs') diff --git a/docs/ref/models/instances.txt b/docs/ref/models/instances.txt index 3b62675294..f0decc28d8 100644 --- a/docs/ref/models/instances.txt +++ b/docs/ref/models/instances.txt @@ -128,6 +128,18 @@ in the ``from_db()`` method. Refreshing objects from database ================================ +If you delete a field from a model instance, accessing it again reloads the +value from the database:: + + >>> obj = MyModel.objects.first() + >>> del obj.field + >>> obj.field # Loads the field from the database + +.. versionchanged:: 1.10 + + In older versions, accessing a deleted field raised ``AttributeError`` + instead of reloading it. + .. method:: Model.refresh_from_db(using=None, fields=None) If you need to reload a model's values from the database, you can use the diff --git a/docs/releases/1.10.txt b/docs/releases/1.10.txt index 8dd97e3da8..752684e3fa 100644 --- a/docs/releases/1.10.txt +++ b/docs/releases/1.10.txt @@ -884,6 +884,9 @@ Miscellaneous * The ``_base_manager`` and ``_default_manager`` attributes are removed from model instances. They remain accessible on the model class. +* Accessing a deleted field on a model instance, e.g. after ``del obj.field``, + reloads the field's value instead of raising ``AttributeError``. + .. _deprecated-features-1.10: Features deprecated in 1.10 -- cgit v1.3