From 7309393c3a7dea7a34a1446e102df7432c4e7357 Mon Sep 17 00:00:00 2001 From: Claude Paroz Date: Mon, 17 May 2021 09:19:18 +0200 Subject: [PATCH] Documented in_bulk behavior with nonexistent id_list items. Co-authored-by: Jacob Walls --- docs/ref/models/querysets.txt | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/ref/models/querysets.txt b/docs/ref/models/querysets.txt index 1201800567..c24079ec10 100644 --- a/docs/ref/models/querysets.txt +++ b/docs/ref/models/querysets.txt @@ -2294,7 +2294,10 @@ database query like ``count()`` would. Takes a list of field values (``id_list``) and the ``field_name`` for those values, and returns a dictionary mapping each value to an instance of the -object with the given field value. If ``id_list`` isn't provided, all objects +object with the given field value. No +:exc:`django.core.exceptions.ObjectDoesNotExist` exceptions will ever be raised +by ``in_bulk``; that is, any ``id_list`` value not matching any instance will +simply be ignored. If ``id_list`` isn't provided, all objects in the queryset are returned. ``field_name`` must be a unique field or a distinct field (if there's only one field specified in :meth:`distinct`). ``field_name`` defaults to the primary key.