Python webargs 模块的简单使用
webargs是一个用于解析和验证HTTP请求对象的Python库,内置了对流行web框架的支持,包括Flask、Django、Bottle、Tornado、Pyramid、webapp2、Falcon和aiohttp。下面看下Python webargs 模块详解。
一、安装
python3 -m pip install webargs
文档
二、基础特性
# encoding=utf-8 from flask import Flask from webargs import fields from webargs.flaskparser import use_args app = Flask(__name__) app.route("/") @use_args({ "name": fields.Str(required=True), "age": fields.Int(required=True), }, location='query') def index(args): print('args', args) return "Hello " + args["name"] if __name__ == "__main__": app.run(debug=1)
2.1. 使用
2.1.1 通过装饰器
@use_args({ "name": fields.Str(required=True), "age": fields.Int(required=True), }, location='query')
- 第一个参数是需要获取的字段名,类型,是否必须等的定义
- location是指从哪里获取这些参数,默认是json,可选:
- 'querystring' (same as 'query')
- 'json'
- 'form'
- 'headers'
- 'cookies'
- 'files'
解析完后,把所有参数放在字典里面,传给下层函数
2.1.2 通过函数
args = parser.parse(user_args, request)
参数和装饰器一样,多了一传request
2.2 参数检查
from webargs import fields, validate args_1 = { # 必须参数,字符串类型 "username": fields.Str(required=True), # validate "password": fields.Str(validate=lambda p: len(p) >= 6), "password": fields.Str(validate=validate.Length(min=6)), # Default value when argument is missing "display_per_page": fields.Int(missing=10), # Repeated parameter, e.g. "/?nickname=Fred&nickname=Freddie" "nickname": fields.List(fields.Str()), # Delimited list, e.g. "/?languages=python,javascript" "languages": fields.DelimitedList(fields.Str()), # When value is keyed on a variable-unsafe name # or you want to rename a key "user_type": fields.Str(data_key="user-type"), "start_day": fields.DateTime(required=True, format='%Y-%m-%d %X'), "bool": fields.Bool(), "email": fields.Email(), "ip": fields.IP(), "type": fields.Constant(constant='COMMON_TYPE'), "money": fields.Decimal(), "weight": fields.Float(), "url": fields.URL(), "uuid": fields.UUID(), "raw": fields.Raw(), }
- fields.Str 表示接收字符串参数
- required=True 表示必传
- validate=lambda p: len(p) >= 6 表示自定义检查函数。会把参数传递给该函数,该函数返回True表示检查通过,返回False或者抛出异常表示检查不通过
- 如果要对多个参数进行联合检查,需要在装饰器层架validate参数:@use_args(args_1, validate=lambda args: len(args["username"]) < len(args["password"]))
- 异常需要是from webargs import ValidationError这个异常,不然会当程序异常处理
- 也可以用validate库里面的内置检查函数
- missing=10 表示如果没有入参,设置为默认值
- fields.List(fields.Str()) 表示列表型参数,列表的元素是字符串
- fields.DelimitedList(fields.Str()) 表示逗号型的列表参数
- data_key="user-type" 表示字段名修改,入参是user-type,在args字典会改为user_type
- fields.DateTime(required=True, format='%Y-%m-%d %X') 表示接收日期类型,并且格式需要符合,参数值会转换为datetime类型
- "bool": fields.Bool() 表示布尔类型,传1,0,true,false都能识别
- fields.Email() 只接收email,估计里面会有正则检查
- fields.IP() 只接收IP
- fields.Constant(constant='COMMON_TYPE') 常量参数,无论入参是什么值,type永远等于COMMON_TYPE
- fields.Decimal() 转换为Decimal类型
- fields.Float() 转换为float类型
- fields.URL() fields.UUID() 正则检查url格式或者uuid格式
- fields.Raw 不检查参数类型
内置参数检查
- validate=validate.Length(min=1,max=10) 检查字符串长度需要在某个区间
- validate=validate.OneOf(['male', 'female']) 入参需要在枚举里面
2.3 检查失败处理
如果参数检查失败,会返回422响应,但是不会提示哪个参数有问题。我们可以通过Flask的异常处理机制,捕获这个异常,然后构造我们想要的返回
@app.errorhandler(422) # 捕获422和400的异常码 @app.errorhandler(400) def handle_error(err): headers = err.data.get("headers", None) messages = err.data.get("messages", ["Invalid request."]) print(headers) print(messages) # {'json': {'password': ['Shorter than minimum length 6.']}} return json.dumps({'err_code': 10000, 'err_msg': messages['json']})
- 从err里面获取信息,headers不知道有什么用的,message会有异常信息,例如不满足
validate=validate.Length(min=6)
检查,就会返回{'json': {'password': ['Shorter than minimum length 6.']}}
- 如果是主动抛出的ValidationError异常,message会包含ValidationError异常的内容
- 我们可以把这个参数检查信息返回给前端,提示前端哪个参数错误了。
messages['json']
的json是location的key
2.4 嵌套参数
对于一些复杂的,有多重嵌套的参数
"name": fields.Nested( {"first": fields.Str(required=True), "last": fields.Str(required=True)} )
- 表示name是一个嵌套参数,也就是字典
- 然后里面需要要first key和last key
三、高级特性
3.1 自定义location
上面说了location支持query,json这些,也可以自定义
@parser.location_loader("data") def load_data(request, schema): data = {} data.update({k: request.args.get(k) for k in request.args}) if request.json: data.update({k: request.json.get(k) for k in request.json}) print(data, 'dataaaaa') return data parser.location = 'data' # 设置默认的location为data
- 上面定义了一个data的location,会合并args和json入参
- 把默认的location修改为data
也可以这样,这个是官方推荐方法:
@parser.location_loader("args_and_json") def load_data(request, schema): from webargs.multidictproxy import MultiDictProxy newdata = request.args.copy() if request.json: newdata.update(request.json) return MultiDictProxy(newdata, schema)
3.2 定义schema
除了可以通过字典定义args,也可以通过类:
from marshmallow import Schema class UserSchema(Schema): name = fields.Str(required=True) age = fields.Int() @app.route("/") @use_args(UserSchema()) def index1(args): print('args', args) return "Hello "
3.3 未定义的参数处理
如果入参有未定义的参数,webargs默认会抛出422异常
from webargs.flaskparser import parser import marshmallow parser.unknown = marshmallow.EXCLUDE # 如果有未定义参数,不放到args参数,不抛异常 parser.unknown = marshmallow.INCLUDE # 如果有未定义参数,放到args参数,不抛异常
- 可以修改parse.unknown来修改策略。
- 也可以精确设置不同location的unknown策略
3.4 Flask的url参数
@app.route("/<int:id>/") @use_args(UserSchema()) def index1(args, id): print('args', args, id) return "Hello "
如果需要用到Flask的url参数,就需要这样传递参数
到此这篇关于Python webargs 模块的文章就介绍到这了,更多相关Python webargs 模块内容请搜索猪先飞以前的文章或继续浏览下面的相关文章希望大家以后多多支持猪先飞!
原文出处:https://www.cnblogs.com/Xjng/p/15829657.html
相关文章
- 这篇文章主要介绍了python-opencv-画外接矩形框的实例代码,代码简单易懂,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下...2021-09-04
Python astype(np.float)函数使用方法解析
这篇文章主要介绍了Python astype(np.float)函数使用方法解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下...2020-06-08- 2022虎年新年即将来临,小编为大家带来了一个利用Python编写的虎年烟花特效,堪称全网最绚烂,文中的示例代码简洁易懂,感兴趣的同学可以动手试一试...2022-02-14
- 在本篇文章里小编给大家分享的是一篇关于python中numpy.empty()函数实例讲解内容,对此有兴趣的朋友们可以学习下。...2021-02-06
python-for x in range的用法(注意要点、细节)
这篇文章主要介绍了python-for x in range的用法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2021-05-10- 这篇文章主要介绍了Python 图片转数组,二进制互转操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2021-03-09
- 这篇文章主要介绍了Python中的imread()函数用法说明,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2021-03-16
- 这篇文章主要介绍了python如何实现b站直播自动发送弹幕,帮助大家更好的理解和学习使用python,感兴趣的朋友可以了解下...2021-02-20
python Matplotlib基础--如何添加文本和标注
这篇文章主要介绍了python Matplotlib基础--如何添加文本和标注,帮助大家更好的利用Matplotlib绘制图表,感兴趣的朋友可以了解下...2021-01-26- 这篇文章主要介绍了解决python 使用openpyxl读写大文件的坑,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2021-03-13
- 今天小编就为大家分享一篇python 计算方位角实例(根据两点的坐标计算),具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2020-04-27
- 这篇文章主要为大家详细介绍了python实现双色球随机选号,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下...2020-05-02
- 在本篇文章里小编给大家整理的是一篇关于python中使用np.delete()的实例方法,对此有兴趣的朋友们可以学习参考下。...2021-02-01
- 这篇文章主要介绍了使用Python的pencolor函数实现渐变色功能,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下...2021-03-09
- 这篇文章主要介绍了python自动化办公操作PPT的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-02-05
Python getsizeof()和getsize()区分详解
这篇文章主要介绍了Python getsizeof()和getsize()区分详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-11-20- 这篇文章主要为大家详细介绍了python实现学生通讯录管理系统,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下...2021-02-25
- 这篇文章主要介绍了PyTorch一小时掌握之迁移学习篇,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下...2021-09-08
- 这篇文章主要介绍了解决python 两个时间戳相减出现结果错误的问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2021-03-12
- 这篇文章主要介绍了Python绘制的爱心树与表白代码,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下...2021-04-06