From 130192b12b63357a8f5ff448cd0edfa5a8094909 Mon Sep 17 00:00:00 2001 From: Pavel Savchenko Date: Mon, 21 Jan 2019 16:13:42 +0100 Subject: [PATCH] Corrected GenericRelation's related_query_name manual lookup example. And changed related_query_name to a singular noun. --- docs/ref/contrib/contenttypes.txt | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/ref/contrib/contenttypes.txt b/docs/ref/contrib/contenttypes.txt index 8e6c7cab821..70eefe51174 100644 --- a/docs/ref/contrib/contenttypes.txt +++ b/docs/ref/contrib/contenttypes.txt @@ -394,21 +394,21 @@ be used to retrieve their associated ``TaggedItems``:: Defining :class:`~django.contrib.contenttypes.fields.GenericRelation` with ``related_query_name`` set allows querying from the related object:: - tags = GenericRelation(TaggedItem, related_query_name='bookmarks') + tags = GenericRelation(TaggedItem, related_query_name='bookmark') This enables filtering, ordering, and other query operations on ``Bookmark`` from ``TaggedItem``:: >>> # Get all tags belonging to bookmarks containing `django` in the url - >>> TaggedItem.objects.filter(bookmarks__url__contains='django') + >>> TaggedItem.objects.filter(bookmark__url__contains='django') , ]> -Of course, if you don't add the reverse relationship, you can do the +Of course, if you don't add the ``related_query_name``, you can do the same types of lookups manually:: - >>> b = Bookmark.objects.get(url='https://www.djangoproject.com/') - >>> bookmark_type = ContentType.objects.get_for_model(b) - >>> TaggedItem.objects.filter(content_type__pk=bookmark_type.id, object_id=b.id) + >>> bookmarks = Bookmark.objects.filter(url__contains='django') + >>> bookmark_type = ContentType.objects.get_for_model(Bookmark) + >>> TaggedItem.objects.filter(content_type__pk=bookmark_type.id, object_id__in=bookmarks) , ]> Just as :class:`~django.contrib.contenttypes.fields.GenericForeignKey`