PythonCerberus教程展示了如何在Python中使用Cerberus验证数据。
地狱犬
Cerberus是一个Python验证库，它提供强大而简单和轻量级的数据验证功能。它旨在易于扩展，允许自定义验证。
Cerberus通过为数据定义验证模式来工作。该架构被传递给验证器并使用validate进行验证。它有一组规则，例如required、min或max，它们应用于数据。
可以在一个数据字段上应用多个规则。如果验证失败，我们可以通过errors属性获取错误信息。
地狱犬类型
以下是Cerberus的简单演示。使用type规则，我们设置字段的预期数据类型。
#!/usr/bin/python
from cerberus import Validator
schema = {'name': {'type': 'string'}}
v = Validator(schema)
document = {'name': 'john doe'}
if v.validate(document):
print('data is valid')
else:
print('invalid data')
在这个例子中，我们验证了一个name字段；我们希望它是一个字符串值。
from cerberus import Validator
我们导入Validator类。
schema = {'name': {'type': 'string'}}
我们定义模式。它是一个Python字典。我们指定名称字段必须是字符串。
document = {'name': 'john doe'}
这是我们的数据。
if v.validate(document):
print('data is valid')
else:
print('invalid data')
我们使用validate验证数据。
$ ./simple.py data is valid
在第二个示例中，我们检查字符串和列表类型。
#!/usr/bin/python
from cerberus import Validator
v = Validator()
v.schema = {'words': {'type': ['string', 'list']}}
if v.validate({'words': 'falcon'}):
print('valid data')
else:
print('invalid data')
if v.validate({'words': ['falcon', 'sky', 'cloud']}):
print('valid data')
else:
print('invalid data')
该示例验证words字段是字符串还是列表。
Cerberus要求的规则
required规则使该字段成为必填字段。
#!/usr/bin/python
from cerberus import Validator
v = Validator()
v.schema = {'name': {'required': True, 'type': 'string'},
'age': {'type': 'integer'}}
if v.validate({'age': 34}):
print('valid data')
else:
print('invalid data')
print(v.errors)
该示例有两个数据字段：name和age。name是必填字段。
$ ./required.py
invalid data
{'name': ['required field']}
我们省略了name字段；因此，验证失败。
Cerberus最小和最大规则
min和max规则设置整数、浮点数和数字类型允许的最小值和最大值。
对于字符串类型，我们可以使用minlength和maxlength。
#!/usr/bin/python
from cerberus import Validator
v = Validator()
v.schema = {'name': { 'type': 'string', 'minlength': 2},
'age': {'type': 'integer', 'min': 18, 'max': 65}}
if v.validate({'name': 'J', 'age': 4}):
print('valid data')
else:
print('invalid data')
print(v.errors)
在示例中，我们为字符串设置了最小长度，为整数设置了最小和最大长度。
$ ./min_max.py
invalid data
{'age': ['min value is 18'], 'name': ['min length is 2']}
我们有两个验证错误。
Cerberus正则表达式规则
我们可以用正则表达式定义更复杂的规则。
#!/usr/bin/python
from cerberus import Validator
v = Validator()
v.schema = {"contact_details": {
"type": "dict",
"schema": {
"phone": {
"type": "string",
"minlength": 10,
"maxlength": 10,
"regex": "^0[0-9]{9}$"
},
"email": {
"type": "string",
"minlength": 8,
"maxlength": 255,
"required": True,
"regex": "^[a-zA-Z0-9_.+-]+@[a-zA-Z0-9-]+\\.[a-zA-Z0-9-.]+$"
}
}
}}
if v.validate({'contact_details': {'phone': '0901123123',
'email': 'john.doe@example.com'}}):
print('valid data')
else:
print('invalid data')
print(v.errors)
在示例中，我们使用正则表达式为phone和email字段定义验证规则。
Cerberus值强制转换
值强制允许我们在数据验证之前将可调用项应用于值。可调用项的返回值替换文档中的新值。强制可用于在验证之前转换值或清理数据。
#!/usr/bin/python
from cerberus import Validator
from datetime import datetime
def to_date(s):
return datetime.strptime(s, '%Y-%m-%d')
v = Validator()
v.schema = {'start_date': {'type': 'datetime', 'coerce': to_date}}
if v.validate({'start_date': '2019-12-11'}):
print('valid data')
else:
print('invalid data')
print(v.errors)
if v.validate({'start_date': '2019/12/11'}):
print('valid data')
else:
print('invalid data')
print(v.errors)
在示例中，我们使用自定义to_date函数将数据时间值转换为选定的格式。
$ ./coercing.py
valid data
invalid data
{'start_date': ["field 'start_date' cannot be coerced: time data '2019/12/11' does not
match format '%Y-%m-%d'", 'must be of datetime type']}
使用YAML文件
在下一个示例中，我们在YAML文件中有数据。
cities: - Bratislava - Kosice - Trnava - Moldava - Trencin
该文件包含一个城市列表。
#!/usr/bin/python
from cerberus import Validator
import yaml
v = Validator()
v.schema = {'cities': {'type': 'list', 'schema': {'type': 'string'}}}
with open('cities.yaml') as f:
data = yaml.load(f, Loader=yaml.FullLoader)
print(data)
if v.validate({'cities': data['cities']}):
print('valid data')
else:
print('invalid data')
print(v.errors)
我们从YAML文件中读取数据并对其进行验证。schema规则设置定义的规则针对列表的所有元素进行验证。
v = Validator()
v.schema = {'cities': {'type': 'list', 'schema': {'type': 'string'}}}
cities字段必须是一个列表，它的所有元素都必须是字符串。
Cerberus自定义验证器
我们可以通过从Validator类扩展来创建自定义验证器。
#!/usr/bin/python
from cerberus import Validator
from dataclasses import dataclass
@dataclass
class Person:
name: str
age: int
class PersonValidator(Validator):
def validate_person(self, obj):
return self.validate(obj.__dict__)
schema = {'name': { 'type': 'string', 'minlength': 2},
'age': {'type': 'integer', 'min': 18, 'max': 65}}
v = PersonValidator(schema)
p = Person('John Doe', 2)
if v.validate_person(p):
print('valid data')
else:
print('invalid data')
print(v.errors)
在示例中，我们为Person对象定义了一个自定义验证器。
在本教程中，我们展示了如何使用Cerberus在Python中验证数据。
阅读Python教程或列出所有Python教程。
