Ticket #7526: models.py

"""
4. Many-to-one relationships

To define a many-to-one relationship, use ``ForeignKey()`` .
"""

from django.db import models

class Reporter(models.Model):
    first_name = models.CharField(max_length=30)
    last_name = models.CharField(max_length=30)
    email = models.EmailField()

    def __unicode__(self):
        return u"%s %s" % (self.first_name, self.last_name)

class Subject(models.Model):
    first_name = models.CharField(max_length=30)
    last_name = models.CharField(max_length=30)
    email = models.EmailField()

    def __unicode__(self):
        return u"%s %s" % (self.first_name, self.last_name)

class Article(models.Model):
    headline = models.CharField(max_length=100)
    pub_date = models.DateField()
    reporter = models.ForeignKey(Reporter, core=True, null=True, blank=True)
    subject = models.ForeignKey(Subject, core=True, null=True, blank=True)

    def __unicode__(self):
        return self.headline

    class Meta:
        ordering = ('reporter__last_name','subject__last_name')

__test__ = {'API_TESTS':"""
# Create a few Reporters.
>>> r = Reporter(first_name='John', last_name='Smith', email='john@example.com')
>>> r.save()

>>> r2 = Reporter(first_name='Paul', last_name='Jones', email='paul@example.com')
>>> r2.save()

# Create an Article.
>>> from datetime import datetime
>>> a = Article(id=None, headline="This is a test", pub_date=datetime(2005, 7, 27), reporter=r)
>>> a.save()

>>> len(Article.objects.all())
1

>>> Article.objects.all().count()
1

>>> Article.objects.filter(subject=None)
[<Article: This is a test>]

# Alternative syntax
>>> Article.objects.filter(subject__isnull=True)
[<Article: This is a test>]


"""}