# -*- coding: utf-8 -*- tests = r""" >>> from django.newforms import * >>> from django.newforms.widgets import RadioFieldRenderer >>> import datetime >>> import time >>> import re >>> try: ... from decimal import Decimal ... except ImportError: ... from django.utils._decimal import Decimal ########## # Fields # ########## Each Field class does some sort of validation. Each Field has a clean() method, which either raises django.newforms.ValidationError or returns the "clean" data -- usually a Unicode object, but, in some rare cases, a list. Each Field's __init__() takes at least these parameters: required -- Boolean that specifies whether the field is required. True by default. widget -- A Widget class, or instance of a Widget class, that should be used for this Field when displaying it. Each Field has a default Widget that it'll use if you don't specify this. In most cases, the default widget is TextInput. label -- A verbose name for this field, for use in displaying this field in a form. By default, Django will use a "pretty" version of the form field name, if the Field is part of a Form. initial -- A value to use in this Field's initial display. This value is *not* used as a fallback if data isn't given. Other than that, the Field subclasses have class-specific options for __init__(). For example, CharField has a max_length option. # CharField ################################################################### >>> f = CharField() >>> f.clean(1) u'1' >>> f.clean('hello') u'hello' >>> f.clean(None) Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean('') Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean([1, 2, 3]) u'[1, 2, 3]' >>> f = CharField(required=False) >>> f.clean(1) u'1' >>> f.clean('hello') u'hello' >>> f.clean(None) u'' >>> f.clean('') u'' >>> f.clean([1, 2, 3]) u'[1, 2, 3]' CharField accepts an optional max_length parameter: >>> f = CharField(max_length=10, required=False) >>> f.clean('12345') u'12345' >>> f.clean('1234567890') u'1234567890' >>> f.clean('1234567890a') Traceback (most recent call last): ... ValidationError: [u'Ensure this value has at most 10 characters (it has 11).'] CharField accepts an optional min_length parameter: >>> f = CharField(min_length=10, required=False) >>> f.clean('') u'' >>> f.clean('12345') Traceback (most recent call last): ... ValidationError: [u'Ensure this value has at least 10 characters (it has 5).'] >>> f.clean('1234567890') u'1234567890' >>> f.clean('1234567890a') u'1234567890a' >>> f = CharField(min_length=10, required=True) >>> f.clean('') Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean('12345') Traceback (most recent call last): ... ValidationError: [u'Ensure this value has at least 10 characters (it has 5).'] >>> f.clean('1234567890') u'1234567890' >>> f.clean('1234567890a') u'1234567890a' # IntegerField ################################################################ >>> f = IntegerField() >>> f.clean('') Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean(None) Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean('1') 1 >>> isinstance(f.clean('1'), int) True >>> f.clean('23') 23 >>> f.clean('a') Traceback (most recent call last): ... ValidationError: [u'Enter a whole number.'] >>> f.clean(42) 42 >>> f.clean(3.14) Traceback (most recent call last): ... ValidationError: [u'Enter a whole number.'] >>> f.clean('1 ') 1 >>> f.clean(' 1') 1 >>> f.clean(' 1 ') 1 >>> f.clean('1a') Traceback (most recent call last): ... ValidationError: [u'Enter a whole number.'] >>> f = IntegerField(required=False) >>> f.clean('') >>> repr(f.clean('')) 'None' >>> f.clean(None) >>> repr(f.clean(None)) 'None' >>> f.clean('1') 1 >>> isinstance(f.clean('1'), int) True >>> f.clean('23') 23 >>> f.clean('a') Traceback (most recent call last): ... ValidationError: [u'Enter a whole number.'] >>> f.clean('1 ') 1 >>> f.clean(' 1') 1 >>> f.clean(' 1 ') 1 >>> f.clean('1a') Traceback (most recent call last): ... ValidationError: [u'Enter a whole number.'] IntegerField accepts an optional max_value parameter: >>> f = IntegerField(max_value=10) >>> f.clean(None) Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean(1) 1 >>> f.clean(10) 10 >>> f.clean(11) Traceback (most recent call last): ... ValidationError: [u'Ensure this value is less than or equal to 10.'] >>> f.clean('10') 10 >>> f.clean('11') Traceback (most recent call last): ... ValidationError: [u'Ensure this value is less than or equal to 10.'] IntegerField accepts an optional min_value parameter: >>> f = IntegerField(min_value=10) >>> f.clean(None) Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean(1) Traceback (most recent call last): ... ValidationError: [u'Ensure this value is greater than or equal to 10.'] >>> f.clean(10) 10 >>> f.clean(11) 11 >>> f.clean('10') 10 >>> f.clean('11') 11 min_value and max_value can be used together: >>> f = IntegerField(min_value=10, max_value=20) >>> f.clean(None) Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean(1) Traceback (most recent call last): ... ValidationError: [u'Ensure this value is greater than or equal to 10.'] >>> f.clean(10) 10 >>> f.clean(11) 11 >>> f.clean('10') 10 >>> f.clean('11') 11 >>> f.clean(20) 20 >>> f.clean(21) Traceback (most recent call last): ... ValidationError: [u'Ensure this value is less than or equal to 20.'] # FloatField ################################################################## >>> f = FloatField() >>> f.clean('') Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean(None) Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean('1') 1.0 >>> isinstance(f.clean('1'), float) True >>> f.clean('23') 23.0 >>> f.clean('3.14') 3.1400000000000001 >>> f.clean(3.14) 3.1400000000000001 >>> f.clean(42) 42.0 >>> f.clean('a') Traceback (most recent call last): ... ValidationError: [u'Enter a number.'] >>> f.clean('1.0 ') 1.0 >>> f.clean(' 1.0') 1.0 >>> f.clean(' 1.0 ') 1.0 >>> f.clean('1.0a') Traceback (most recent call last): ... ValidationError: [u'Enter a number.'] >>> f = FloatField(required=False) >>> f.clean('') >>> f.clean(None) >>> f.clean('1') 1.0 FloatField accepts min_value and max_value just like IntegerField: >>> f = FloatField(max_value=1.5, min_value=0.5) >>> f.clean('1.6') Traceback (most recent call last): ... ValidationError: [u'Ensure this value is less than or equal to 1.5.'] >>> f.clean('0.4') Traceback (most recent call last): ... ValidationError: [u'Ensure this value is greater than or equal to 0.5.'] >>> f.clean('1.5') 1.5 >>> f.clean('0.5') 0.5 # DecimalField ################################################################ >>> f = DecimalField(max_digits=4, decimal_places=2) >>> f.clean('') Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean(None) Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean('1') Decimal("1") >>> isinstance(f.clean('1'), Decimal) True >>> f.clean('23') Decimal("23") >>> f.clean('3.14') Decimal("3.14") >>> f.clean(3.14) Decimal("3.14") >>> f.clean(Decimal('3.14')) Decimal("3.14") >>> f.clean('a') Traceback (most recent call last): ... ValidationError: [u'Enter a number.'] >>> f.clean(u'łąść') Traceback (most recent call last): ... ValidationError: [u'Enter a number.'] >>> f.clean('1.0 ') Decimal("1.0") >>> f.clean(' 1.0') Decimal("1.0") >>> f.clean(' 1.0 ') Decimal("1.0") >>> f.clean('1.0a') Traceback (most recent call last): ... ValidationError: [u'Enter a number.'] >>> f.clean('123.45') Traceback (most recent call last): ... ValidationError: [u'Ensure that there are no more than 4 digits in total.'] >>> f.clean('1.234') Traceback (most recent call last): ... ValidationError: [u'Ensure that there are no more than 2 decimal places.'] >>> f.clean('123.4') Traceback (most recent call last): ... ValidationError: [u'Ensure that there are no more than 2 digits before the decimal point.'] >>> f.clean('-12.34') Decimal("-12.34") >>> f.clean('-123.45') Traceback (most recent call last): ... ValidationError: [u'Ensure that there are no more than 4 digits in total.'] >>> f.clean('-.12') Decimal("-0.12") >>> f.clean('-00.12') Decimal("-0.12") >>> f.clean('-000.12') Decimal("-0.12") >>> f.clean('-000.123') Traceback (most recent call last): ... ValidationError: [u'Ensure that there are no more than 2 decimal places.'] >>> f.clean('-000.1234') Traceback (most recent call last): ... ValidationError: [u'Ensure that there are no more than 4 digits in total.'] >>> f.clean('--0.12') Traceback (most recent call last): ... ValidationError: [u'Enter a number.'] >>> f = DecimalField(max_digits=4, decimal_places=2, required=False) >>> f.clean('') >>> f.clean(None) >>> f.clean('1') Decimal("1") DecimalField accepts min_value and max_value just like IntegerField: >>> f = DecimalField(max_digits=4, decimal_places=2, max_value=Decimal('1.5'), min_value=Decimal('0.5')) >>> f.clean('1.6') Traceback (most recent call last): ... ValidationError: [u'Ensure this value is less than or equal to 1.5.'] >>> f.clean('0.4') Traceback (most recent call last): ... ValidationError: [u'Ensure this value is greater than or equal to 0.5.'] >>> f.clean('1.5') Decimal("1.5") >>> f.clean('0.5') Decimal("0.5") >>> f.clean('.5') Decimal("0.5") >>> f.clean('00.50') Decimal("0.50") # DateField ################################################################### >>> import datetime >>> f = DateField() >>> f.clean(datetime.date(2006, 10, 25)) datetime.date(2006, 10, 25) >>> f.clean(datetime.datetime(2006, 10, 25, 14, 30)) datetime.date(2006, 10, 25) >>> f.clean(datetime.datetime(2006, 10, 25, 14, 30, 59)) datetime.date(2006, 10, 25) >>> f.clean(datetime.datetime(2006, 10, 25, 14, 30, 59, 200)) datetime.date(2006, 10, 25) >>> f.clean('2006-10-25') datetime.date(2006, 10, 25) >>> f.clean('10/25/2006') datetime.date(2006, 10, 25) >>> f.clean('10/25/06') datetime.date(2006, 10, 25) >>> f.clean('Oct 25 2006') datetime.date(2006, 10, 25) >>> f.clean('October 25 2006') datetime.date(2006, 10, 25) >>> f.clean('October 25, 2006') datetime.date(2006, 10, 25) >>> f.clean('25 October 2006') datetime.date(2006, 10, 25) >>> f.clean('25 October, 2006') datetime.date(2006, 10, 25) >>> f.clean('2006-4-31') Traceback (most recent call last): ... ValidationError: [u'Enter a valid date.'] >>> f.clean('200a-10-25') Traceback (most recent call last): ... ValidationError: [u'Enter a valid date.'] >>> f.clean('25/10/06') Traceback (most recent call last): ... ValidationError: [u'Enter a valid date.'] >>> f.clean(None) Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f = DateField(required=False) >>> f.clean(None) >>> repr(f.clean(None)) 'None' >>> f.clean('') >>> repr(f.clean('')) 'None' DateField accepts an optional input_formats parameter: >>> f = DateField(input_formats=['%Y %m %d']) >>> f.clean(datetime.date(2006, 10, 25)) datetime.date(2006, 10, 25) >>> f.clean(datetime.datetime(2006, 10, 25, 14, 30)) datetime.date(2006, 10, 25) >>> f.clean('2006 10 25') datetime.date(2006, 10, 25) The input_formats parameter overrides all default input formats, so the default formats won't work unless you specify them: >>> f.clean('2006-10-25') Traceback (most recent call last): ... ValidationError: [u'Enter a valid date.'] >>> f.clean('10/25/2006') Traceback (most recent call last): ... ValidationError: [u'Enter a valid date.'] >>> f.clean('10/25/06') Traceback (most recent call last): ... ValidationError: [u'Enter a valid date.'] # TimeField ################################################################### >>> import datetime >>> f = TimeField() >>> f.clean(datetime.time(14, 25)) datetime.time(14, 25) >>> f.clean(datetime.time(14, 25, 59)) datetime.time(14, 25, 59) >>> f.clean('14:25') datetime.time(14, 25) >>> f.clean('14:25:59') datetime.time(14, 25, 59) >>> f.clean('hello') Traceback (most recent call last): ... ValidationError: [u'Enter a valid time.'] >>> f.clean('1:24 p.m.') Traceback (most recent call last): ... ValidationError: [u'Enter a valid time.'] TimeField accepts an optional input_formats parameter: >>> f = TimeField(input_formats=['%I:%M %p']) >>> f.clean(datetime.time(14, 25)) datetime.time(14, 25) >>> f.clean(datetime.time(14, 25, 59)) datetime.time(14, 25, 59) >>> f.clean('4:25 AM') datetime.time(4, 25) >>> f.clean('4:25 PM') datetime.time(16, 25) The input_formats parameter overrides all default input formats, so the default formats won't work unless you specify them: >>> f.clean('14:30:45') Traceback (most recent call last): ... ValidationError: [u'Enter a valid time.'] # DateTimeField ############################################################### >>> import datetime >>> f = DateTimeField() >>> f.clean(datetime.date(2006, 10, 25)) datetime.datetime(2006, 10, 25, 0, 0) >>> f.clean(datetime.datetime(2006, 10, 25, 14, 30)) datetime.datetime(2006, 10, 25, 14, 30) >>> f.clean(datetime.datetime(2006, 10, 25, 14, 30, 59)) datetime.datetime(2006, 10, 25, 14, 30, 59) >>> f.clean(datetime.datetime(2006, 10, 25, 14, 30, 59, 200)) datetime.datetime(2006, 10, 25, 14, 30, 59, 200) >>> f.clean('2006-10-25 14:30:45') datetime.datetime(2006, 10, 25, 14, 30, 45) >>> f.clean('2006-10-25 14:30:00') datetime.datetime(2006, 10, 25, 14, 30) >>> f.clean('2006-10-25 14:30') datetime.datetime(2006, 10, 25, 14, 30) >>> f.clean('2006-10-25') datetime.datetime(2006, 10, 25, 0, 0) >>> f.clean('10/25/2006 14:30:45') datetime.datetime(2006, 10, 25, 14, 30, 45) >>> f.clean('10/25/2006 14:30:00') datetime.datetime(2006, 10, 25, 14, 30) >>> f.clean('10/25/2006 14:30') datetime.datetime(2006, 10, 25, 14, 30) >>> f.clean('10/25/2006') datetime.datetime(2006, 10, 25, 0, 0) >>> f.clean('10/25/06 14:30:45') datetime.datetime(2006, 10, 25, 14, 30, 45) >>> f.clean('10/25/06 14:30:00') datetime.datetime(2006, 10, 25, 14, 30) >>> f.clean('10/25/06 14:30') datetime.datetime(2006, 10, 25, 14, 30) >>> f.clean('10/25/06') datetime.datetime(2006, 10, 25, 0, 0) >>> f.clean('hello') Traceback (most recent call last): ... ValidationError: [u'Enter a valid date/time.'] >>> f.clean('2006-10-25 4:30 p.m.') Traceback (most recent call last): ... ValidationError: [u'Enter a valid date/time.'] DateField accepts an optional input_formats parameter: >>> f = DateTimeField(input_formats=['%Y %m %d %I:%M %p']) >>> f.clean(datetime.date(2006, 10, 25)) datetime.datetime(2006, 10, 25, 0, 0) >>> f.clean(datetime.datetime(2006, 10, 25, 14, 30)) datetime.datetime(2006, 10, 25, 14, 30) >>> f.clean(datetime.datetime(2006, 10, 25, 14, 30, 59)) datetime.datetime(2006, 10, 25, 14, 30, 59) >>> f.clean(datetime.datetime(2006, 10, 25, 14, 30, 59, 200)) datetime.datetime(2006, 10, 25, 14, 30, 59, 200) >>> f.clean('2006 10 25 2:30 PM') datetime.datetime(2006, 10, 25, 14, 30) The input_formats parameter overrides all default input formats, so the default formats won't work unless you specify them: >>> f.clean('2006-10-25 14:30:45') Traceback (most recent call last): ... ValidationError: [u'Enter a valid date/time.'] >>> f = DateTimeField(required=False) >>> f.clean(None) >>> repr(f.clean(None)) 'None' >>> f.clean('') >>> repr(f.clean('')) 'None' # RegexField ################################################################## >>> f = RegexField('^\d[A-F]\d$') >>> f.clean('2A2') u'2A2' >>> f.clean('3F3') u'3F3' >>> f.clean('3G3') Traceback (most recent call last): ... ValidationError: [u'Enter a valid value.'] >>> f.clean(' 2A2') Traceback (most recent call last): ... ValidationError: [u'Enter a valid value.'] >>> f.clean('2A2 ') Traceback (most recent call last): ... ValidationError: [u'Enter a valid value.'] >>> f.clean('') Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f = RegexField('^\d[A-F]\d$', required=False) >>> f.clean('2A2') u'2A2' >>> f.clean('3F3') u'3F3' >>> f.clean('3G3') Traceback (most recent call last): ... ValidationError: [u'Enter a valid value.'] >>> f.clean('') u'' Alternatively, RegexField can take a compiled regular expression: >>> f = RegexField(re.compile('^\d[A-F]\d$')) >>> f.clean('2A2') u'2A2' >>> f.clean('3F3') u'3F3' >>> f.clean('3G3') Traceback (most recent call last): ... ValidationError: [u'Enter a valid value.'] >>> f.clean(' 2A2') Traceback (most recent call last): ... ValidationError: [u'Enter a valid value.'] >>> f.clean('2A2 ') Traceback (most recent call last): ... ValidationError: [u'Enter a valid value.'] RegexField takes an optional error_message argument: >>> f = RegexField('^\d\d\d\d$', error_message='Enter a four-digit number.') >>> f.clean('1234') u'1234' >>> f.clean('123') Traceback (most recent call last): ... ValidationError: [u'Enter a four-digit number.'] >>> f.clean('abcd') Traceback (most recent call last): ... ValidationError: [u'Enter a four-digit number.'] RegexField also access min_length and max_length parameters, for convenience. >>> f = RegexField('^\d+$', min_length=5, max_length=10) >>> f.clean('123') Traceback (most recent call last): ... ValidationError: [u'Ensure this value has at least 5 characters (it has 3).'] >>> f.clean('abc') Traceback (most recent call last): ... ValidationError: [u'Ensure this value has at least 5 characters (it has 3).'] >>> f.clean('12345') u'12345' >>> f.clean('1234567890') u'1234567890' >>> f.clean('12345678901') Traceback (most recent call last): ... ValidationError: [u'Ensure this value has at most 10 characters (it has 11).'] >>> f.clean('12345a') Traceback (most recent call last): ... ValidationError: [u'Enter a valid value.'] # EmailField ################################################################## >>> f = EmailField() >>> f.clean('') Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean(None) Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean('person@example.com') u'person@example.com' >>> f.clean('foo') Traceback (most recent call last): ... ValidationError: [u'Enter a valid e-mail address.'] >>> f.clean('foo@') Traceback (most recent call last): ... ValidationError: [u'Enter a valid e-mail address.'] >>> f.clean('foo@bar') Traceback (most recent call last): ... ValidationError: [u'Enter a valid e-mail address.'] >>> f = EmailField(required=False) >>> f.clean('') u'' >>> f.clean(None) u'' >>> f.clean('person@example.com') u'person@example.com' >>> f.clean('foo') Traceback (most recent call last): ... ValidationError: [u'Enter a valid e-mail address.'] >>> f.clean('foo@') Traceback (most recent call last): ... ValidationError: [u'Enter a valid e-mail address.'] >>> f.clean('foo@bar') Traceback (most recent call last): ... ValidationError: [u'Enter a valid e-mail address.'] EmailField also access min_length and max_length parameters, for convenience. >>> f = EmailField(min_length=10, max_length=15) >>> f.clean('a@foo.com') Traceback (most recent call last): ... ValidationError: [u'Ensure this value has at least 10 characters (it has 9).'] >>> f.clean('alf@foo.com') u'alf@foo.com' >>> f.clean('alf123456788@foo.com') Traceback (most recent call last): ... ValidationError: [u'Ensure this value has at most 15 characters (it has 20).'] # FileField ################################################################## >>> f = FileField() >>> f.clean('') Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean('', '') Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean('', 'files/test1.pdf') 'files/test1.pdf' >>> f.clean(None) Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean(None, '') Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean(None, 'files/test2.pdf') 'files/test2.pdf' >>> f.clean({}) Traceback (most recent call last): ... ValidationError: [u'No file was submitted.'] >>> f.clean({}, '') Traceback (most recent call last): ... ValidationError: [u'No file was submitted.'] >>> f.clean({}, 'files/test3.pdf') 'files/test3.pdf' >>> f.clean('some content that is not a file') Traceback (most recent call last): ... ValidationError: [u'No file was submitted. Check the encoding type on the form.'] >>> f.clean({'filename': 'name', 'content': None}) Traceback (most recent call last): ... ValidationError: [u'The submitted file is empty.'] >>> f.clean({'filename': 'name', 'content': ''}) Traceback (most recent call last): ... ValidationError: [u'The submitted file is empty.'] >>> type(f.clean({'filename': 'name', 'content': 'Some File Content'})) >>> type(f.clean({'filename': 'name', 'content': 'Some File Content'}, 'files/test4.pdf')) # URLField ################################################################## >>> f = URLField() >>> f.clean('') Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean(None) Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean('http://localhost') u'http://localhost' >>> f.clean('http://example.com') u'http://example.com' >>> f.clean('http://www.example.com') u'http://www.example.com' >>> f.clean('http://www.example.com:8000/test') u'http://www.example.com:8000/test' >>> f.clean('http://200.8.9.10') u'http://200.8.9.10' >>> f.clean('http://200.8.9.10:8000/test') u'http://200.8.9.10:8000/test' >>> f.clean('foo') Traceback (most recent call last): ... ValidationError: [u'Enter a valid URL.'] >>> f.clean('http://') Traceback (most recent call last): ... ValidationError: [u'Enter a valid URL.'] >>> f.clean('http://example') Traceback (most recent call last): ... ValidationError: [u'Enter a valid URL.'] >>> f.clean('http://example.') Traceback (most recent call last): ... ValidationError: [u'Enter a valid URL.'] >>> f.clean('http://.com') Traceback (most recent call last): ... ValidationError: [u'Enter a valid URL.'] >>> f = URLField(required=False) >>> f.clean('') u'' >>> f.clean(None) u'' >>> f.clean('http://example.com') u'http://example.com' >>> f.clean('http://www.example.com') u'http://www.example.com' >>> f.clean('foo') Traceback (most recent call last): ... ValidationError: [u'Enter a valid URL.'] >>> f.clean('http://') Traceback (most recent call last): ... ValidationError: [u'Enter a valid URL.'] >>> f.clean('http://example') Traceback (most recent call last): ... ValidationError: [u'Enter a valid URL.'] >>> f.clean('http://example.') Traceback (most recent call last): ... ValidationError: [u'Enter a valid URL.'] >>> f.clean('http://.com') Traceback (most recent call last): ... ValidationError: [u'Enter a valid URL.'] URLField takes an optional verify_exists parameter, which is False by default. This verifies that the URL is live on the Internet and doesn't return a 404 or 500: >>> f = URLField(verify_exists=True) >>> f.clean('http://www.google.com') # This will fail if there's no Internet connection u'http://www.google.com' >>> f.clean('http://example') Traceback (most recent call last): ... ValidationError: [u'Enter a valid URL.'] >>> f.clean('http://www.jfoiwjfoi23jfoijoaijfoiwjofiwjefewl.com') # bad domain Traceback (most recent call last): ... ValidationError: [u'This URL appears to be a broken link.'] >>> f.clean('http://google.com/we-love-microsoft.html') # good domain, bad page Traceback (most recent call last): ... ValidationError: [u'This URL appears to be a broken link.'] >>> f = URLField(verify_exists=True, required=False) >>> f.clean('') u'' >>> f.clean('http://www.google.com') # This will fail if there's no Internet connection u'http://www.google.com' URLField also access min_length and max_length parameters, for convenience. >>> f = URLField(min_length=15, max_length=20) >>> f.clean('http://f.com') Traceback (most recent call last): ... ValidationError: [u'Ensure this value has at least 15 characters (it has 12).'] >>> f.clean('http://example.com') u'http://example.com' >>> f.clean('http://abcdefghijklmnopqrstuvwxyz.com') Traceback (most recent call last): ... ValidationError: [u'Ensure this value has at most 20 characters (it has 37).'] URLField should prepend 'http://' if no scheme was given >>> f = URLField(required=False) >>> f.clean('example.com') u'http://example.com' >>> f.clean('') u'' >>> f.clean('https://example.com') u'https://example.com' # BooleanField ################################################################ >>> f = BooleanField() >>> f.clean('') Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean(None) Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean(True) True >>> f.clean(False) False >>> f.clean(1) True >>> f.clean(0) False >>> f.clean('Django rocks') True >>> f.clean('True') True >>> f.clean('False') False >>> f = BooleanField(required=False) >>> f.clean('') False >>> f.clean(None) False >>> f.clean(True) True >>> f.clean(False) False >>> f.clean(1) True >>> f.clean(0) False >>> f.clean('Django rocks') True A form's BooleanField with a hidden widget will output the string 'False', so that should clean to the boolean value False: >>> f.clean('False') False # ChoiceField ################################################################# >>> f = ChoiceField(choices=[('1', '1'), ('2', '2')]) >>> f.clean('') Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean(None) Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean(1) u'1' >>> f.clean('1') u'1' >>> f.clean('3') Traceback (most recent call last): ... ValidationError: [u'Select a valid choice. That choice is not one of the available choices.'] >>> f = ChoiceField(choices=[('1', '1'), ('2', '2')], required=False) >>> f.clean('') u'' >>> f.clean(None) u'' >>> f.clean(1) u'1' >>> f.clean('1') u'1' >>> f.clean('3') Traceback (most recent call last): ... ValidationError: [u'Select a valid choice. That choice is not one of the available choices.'] >>> f = ChoiceField(choices=[('J', 'John'), ('P', 'Paul')]) >>> f.clean('J') u'J' >>> f.clean('John') Traceback (most recent call last): ... ValidationError: [u'Select a valid choice. That choice is not one of the available choices.'] # NullBooleanField ############################################################ >>> f = NullBooleanField() >>> f.clean('') >>> f.clean(True) True >>> f.clean(False) False >>> f.clean(None) >>> f.clean('1') >>> f.clean('2') >>> f.clean('3') >>> f.clean('hello') # MultipleChoiceField ######################################################### >>> f = MultipleChoiceField(choices=[('1', '1'), ('2', '2')]) >>> f.clean('') Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean(None) Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean([1]) [u'1'] >>> f.clean(['1']) [u'1'] >>> f.clean(['1', '2']) [u'1', u'2'] >>> f.clean([1, '2']) [u'1', u'2'] >>> f.clean((1, '2')) [u'1', u'2'] >>> f.clean('hello') Traceback (most recent call last): ... ValidationError: [u'Enter a list of values.'] >>> f.clean([]) Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean(()) Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean(['3']) Traceback (most recent call last): ... ValidationError: [u'Select a valid choice. 3 is not one of the available choices.'] >>> f = MultipleChoiceField(choices=[('1', '1'), ('2', '2')], required=False) >>> f.clean('') [] >>> f.clean(None) [] >>> f.clean([1]) [u'1'] >>> f.clean(['1']) [u'1'] >>> f.clean(['1', '2']) [u'1', u'2'] >>> f.clean([1, '2']) [u'1', u'2'] >>> f.clean((1, '2')) [u'1', u'2'] >>> f.clean('hello') Traceback (most recent call last): ... ValidationError: [u'Enter a list of values.'] >>> f.clean([]) [] >>> f.clean(()) [] >>> f.clean(['3']) Traceback (most recent call last): ... ValidationError: [u'Select a valid choice. 3 is not one of the available choices.'] # ComboField ################################################################## ComboField takes a list of fields that should be used to validate a value, in that order. >>> f = ComboField(fields=[CharField(max_length=20), EmailField()]) >>> f.clean('test@example.com') u'test@example.com' >>> f.clean('longemailaddress@example.com') Traceback (most recent call last): ... ValidationError: [u'Ensure this value has at most 20 characters (it has 28).'] >>> f.clean('not an e-mail') Traceback (most recent call last): ... ValidationError: [u'Enter a valid e-mail address.'] >>> f.clean('') Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean(None) Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f = ComboField(fields=[CharField(max_length=20), EmailField()], required=False) >>> f.clean('test@example.com') u'test@example.com' >>> f.clean('longemailaddress@example.com') Traceback (most recent call last): ... ValidationError: [u'Ensure this value has at most 20 characters (it has 28).'] >>> f.clean('not an e-mail') Traceback (most recent call last): ... ValidationError: [u'Enter a valid e-mail address.'] >>> f.clean('') u'' >>> f.clean(None) u'' # FilePathField ############################################################### >>> import os >>> from django import newforms as forms >>> path = forms.__file__ >>> path = os.path.dirname(path) + '/' >>> path '.../django/newforms/' >>> f = forms.FilePathField(path=path) >>> f.choices.sort() >>> f.choices [('.../django/newforms/__init__.py', '__init__.py'), ('.../django/newforms/__init__.pyc', '__init__.pyc'), ('.../django/newforms/fields.py', 'fields.py'), ('.../django/newforms/fields.pyc', 'fields.pyc'), ('.../django/newforms/forms.py', 'forms.py'), ('.../django/newforms/forms.pyc', 'forms.pyc'), ('.../django/newforms/models.py', 'models.py'), ('.../django/newforms/models.pyc', 'models.pyc'), ('.../django/newforms/util.py', 'util.py'), ('.../django/newforms/util.pyc', 'util.pyc'), ('.../django/newforms/widgets.py', 'widgets.py'), ('.../django/newforms/widgets.pyc', 'widgets.pyc')] >>> f.clean('fields.py') Traceback (most recent call last): ... ValidationError: [u'Select a valid choice. That choice is not one of the available choices.'] >>> f.clean(path + 'fields.py') u'.../django/newforms/fields.py' >>> f = forms.FilePathField(path=path, match='^.*?\.py$') >>> f.choices.sort() >>> f.choices [('.../django/newforms/__init__.py', '__init__.py'), ('.../django/newforms/fields.py', 'fields.py'), ('.../django/newforms/forms.py', 'forms.py'), ('.../django/newforms/models.py', 'models.py'), ('.../django/newforms/util.py', 'util.py'), ('.../django/newforms/widgets.py', 'widgets.py')] >>> f = forms.FilePathField(path=path, recursive=True, match='^.*?\.py$') >>> f.choices.sort() >>> f.choices [('.../django/newforms/__init__.py', '__init__.py'), ('.../django/newforms/extras/__init__.py', 'extras/__init__.py'), ('.../django/newforms/extras/widgets.py', 'extras/widgets.py'), ('.../django/newforms/fields.py', 'fields.py'), ('.../django/newforms/forms.py', 'forms.py'), ('.../django/newforms/models.py', 'models.py'), ('.../django/newforms/util.py', 'util.py'), ('.../django/newforms/widgets.py', 'widgets.py')] # SplitDateTimeField ########################################################## >>> f = SplitDateTimeField() >>> f.clean([datetime.date(2006, 1, 10), datetime.time(7, 30)]) datetime.datetime(2006, 1, 10, 7, 30) >>> f.clean(None) Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean('') Traceback (most recent call last): ... ValidationError: [u'This field is required.'] >>> f.clean('hello') Traceback (most recent call last): ... ValidationError: [u'Enter a list of values.'] >>> f.clean(['hello', 'there']) Traceback (most recent call last): ... ValidationError: [u'Enter a valid date.', u'Enter a valid time.'] >>> f.clean(['2006-01-10', 'there']) Traceback (most recent call last): ... ValidationError: [u'Enter a valid time.'] >>> f.clean(['hello', '07:30']) Traceback (most recent call last): ... ValidationError: [u'Enter a valid date.'] >>> f = SplitDateTimeField(required=False) >>> f.clean([datetime.date(2006, 1, 10), datetime.time(7, 30)]) datetime.datetime(2006, 1, 10, 7, 30) >>> f.clean(['2006-01-10', '07:30']) datetime.datetime(2006, 1, 10, 7, 30) >>> f.clean(None) >>> f.clean('') >>> f.clean(['']) >>> f.clean(['', '']) >>> f.clean('hello') Traceback (most recent call last): ... ValidationError: [u'Enter a list of values.'] >>> f.clean(['hello', 'there']) Traceback (most recent call last): ... ValidationError: [u'Enter a valid date.', u'Enter a valid time.'] >>> f.clean(['2006-01-10', 'there']) Traceback (most recent call last): ... ValidationError: [u'Enter a valid time.'] >>> f.clean(['hello', '07:30']) Traceback (most recent call last): ... ValidationError: [u'Enter a valid date.'] >>> f.clean(['2006-01-10', '']) Traceback (most recent call last): ... ValidationError: [u'Enter a valid time.'] >>> f.clean(['2006-01-10']) Traceback (most recent call last): ... ValidationError: [u'Enter a valid time.'] >>> f.clean(['', '07:30']) Traceback (most recent call last): ... ValidationError: [u'Enter a valid date.'] """