getListContentForData function added to lists helper. It allows to manually set a list of entities which is to be displayed on the view. Previously, the only function was getListContent, but it retrived data on its own by a single query. The new function can be useful whenever it is impossible or very awkward to obtain entities in such a way (for example more sophisticated SQL statements). Additionally, the getListContent function is reconstructed so that it collects the data first and then calls getListContentForData.

     1

"""

     2

>>> from django.contrib.sites.models import Site

     3

>>> from django.conf import settings

     4

>>> Site(id=settings.SITE_ID, domain="example.com", name="example.com").save()

     5

     6

>>> # Make sure that get_current() does not return a deleted Site object.

     7

>>> s = Site.objects.get_current()

     8

>>> isinstance(s, Site)

     9

True

    10

    11

>>> s.delete()

    12

>>> Site.objects.get_current()

    13

Traceback (most recent call last):

    14

...

    15

DoesNotExist: Site matching query does not exist.

    16

"""