From babe9e64a6172b09e7f70e8d8f01e67f2cb4176d Mon Sep 17 00:00:00 2001 From: Irindu Indeera Date: Tue, 11 Jul 2017 23:45:17 +0530 Subject: [PATCH] Fixed #28352 -- Corrected QuerySet.values_list() return type in docs examples. --- docs/ref/models/conditional-expressions.txt | 8 ++++---- docs/ref/models/querysets.txt | 10 +++++----- docs/topics/db/models.txt | 2 +- 3 files changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/ref/models/conditional-expressions.txt b/docs/ref/models/conditional-expressions.txt index 4331d1185e..af134d4561 100644 --- a/docs/ref/models/conditional-expressions.txt +++ b/docs/ref/models/conditional-expressions.txt @@ -110,7 +110,7 @@ A simple example:: ... output_field=CharField(), ... ), ... ).values_list('name', 'discount') - [('Jane Doe', '0%'), ('James Smith', '5%'), ('Jack Black', '10%')] + ``Case()`` accepts any number of ``When()`` objects as individual arguments. Other options are provided using keyword arguments. If none of the conditions @@ -132,7 +132,7 @@ the ``Client`` has been with us, we could do so using lookups:: ... output_field=CharField(), ... ) ... ).values_list('name', 'discount') - [('Jane Doe', '5%'), ('James Smith', '0%'), ('Jack Black', '10%')] + .. note:: @@ -153,7 +153,7 @@ registered more than a year ago:: ... When(account_type=Client.PLATINUM, then=a_year_ago), ... ), ... ).values_list('name', 'account_type') - [('Jack Black', 'P')] + Advanced queries ================ @@ -182,7 +182,7 @@ their registration dates. We can do this using a conditional expression and the ... ), ... ) >>> Client.objects.values_list('name', 'account_type') - [('Jane Doe', 'G'), ('James Smith', 'R'), ('Jack Black', 'P')] + Conditional aggregation ----------------------- diff --git a/docs/ref/models/querysets.txt b/docs/ref/models/querysets.txt index d8d063a7a5..64e48c3ff5 100644 --- a/docs/ref/models/querysets.txt +++ b/docs/ref/models/querysets.txt @@ -634,20 +634,20 @@ respective field or expression passed into the ``values_list()`` call — so the first item is the first field, etc. For example:: >>> Entry.objects.values_list('id', 'headline') - [(1, 'First entry'), ...] + >>> from django.db.models.functions import Lower >>> Entry.objects.values_list('id', Lower('headline')) - [(1, 'first entry'), ...] + If you only pass in a single field, you can also pass in the ``flat`` parameter. If ``True``, this will mean the returned results are single values, rather than one-tuples. An example should make the difference clearer:: >>> Entry.objects.values_list('id').order_by('id') - [(1,), (2,), (3,), ...] + >>> Entry.objects.values_list('id', flat=True).order_by('id') - [1, 2, 3, ...] + It is an error to pass in ``flat`` when there is more than one field. @@ -682,7 +682,7 @@ Similarly, when querying a reverse foreign key, ``None`` appears for entries not having any author:: >>> Entry.objects.values_list('authors') - [('Noam Chomsky',), ('George Orwell',), (None,)] + .. versionchanged:: 1.11 diff --git a/docs/topics/db/models.txt b/docs/topics/db/models.txt index e162c6df01..2c8a47852f 100644 --- a/docs/topics/db/models.txt +++ b/docs/topics/db/models.txt @@ -229,7 +229,7 @@ ones: >>> fruit.name = 'Pear' >>> fruit.save() >>> Fruit.objects.values_list('name', flat=True) - ['Apple', 'Pear'] + :attr:`~Field.unique` If ``True``, this field must be unique throughout the table.