"""

31. Validation

This is an experimental feature!

Each model instance has a validate() method that returns a dictionary of

validation errors in the instance's fields. This method has a side effect

of converting each field to its appropriate Python data type.

"""

from django.db import models

class Person(models.Model):

    is_child = models.BooleanField()

    name = models.CharField(maxlength=20)

    birthdate = models.DateField()

    favorite_moment = models.DateTimeField()

    email = models.EmailField()

    def __str__(self):

        return self.name

__test__ = {'API_TESTS':"""

>>> import datetime

>>> valid_params = {

...     'is_child': True,

...     'name': 'John',

...     'birthdate': datetime.date(2000, 5, 3),

...     'favorite_moment': datetime.datetime(2002, 4, 3, 13, 23),

...     'email': 'john@example.com'

... }

>>> p = Person(**valid_params)

>>> p.validate()

{}

>>> p = Person(**dict(valid_params, id='23'))

>>> p.validate()

{}

>>> p.id

23

>>> p = Person(**dict(valid_params, id='foo'))

>>> p.validate()

{'id': ['This value must be an integer.']}

>>> p = Person(**dict(valid_params, id=None))

>>> p.validate()

{}

>>> repr(p.id)

'None'

>>> p = Person(**dict(valid_params, is_child='t'))

>>> p.validate()

{}

>>> p.is_child

True

>>> p = Person(**dict(valid_params, is_child='f'))

>>> p.validate()

{}

>>> p.is_child

False

>>> p = Person(**dict(valid_params, is_child=True))

>>> p.validate()

{}

>>> p.is_child

True

>>> p = Person(**dict(valid_params, is_child=False))

>>> p.validate()

{}

>>> p.is_child

False

>>> p = Person(**dict(valid_params, is_child='foo'))

>>> p.validate()

{'is_child': ['This value must be either True or False.']}

>>> p = Person(**dict(valid_params, name=u'Jose'))

>>> p.validate()

{}

>>> p.name

u'Jose'

>>> p = Person(**dict(valid_params, name=227))

>>> p.validate()

{}

>>> p.name

'227'

>>> p = Person(**dict(valid_params, birthdate=datetime.date(2000, 5, 3)))

>>> p.validate()

{}

>>> p.birthdate

datetime.date(2000, 5, 3)

>>> p = Person(**dict(valid_params, birthdate=datetime.datetime(2000, 5, 3)))

>>> p.validate()

{}

>>> p.birthdate

datetime.date(2000, 5, 3)

>>> p = Person(**dict(valid_params, birthdate='2000-05-03'))

>>> p.validate()

{}

>>> p.birthdate

datetime.date(2000, 5, 3)

>>> p = Person(**dict(valid_params, birthdate='2000-5-3'))

>>> p.validate()

{}

>>> p.birthdate

datetime.date(2000, 5, 3)

>>> p = Person(**dict(valid_params, birthdate='foo'))

>>> p.validate()

{'birthdate': ['Enter a valid date in YYYY-MM-DD format.']}

>>> p = Person(**dict(valid_params, favorite_moment=datetime.datetime(2002, 4, 3, 13, 23)))

>>> p.validate()

{}

>>> p.favorite_moment

datetime.datetime(2002, 4, 3, 13, 23)

>>> p = Person(**dict(valid_params, favorite_moment=datetime.datetime(2002, 4, 3)))

>>> p.validate()

{}

>>> p.favorite_moment

datetime.datetime(2002, 4, 3, 0, 0)

>>> p = Person(**dict(valid_params, email='john@example.com'))

>>> p.validate()

{}

>>> p.email

'john@example.com'

>>> p = Person(**dict(valid_params, email=u'john@example.com'))

>>> p.validate()

{}

>>> p.email

u'john@example.com'

>>> p = Person(**dict(valid_params, email=22))

>>> p.validate()

{'email': ['Enter a valid e-mail address.']}

# Make sure that Date and DateTime return validation errors and don't raise Python errors.

>>> Person(name='John Doe', is_child=True, email='abc@def.com').validate()

{'favorite_moment': ['This field is required.'], 'birthdate': ['This field is required.']}

"""}