django/tests/testapp/models/repr.py

"""
2. Adding __repr__() to models

Although it's not a strict requirement, each model should have a ``__repr__()``
method to return a "human-readable" representation of the object. Do this not
only for your own sanity when dealing with the interactive prompt, but also
because objects' representations are used throughout Django's
automatically-generated admin.
"""

from django.core import meta

class Article(meta.Model):
    headline = meta.CharField(maxlength=100)
    pub_date = meta.DateTimeField()

    def __repr__(self):
        return self.headline

API_TESTS = """
# Create an Article.
>>> from datetime import datetime
>>> a = articles.Article(headline='Area man programs in Python', pub_date=datetime(2005, 7, 28))
>>> a.save()

>>> repr(a)
'Area man programs in Python'

>>> a
Area man programs in Python
"""