python生成文章标题_生成自测文档的Python项目

作为一个码农, 有时候开发自己的平台, 总是需要一个测试平台服务的工具, 你可能想到了 postman, 是的, 它可以解决我们开发中单个服务的调试工作, 但是我想要的不局限于单个服务的测试。

✏️ ️1. 需 求 罗 列

盘点了几个现在需要的需求, 如下：自动化测试 API 服务

生成测试数据报告

异常请求捕获

请求响应总览

在请求中, 我需要执行脚本就可以测试所有的服务 API, 并且生成报告文件供我阅览测试的结果, 结果需要对异常的请求进行异常信息补货, 并对所有请求进行相应状态分类。

✏️ ️2. 逻 辑 梳 理

结合 Python 和 mkdocs 服务的想法，利用测试配置的特殊结构进行数据请求，将请求状态以及请求内容或者报错信息进行结合，只管预览每个请求的状态。

✏️ ️3. 使 用 方 法

你可以在项目目录文件 docs/params.yaml 进行你需要的配置：title 项目最大路径的 title 字符串

version 显示你的项目版本号，或用于 API 拼接

service API访问服务地址：127.0.0.1:8000

login 登陆的 URL 后缀地址

username 登陆需要的用户名

password 登陆需要的密码，若是需要加密，请指定加密后的字符

urls 需要测试的 API 配置集合title 请求的 Title 字符，如 获取用户列表、Get Users List 等

url: 请求的 URL 后缀字符串

method 请求方法，需要制定大写，并且支持 GET、POST、DELETE、PUT

params 需要传递的参数数据

id URL 参数的 id 说明对象

注意： params 你可以使用 JSON 对象来说明你要传递的对象：

params: {"key": "value"}

你也可以使用请求的 JSON 数据来指明你要传递的对象：

# 传递已经请求的 title 为创建用户中的响应数据 params: '创建用户.POST.response'

你也可以使用请求的具体 JSON 对象中某个 KEY 下的数据：

# 传递已经请求的 title 为创建用户的响应数据中的 username 字段 params:    username: '创建用户.POST.response.username'

你也可以组建自定义对象

# 传递已经请求的 title 为创建用户的响应数据中的 username 字段 和 自定义 a 字段 params:     username: '创建用户.POST.response.username'     a: medusa

id 是一个映射了 URL 参数的对象，如：

url: '/user/{user_id}'

我们预想的是请求 /user/1 这样的数据详情页，那你可以随意指明你的 id 表示字符，如上面的 user_id，你仅仅需要在 id 中对应的指明对象引用的数据即可：

url: '/user/{user_id}' id:     user_id: 1

当然，上面的用法并没有什么意义，而我们使用的是这样的：

title: 删除用户 url: '/user/{user_id}' method: DELETE id:     user_id: '创建用户.POST.response.id'

使用创建用户的响应数据用的 id 字段的值来删除该用户，为测试数据不影响系统的数据内容。如果请求的是个 [] 类型的数据，可能暂时无法获取其中的数据

✏️ ️4. 启 动 和 测 试

使用 python3 medusa.py 即可启动脚本文件进行 API 测试。

使用 mkdocs serve 即可启动 mkdocs 服务器，进行测试数据浏览。

作者：MedusaSorcerer

原文出处：https://juejin.im/post/6856300307287441422

来源：掘金