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 ++++++++++++ 1 file changed, 12 insertions(+) (limited to 'docs/ref/models') 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 -- cgit v1.3