[1.2.X] Migrate get_latest doctests. Thanks to Alex Gaynor.

    def __unicode__(self):

        return self.name

__test__ = {'API_TESTS':"""

# Because no Articles exist yet, latest() raises ArticleDoesNotExist.

>>> Article.objects.latest()

Traceback (most recent call last):

    ...

DoesNotExist: Article matching query does not exist.

# Create a couple of Articles.

>>> from datetime import datetime

>>> a1 = Article(headline='Article 1', pub_date=datetime(2005, 7, 26), expire_date=datetime(2005, 9, 1))

>>> a1.save()

>>> a2 = Article(headline='Article 2', pub_date=datetime(2005, 7, 27), expire_date=datetime(2005, 7, 28))

>>> a2.save()

>>> a3 = Article(headline='Article 3', pub_date=datetime(2005, 7, 27), expire_date=datetime(2005, 8, 27))

>>> a3.save()

>>> a4 = Article(headline='Article 4', pub_date=datetime(2005, 7, 28), expire_date=datetime(2005, 7, 30))

>>> a4.save()

# Get the latest Article.

>>> Article.objects.latest()

<Article: Article 4>

# Get the latest Article that matches certain filters.

>>> Article.objects.filter(pub_date__lt=datetime(2005, 7, 27)).latest()

<Article: Article 1>

# Pass a custom field name to latest() to change the field that's used to

# determine the latest object.

>>> Article.objects.latest('expire_date')

<Article: Article 1>

>>> Article.objects.filter(pub_date__gt=datetime(2005, 7, 26)).latest('expire_date')

<Article: Article 3>

# You can still use latest() with a model that doesn't have "get_latest_by"

# set -- just pass in the field name manually.

>>> p1 = Person(name='Ralph', birthday=datetime(1950, 1, 1))

>>> p1.save()

>>> p2 = Person(name='Stephanie', birthday=datetime(1960, 2, 3))

>>> p2.save()

>>> Person.objects.latest()

Traceback (most recent call last):

    ...

AssertionError: latest() requires either a field_name parameter or 'get_latest_by' in the model

>>> Person.objects.latest('birthday')

<Person: Stephanie>

"""}

from datetime import datetime

from django.test import TestCase

from models import Article, Person

class LatestTests(TestCase):

    def test_latest(self):

        # Because no Articles exist yet, latest() raises ArticleDoesNotExist.

        self.assertRaises(Article.DoesNotExist, Article.objects.latest)

        a1 = Article.objects.create(

            headline="Article 1", pub_date=datetime(2005, 7, 26),

            expire_date=datetime(2005, 9, 1)

        )

        a2 = Article.objects.create(

            headline="Article 2", pub_date=datetime(2005, 7, 27),

            expire_date=datetime(2005, 7, 28)

        )

        a3 = Article.objects.create(

            headline="Article 3", pub_date=datetime(2005, 7, 27),

            expire_date=datetime(2005, 8, 27)

        )

        a4 = Article.objects.create(

            headline="Article 4", pub_date=datetime(2005, 7, 28),

            expire_date=datetime(2005, 7, 30)

        )

        # Get the latest Article.

        self.assertEqual(Article.objects.latest(), a4)

        # Get the latest Article that matches certain filters.

        self.assertEqual(

            Article.objects.filter(pub_date__lt=datetime(2005, 7, 27)).latest(),

            a1

        )

        # Pass a custom field name to latest() to change the field that's used

        # to determine the latest object.

        self.assertEqual(Article.objects.latest('expire_date'), a1)

        self.assertEqual(

            Article.objects.filter(pub_date__gt=datetime(2005, 7, 26)).latest('expire_date'),

            a3,

        )

    def test_latest_manual(self):

        # You can still use latest() with a model that doesn't have

        # "get_latest_by" set -- just pass in the field name manually.

        p1 = Person.objects.create(name="Ralph", birthday=datetime(1950, 1, 1))

        p2 = Person.objects.create(name="Stephanie", birthday=datetime(1960, 2, 3))

        self.assertRaises(AssertionError, Person.objects.latest)

        self.assertEqual(Person.objects.latest("birthday"), p2)