该webargs
模块允许将参数模式描述为纯字典或棉花糖数据类模式:
# Dictionary variant
@use_args({'field1': field.Int(required=True, validate=validate.Range(min=1))}, location='json')
def post(args: Dict[str, any]):
controller.post(args)
# Marshmallow dataclass schema
@dataclass()
class Arg:
field1: int = field(metadata=dict(required=True, validate=validate.Range(min=1)))
@use_args(Arg.Schema(), location='json')
def post(arg: Arg):
controller.post(arg)
第一个变体看起来更短更快,但我们失去了 IDE 中的语法高亮和类型检查(因为它是 dict),而且它导致更长的调用,即args['field1']
而不是arg.field1
.
您在大型项目中使用哪种变体?在使用第一个或第二个变体时是否有一些最佳实践?