返回顶部
首页 > 资讯 > 后端开发 > Python >Python webargs 模块的简单使用
  • 490
分享到

Python webargs 模块的简单使用

2024-04-02 19:04:59 490人浏览 薄情痞子

Python 官方文档:入门教程 => 点击学习

摘要

目录一、安装二、基础特性2.1. 使用2.1.1 通过装饰器2.1.2 通过函数2.2 参数检查2.3 检查失败处理2.4 嵌套参数三、高级特性3.1 自定义location3.2

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 模块内容请搜索编程网以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程网!

--结束END--

本文标题: Python webargs 模块的简单使用

本文链接: https://www.lsjlt.com/news/163263.html(转载时请注明来源链接)

有问题或投稿请发送至: 邮箱/279061341@qq.com    QQ/279061341

猜你喜欢
  • Python webargs 模块的简单使用
    目录一、安装二、基础特性2.1. 使用2.1.1 通过装饰器2.1.2 通过函数2.2 参数检查2.3 检查失败处理2.4 嵌套参数三、高级特性3.1 自定义location3.2 ...
    99+
    2024-04-02
  • Python webargs模块怎么使用
    今天小编给大家分享一下Python webargs模块怎么使用的相关知识点,内容详细,逻辑清晰,相信大部分人都还太了解这方面的知识,所以分享这篇文章给大家参考一下,希望大家阅读完这篇文章后有所收获,下面我们一起来了解一下吧。web...
    99+
    2023-06-28
  • python tkinter模块的简单使用
    目录1.任务要求 2.简单设计 3.模块实现4.总结由于一些小原因,被迫开始了tkinter一次实战演练。在此做一些记录,总结以及给自己留一些轮子哈哈哈哈哈哈 tkinter 是 P...
    99+
    2024-04-02
  • Python:简单select模块使用
    select 多并发socket 例子 #!/usr/bin/env python #coding:utf-8 import select import socket import Queue listen_addr=('0...
    99+
    2023-01-31
    模块 简单 Python
  • python的md5模块使用非常简单
     python的md5模块使用非常简单,包括以下几个函数: md5.new([arg]) 返回一个md5对象,如果给出参数,则相当于调用了update(arg) md5.updte(arg) ...
    99+
    2023-01-31
    模块 简单 python
  • Pythonoptparse模块及简单使用
    目录参数说明函数说明简单使用optparse,是一个更够让程序设计人员轻松设计出简单明了、易于使用、符合标准的Unix命令例程式的Python模块,生成使用和帮助信息。 参数说明 d...
    99+
    2022-12-08
    Python optparse模块 Python optparse使用
  • Python常用的模块和简单用法
    目录1、random 随机模块2、matplotlab.pyplot 作图模块3、mpl_toolkits.mplot3d 绘制3D图模块 1、random 随机模块 import ...
    99+
    2024-04-02
  • python process模块的使用简介
    目录process模块1、在python中启动一个子进程2、给子进程传递参数3、同时开多个子进程4、join的用法5、多进程之间的数据是否隔离6、为什么在Windows中Process()必须放到if __name_...
    99+
    2022-06-02
    python process模块 python process的使用
  • python glom模块的使用简介
    目录安装简单使用复杂用法搞定麻烦需求总结工欲善其事,必先利其器!我们想要更轻松更有效率地开发,必须学会一些“高级”技能。前不久看到一位 Python 高僧的代码,其中使用了一个短小精...
    99+
    2024-04-02
  • 简单学习Python time模块
    本文针对Python time模块进行分类学习,希望对大家的学习有所帮助。 一.壁挂钟时间 1.time() time模块的核心函数time(),它返回纪元开始的秒数,返回值为浮点数,具体精度依赖于平台。 ...
    99+
    2022-06-04
    模块 简单 Python
  • python模块itsdangerous简单介绍
    安装 你可以从PyPI上直接安装这个库: pip install itsdangerous 适用案例 在取消订阅某个通讯时,你可以在URL里序列化并且签名一个用户的ID。这种情况下...
    99+
    2022-11-16
    python模块itsdangerous python itsdangerous模块 python itsdangerous
  • python中的logging模块的简单应用和高级使用
    目录简单使用日志格式输出到文件处理程序(Handler)过滤器(Filter)高级使用日志回溯日志轮换日志缓冲总结简单使用 在 Python 中,可以使用内置的 logging 模块...
    99+
    2023-05-17
    python logging模块 logging应用
  • Python模块怎么实现简单的调用
    这篇文章给大家分享的是有关Python模块怎么实现简单的调用的内容。小编觉得挺实用的,因此分享给大家做个参考,一起跟随小编过来看看吧。python可以做什么Python是一种编程语言,内置了许多有效的工具,Python几乎无所不能,该语言通...
    99+
    2023-06-14
  • Python中os模块的简单使用及重命名操作
    前言 OS模块虽然基础的时候已经学过了,但是谁让本人属于那种不用立马就忘的人呢,所以在在下爬取某个不可名状的男人都喜欢的网站的时候,在遇到爬取下来的数据需要保存的时候,就需要用到O...
    99+
    2024-04-02
  • python标准库之time模块的语法与简单使用
    目录表示时间的方式 1. 调用语法: 2. time概述3. 时间获取4. 时间格式化(将时间以合理的方式展示出来)5. 程序计时应用6. 示例总结表示时间的方式 时间戳表示法: ...
    99+
    2024-04-02
  • 简单谈谈Python中的模块导入
    目录模块与包 __import__ 模块缓存 imp 与 importlib 模块 惰性导入 总结参考资料本文不讨论 Python 的导入机制(底层实现细节),仅讨论模块与包,以及导...
    99+
    2024-04-02
  • node.js中debug模块的简单介绍与使用
    前言 相信使用node.js的朋友们都知道,一般在nodejs需要进行调试的时候,可以使用console.log()方法来将调试信息输出到控制台,当发布到生产环境的时候,需要将这些调试信息都注释掉,为了方便...
    99+
    2022-06-04
    模块 简单 node
  • python 绘图模块matplotlib的使用简介
        上周对线上某几个磁盘进行了fio硬盘性能测试,测试完成之后的结果需要绘制成图像展示出来。我在官网上查找了一下fio自带的命令fio_genera...
    99+
    2024-04-02
  • Python第三方常用模块openpyxl的简单介绍
    目录openpyxl创建文件Workbook() —创建 excel 文件Workbook.create_sheet() —创建 excel 工作簿Works...
    99+
    2024-04-02
  • 使用Python和OpenSSL简单模拟
    本文使用Python和文件系统模拟保密通信的整个过程 本阶段完成系统初始状态模拟,直接看代码 import os,shutil from Crypto.Cipher import DES3,XOR def xorencode...
    99+
    2023-01-31
    简单 Python OpenSSL
软考高级职称资格查询
编程网,编程工程师的家园,是目前国内优秀的开源技术社区之一,形成了由开源软件库、代码分享、资讯、协作翻译、讨论区和博客等几大频道内容,为IT开发者提供了一个发现、使用、并交流开源技术的平台。
  • 官方手机版

  • 微信公众号

  • 商务合作