thirdparty/google_appengine/lib/django/tests/modeltests/choices/models.py
author Sverre Rabbelier <srabbelier@gmail.com>
Mon, 30 Mar 2009 22:38:08 +0000
changeset 2036 d23379c80b48
parent 109 620f9b141567
permissions -rwxr-xr-x
Use ugettext and shorter variable names for inellegible list We use the abbreviated variable names in other list views as well to make it doable to work with them (with the meaning of the abbreviation explained with a comment after the definition). Bring the inellegible list up to date with this. Patch by: Sverre Rabbelier

"""
21. Specifying 'choices' for a field

Most fields take a ``choices`` parameter, which should be a tuple of tuples
specifying which are the valid values for that field.

For each field that has ``choices``, a model instance gets a
``get_fieldname_display()`` method, where ``fieldname`` is the name of the
field. This method returns the "human-readable" value of the field.
"""

from django.db import models

GENDER_CHOICES = (
    ('M', 'Male'),
    ('F', 'Female'),
)

class Person(models.Model):
    name = models.CharField(maxlength=20)
    gender = models.CharField(maxlength=1, choices=GENDER_CHOICES)

    def __str__(self):
        return self.name

__test__ = {'API_TESTS':"""
>>> a = Person(name='Adrian', gender='M')
>>> a.save()
>>> s = Person(name='Sara', gender='F')
>>> s.save()
>>> a.gender
'M'
>>> s.gender
'F'
>>> a.get_gender_display()
'Male'
>>> s.get_gender_display()
'Female'
"""}