1. 安装
2. 基础的validators
2.1 validators.between(value, min=None, max=None)
验证一个数字value是否在最小值min和最大值max之间,value不仅仅可以是整数,也可以是其它数据类型,例如floats, decimals 和 dates.
>>>from validators import between
>>>between(5, min=2)
True
>>>between(13.2, min=13, max=14)
True
>>>between(500, max=400)
ValidationFailure(func=between, args=...)
>>>between(
... datetime(2000, 11, 11),
... min=datetime(1999, 11, 11)
... )
True
2.2 validators.domain(value)
验证value是否是一个有效域。如果value是一个有效域名,函数返回True, 否则返回 ValidationFailure.
>>> domain('example.com')
True
>>> domain('example.com/')
ValidationFailure(func=domain, ...)
也支持国际化域名(IDN domain),例如:
>>> domain('xn----gtbspbbmkef.xn--p1ai')
True
2.3 validators.email(value, whitelist=None)
验证是否是合法的邮件地址,如果是,函数返回True, 否则返回 ValidationFailure.
>>> email('someone@example.com')
True
>>> email('bogus@@')
ValidationFailure(func=email, ...)
2.4 validators.iban(value)
验证是否是合法的国际银行账户号码,如果是,函数返回True, 否则返回 ValidationFailure.
>>> iban('DE29100500001061045672')
True
>>> iban('123456')
ValidationFailure(func=iban, ...)
2.5 validators.ip_address.ipv4(value)
验证是否是合法的ipv4地址,如果是,函数返回True, 否则返回 ValidationFailure.
>>>ipv4('123.0.0.7')
True
>>> ipv4('900.80.70.11')
ValidationFailure(func=ipv4, args={'value': '900.80.70.11'})
2.6 validators.ip_address.ipv6(value)
验证是否是合法的ipv6地址,如果是,函数返回True, 否则返回 ValidationFailure.
>>>ipv6('abcd:ef::42:1')
True
>>> ipv6('abc.0.0.1')
ValidationFailure(func=ipv6, args={'value': 'abc.0.0.1'})
2.7 validators.length(value, min=None, max=None)
验证给定的字符串长度是否在指定范围内。
>>> length('something', min=2)
True
>>> length('something', min=9, max=9)
True
>>> length('something', max=5)
ValidationFailure(func=length, ...)
2.8 validators.mac_address(value)
验证是否是合法的mac地址,如果是,函数返回True, 否则返回 ValidationFailure.
>>> mac_address('01:23:45:67:ab:CD')
True
>>> mac_address('00:00:00:00:00')
ValidationFailure(func=mac_address, args={'value': '00:00:00:00:00'})
2.9 validators.slug(value)
验证是否是合法的slug,如果是,函数返回True, 否则返回 ValidationFailure.
>>> slug('my.slug')
ValidationFailure(func=slug, args={'value': 'my.slug'})
>>> slug('my-slug-2134')
True
2.10 validators.truthy(value)
>>> truthy(1)
True
>>> truthy('someone')
True
>>> truthy(0)
ValidationFailure(func=truthy, args={'value': 0})
>>> truthy(' ')
ValidationFailure(func=truthy, args={'value': ' '})
>>> truthy(False)
ValidationFailure(func=truthy, args={'value': False})
>>> truthy(None)
ValidationFailure(func=truthy, args={'value': None})
2.11 validators.url(value, public=False)
验证是否是合法的url,如果是,函数返回True, 否则返回 ValidationFailure.
>>> url('http://foobar.dk')
True
>>> url('http://10.0.0.1')
True
>>> url('http://foobar.d')
ValidationFailure(func=url, ...)
>>> url('http://10.0.0.1', public=True)
ValidationFailure(func=url, ...)
Parameters:
• value – 要验证的url
• public – (default=False) Set True to only allow a public IP address
2.12 validators.i18n.fi.fi_business_id(business_id)
验证Finnish Business ID.
>>> fi_business_id('0112038-9') # Fast Monkeys Ltd
True
>>> fi_business_id('1234567-8') # Bogus ID
ValidationFailure(func=fi_business_id, ...)
2.13 validators.i18n.fi.fi_ssn(ssn)
验证Finnish Social Security Number.
>>> fi_ssn('010101-0101')
True
>>> fi_ssn('101010-0102')
ValidationFailure(func=fi_ssn, args={'ssn': '101010-0102'})