52 lines
1.8 KiB
Python
52 lines
1.8 KiB
Python
"""
|
|
6. Specifying ordering
|
|
|
|
Specify default ordering for a model using the ``ordering`` attribute, which
|
|
should be a list or tuple of field names. This tells Django how to order the
|
|
results of ``get_list()`` and other similar functions.
|
|
|
|
If a field name in ``ordering`` starts with a hyphen, that field will be
|
|
ordered in descending order. Otherwise, it'll be ordered in ascending order.
|
|
The special-case field name ``"?"`` specifies random order.
|
|
|
|
The ordering attribute is not required. If you leave it off, ordering will be
|
|
undefined -- not random, just undefined.
|
|
"""
|
|
|
|
from django.core import meta
|
|
|
|
class Article(meta.Model):
|
|
fields = (
|
|
meta.CharField('headline', maxlength=100),
|
|
meta.DateTimeField('pub_date'),
|
|
)
|
|
ordering = ('-pub_date', 'headline')
|
|
|
|
def __repr__(self):
|
|
return self.headline
|
|
|
|
API_TESTS = """
|
|
# Create a couple of Articles.
|
|
>>> from datetime import datetime
|
|
>>> a1 = articles.Article(id=None, headline='Article 1', pub_date=datetime(2005, 7, 26))
|
|
>>> a1.save()
|
|
>>> a2 = articles.Article(id=None, headline='Article 2', pub_date=datetime(2005, 7, 27))
|
|
>>> a2.save()
|
|
>>> a3 = articles.Article(id=None, headline='Article 3', pub_date=datetime(2005, 7, 27))
|
|
>>> a3.save()
|
|
>>> a4 = articles.Article(id=None, headline='Article 4', pub_date=datetime(2005, 7, 28))
|
|
>>> a4.save()
|
|
|
|
# By default, articles.get_list() orders by pub_date descending, then
|
|
# headline ascending.
|
|
>>> articles.get_list()
|
|
[Article 4, Article 2, Article 3, Article 1]
|
|
|
|
# Override ordering with order_by, which is in the same format as the ordering
|
|
# attribute in models.
|
|
>>> articles.get_list(order_by=['headline'])
|
|
[Article 1, Article 2, Article 3, Article 4]
|
|
>>> articles.get_list(order_by=['pub_date', '-headline'])
|
|
[Article 1, Article 3, Article 2, Article 4]
|
|
"""
|