接口自动化

使用教程
一、配置
1、环境配置
2、框架配置
3、启动入口
二、用例编写
1、用例模板
2、参数依赖写法
2、函数（方法插件）写法
3、接口上传文件和表单参数
4、接口上传json参数
5、接口无数据填写
6、code断言
7、body断言
7、json断言
8、sql断言
9、完整断言写法：
三、邮件发送
四、全局前后置
五、测试
一、配置
1、环境配置
环境名称：自定义名称
headers：键值对字典格式，注意写法格式
http：协议http://或这https://

2、框架配置
Environment：框架测试环境配置，使用之前自定义的环境的名称
log_path：日志这里用自己电脑的文件路径
exclude_dir：执行用例要排除的case下的二级目录，例：‘bd’
exclude_file：执行用例要排除的case下的文件 例：‘case/mb.yaml’
raw_case_path：当前用例原始文件总目录
MYSQL_CONFIG：MYSQL_CONFIG_1，MYSQL_CONFIG_2数据库配置，使用数据库操作时使用，需要几个就写几个
submodule_list：子模块，用于数据统计，就是case目录下的所有二级目录（暂时无用）
case_amount_sum，case_amount_execute：数据统计需要无需修改

3、启动入口

二、用例编写
1、用例模板
使用请严格按照格式编写用例

#用例(名称)标题，需要参数依赖的全部设置字符格式，后期解析成字典列表等格式
用例标题0:
#接口地址，也支持参数依赖,没写
path: /test/KaTeX parse error: Expected 'EOF', got '#' at position 8: {id} #̲请求方法 method: …{token}"}’

是否运行

is_run: False

前置sql：sql有2大类，一个是查询有返回值，一个是增删改无返回值，前置sql为无返回值类型

precondition_sql:

- UPDATE case_test SET title = ‘标题2’, ex = ‘44’ WHERE id = 2

- UPDATE case_test SET title = ‘标题3’, ex = ‘55’ WHERE id = 3

#请求参数较多，这里就使用原始字典格式，除了提取表达式，其他的都带上引号，预防出错,random_time()随机函数使用
data:
‘{
“id”{id},
“projectNo”: “320SF000206004”,
“name”: ${name},
“time”: ${random_int()},
}’
#上传文件，文件名路径必须是英文
file:
‘[
(“file”, (“bug.xlsx”, open(“C:/Users/Cassie/Desktop/bug.xlsx”, “rb”),
“application/vnd.openxmlformats-officedocument.spreadsheetml.sheet”))
]’
#参数类型 json 或者 form表单
data_type: json
#从接口返回结果提取哪些字段和提取表达式,比如从返回数据提取用户id和name
extract_key:
id: $.id
name: $.name
#断言表达式

除了数字类型比较，其他的字符或者表达式全部带上引号,表达式必须要写在后面（必须按照格式来）

断言sql为有返回值查询

assert_expression:
#判断响应码是否和预期一致
code: 200
#判断预期值是否在返回值里面（用值是否在接口返回的内容里面判断）
body: 内容包含
#判断json提取值是否和预期一致（用键和值比较等于，大于小于或者in判断）
json:
id: $.id
name: $.name
1: KaTeX parse error: Expected 'EOF', got '#' at position 10: .int #̲判断sql查询值是否和预期一致….book_jg",“<”,“SELECT book_name FROM book where book_name=$boo{k}_{n}ame"],["d{b}_{t}est","$.title”,“==”,“SELECT title FROM case where id=${id}”]]

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
2、参数依赖写法
参数依赖可以写在path，headers，data里面
参数池{‘id’:1,‘name’:‘kk’,‘info’:{‘wo’:2}}
${id}: 相当于在参数池子里面取id的值也就是1
${info.wo}: 相当于在参数池子里面取wo的值也就是2

2、函数（方法插件）写法
${random_int()}:使用函数里面的这个方法

3、接口上传文件和表单参数
data:使用引号包起来的字典，作为接口表单格式参数发送(复制data里面的数据在外面加上引号)
file：使用引号包起来的python文件对象，作为接口文件格式参数发送（复制file里面的数据在外面加上引号）
调试代码
data_type: 设置为form

import requests

url = "https://xx/file"

data= {'uid': '78axx90011',
           'file_name': 'bug.xlsx',
           'file_type': 'proof_of_address'}
files = [
    ('raw_body', ('bug.xlsx', open('C:/Users/Cassie/Desktop/bug.xlsx', 'rb'), 'text/plain'))
]
headers = {
    'Authorization': 'Bearer eyJ0xxxe',
    'Accept': 'application/json'}

response = requests.request("POST", url, headers=headers, data=data, files=files)

print(response.text)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
用例写法

data:
"
{‘uid’: ‘78asdf99890011’,
‘file_name’: ‘bug.xlsx’,
‘file_type’: ‘proof_of_address’}
"
file:
"
[
(‘raw_body’, (‘bug.xlsx’, open(‘C:/Users/Cassie/Desktop/bug.xlsx’, ‘rb’), ‘text/plain’))
]
"
data_type: form
1
2
3
4
5
6
7
8
9
10
11
12
13
4、接口上传json参数
data:使用引号包起来的字典，作为接口json格式参数发送(复制data里面的数据在外面加上引号)
file：不填
data_type: 设置为 json

data:
’
{
“waybill_no”:“$waybil{l}_{n}o","l{u}_{d}a{n}_{r}en":"${cc1}”,
“aa”:[{“a”:“KaTeX parse error: Expected 'EOF', got '}' at position 18: …andom_str(22)}"}̲,{"b":"{random_int(2)}”},{“c”:“KaTeX parse error: Expected 'EOF', got '}' at position 7: {cc1}"}̲,{"d":{"d1":"{random_int(2)}”}}]
}
’
file:
data_type: json
1
2
3
4
5
6
7
8
9
10
5、接口无数据填写
都填空，不写

data:
file:
data_type:
1
2
3
6、code断言
需要填写预期接口返回码,完全相等就是断言成功

code: 200
1
7、body断言
填写预期接口返回的内容，该内容在接口返回数据里面就是断言成功

body: 520

1
7、json断言
运单创建成功，301是预期结果，$.msg，$.book_jg是预期结果表达式（可以写多个），当预期结果和预期结果表达式从接口返回提取的值相等时就是断言成功

运单创建成功: $.msg
301: $.book_jg

1
2
8、sql断言
格式是一个大列表嵌套一个或者多个小列表，几条sql断言就几个小列表
sql断言第一个值： db_test2，数据库对象，需要先在config.py配置里面写上数据库连接数据，然后去mysql_.py里面生成数据库对象，然后把对象名写在db_list=[‘db_test’,‘db_test2’]上。只有在db_list里面的数据库才可以进行断言使用

sql断言第二个值：预期结果，可以写明确的值，也可以去写$.book_jg去接口返回值里面拿数据作为预期结果

sql断言第三个值：逻辑运算符 < > ==

sql断言第四个值：sql语句，可以在sql语句里面使用${case_id}去接口返回里面拿值来用，和参数依赖一样都是使用jsonpath去提取的写法。

  [['db_test2', '$.book_jg', '<', 'SELECT book_jg FROM book where book_name=${book_name} and book_id=${book_id}']]

1
9、完整断言写法：
assert_expression:
code: 201
body: 520
json:
运单创建成功: $.msg
301: $.boo{k}_{j}gsql:[{[}^{\prime }d{b}_{t}est{2}^{\prime }{,}^{\prime }$.book_jg’, ‘<’, ‘SELECT book_jg FROM book where book_name=$boo{k}_{n}ameandboo{k}_{i}d=${book_id}’]]
1
2
3
4
5
6
7
8
三、邮件发送
配置邮箱的发送邮箱，和授权码（指定163邮箱和该邮箱的授权码）
收件人支持其他邮箱，填写格式如下

邮箱的地址

addresser = “[email protected]”

授权码

authorization_code = “xxxxxTN”

收件人

recipients=[‘[email protected]’, ‘[email protected]’]
1
2
3
4
5
6

四、全局前后置
可以自定义前置干什么后置干什么，我这边只写了后置数据统计和邮件发送

五、测试
1、启动mock接口

2、配置环境，配置mock接口的协议和域名

3、配置环境名称和用例执行目录配置，最多支持2级目录，一般一个目录一个模块

4、用例编写

获取运单号:
path: /get_waybill_no
method: get
headers: ‘{“token”: “${token}”}’
is_run: True
data:
file:
data_type:
extract_key:
waybill_no: $.waybill_no
assert_expression:
code: 200
body: 520
json:
lj520: $.waybil{l}_{n}osql:[{[}^{\prime }d{b}_{t}est{2}^{\prime }{,}^{\prime }$.book_jg’, ‘<’, ‘SELECT book_jg FROM book where book_name=$boo{k}_{n}ameandboo{k}_{i}d=${book_id}’],
[‘db_test’, ‘$.titl{e}^{\prime }{,}^{\prime }={=}^{\prime }{,}^{\prime }SELECTtitleFROMcas{e}_{t}wherecas{e}_{i}d=${case_id}’],
[‘db_test’, ‘唤醒不了’, ‘==’, ‘SELECT title FROM case_t where case_id=2’]
]

录单:
path: /lu_dan?aa=KaTeX parse error: Expected '}', got 'EOF' at end of input: … "waybill_no":"{waybill_no}“,
“lu_dan_ren”:”KaTeX parse error: Expected '}', got 'EOF' at end of input: … "aa":[{"a":"{random_str(22)}“},{“b”:”KaTeX parse error: Expected 'EOF', got '}' at position 17: …random_int(2)}"}̲,{"c":"{cc1}“},{“d”:{“d1”:”${random_int(21)}"}}]
}
’
file:
data_type: json
extract_key:
assert_expression:
code: 201
body: 520
json:
运单创建成功: $.msg
301: $.boo{k}_{j}gsql:[{[}^{\prime }d{b}_{t}est{2}^{\prime }{,}^{\prime }$.book_jg’, ‘<’, ‘SELECT book_jg FROM book where book_name=$boo{k}_{n}ameandboo{k}_{i}d=${book_id}’]]

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
5、执行测试

6.邮箱配置和报告查看
记得先配置邮箱哦
邮箱报告，这里面的一个报告连接就是allure报告的地址

allure报告

————————————————
版权声明：本文为CSDN博主「亚索不会吹风」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/aaaaaaaaanjjj/article/details/129597973

欢迎使用Markdown编辑器

你好！ 这是你第一次使用 Markdown编辑器 所展示的欢迎页。如果你想学习如何使用Markdown编辑器, 可以仔细阅读这篇文章，了解一下Markdown的基本语法知识。

新的改变

我们对Markdown编辑器进行了一些功能拓展与语法支持，除了标准的Markdown编辑器功能，我们增加了如下几点新功能，帮助你用它写博客：

1. 全新的界面设计 ，将会带来全新的写作体验；
2. 在创作中心设置你喜爱的代码高亮样式，Markdown 将代码片显示选择的高亮样式 进行展示；
3. 增加了 图片拖拽 功能，你可以将本地的图片直接拖拽到编辑区域直接展示；
4. 全新的 KaTeX数学公式 语法；
5. 增加了支持甘特图的mermaid语法¹ 功能；
6. 增加了 多屏幕编辑 Markdown文章功能；
7. 增加了 焦点写作模式、预览模式、简洁写作模式、左右区域同步滚轮设置 等功能，功能按钮位于编辑区域与预览区域中间；
8. 增加了 检查列表 功能。

功能快捷键

撤销：Ctrl/Command + Z
重做：Ctrl/Command + Y
加粗：Ctrl/Command + B
斜体：Ctrl/Command + I
标题：Ctrl/Command + Shift + H
无序列表：Ctrl/Command + Shift + U
有序列表：Ctrl/Command + Shift + O
检查列表：Ctrl/Command + Shift + C
插入代码：Ctrl/Command + Shift + K
插入链接：Ctrl/Command + Shift + L
插入图片：Ctrl/Command + Shift + G
查找：Ctrl/Command + F
替换：Ctrl/Command + G

合理的创建标题，有助于目录的生成

直接输入1次#，并按下space后，将生成1级标题。
输入2次#，并按下space后，将生成2级标题。
以此类推，我们支持6级标题。有助于使用TOC语法后生成一个完美的目录。

如何改变文本的样式

强调文本 强调文本

加粗文本 加粗文本

标记文本

删除文本

引用文本

H₂O is是液体。

2¹⁰ 运算结果是 1024.

插入链接与图片

链接: link.

图片:

带尺寸的图片:

居中的图片:

居中并且带尺寸的图片:

当然，我们为了让用户更加便捷，我们增加了图片拖拽功能。

如何插入一段漂亮的代码片

去博客设置页面，选择一款你喜欢的代码片高亮样式，下面展示同样高亮的 代码片.

// An highlighted block
var foo = 'bar';

生成一个适合你的列表

• 项目
  • 项目
    • 项目

1. 项目1
2. 项目2
3. 项目3

• 计划任务
• 完成任务

创建一个表格

一个简单的表格是这么创建的：

项目	Value
电脑	$1600
手机	$12
导管	$1

设定内容居中、居左、居右

使用:---------:居中
使用:----------居左
使用----------:居右

第一列	第二列	第三列
第一列文本居中	第二列文本居右	第三列文本居左

SmartyPants

SmartyPants将ASCII标点字符转换为“智能”印刷标点HTML实体。例如：

TYPE	ASCII	HTML
Single backticks	'Isn't this fun?'	‘Isn’t this fun?’
Quotes	"Isn't this fun?"	“Isn’t this fun?”
Dashes	-- is en-dash, --- is em-dash	– is en-dash, — is em-dash

创建一个自定义列表

Markdown

Text-to- HTML conversion tool

Authors

John

Luke

如何创建一个注脚

一个具有注脚的文本。²

注释也是必不可少的

Markdown将文本转换为 HTML。

KaTeX数学公式

您可以使用渲染LaTeX数学表达式 KaTeX:

Gamma公式展示 $\Gamma (n)=(n-1)!\forall n\in \mathbb{N}$ 是通过欧拉积分

$$\Gamma (z)={\int }_0^{\infty }{t}^{z-1}{e}^{-t}dt.$$

你可以找到更多关于的信息 LaTeX 数学表达式here.

新的甘特图功能，丰富你的文章

2014-01-07 2014-01-09 2014-01-11 2014-01-13 2014-01-15 2014-01-17 2014-01-19 2014-01-21 已完成 进行中 计划一 计划二 现有任务 Adding GANTT diagram functionality to mermaid

• 关于 甘特图 语法，参考 这儿,

UML 图表

可以使用UML图表进行渲染。 Mermaid. 例如下面产生的一个序列图：

张三 李四 王五 你好！李四, 最近怎么样? 你最近怎么样，王五？ 我很好，谢谢! 我很好，谢谢! 李四想了很长时间, 文字太长了 不适合放在一行. 打量着王五... 很好... 王五, 你怎么样? 张三 李四 王五

这将产生一个流程图。:

链接

长方形

圆

圆角长方形

菱形

• 关于 Mermaid 语法，参考 这儿,

FLowchart流程图

我们依旧会支持flowchart的流程图：

Created with Raphaël 2.3.0 开始 我的操作 确认？ 结束 yes no

• 关于 Flowchart流程图 语法，参考 这儿.

导出与导入

导出

如果你想尝试使用此编辑器, 你可以在此篇文章任意编辑。当你完成了一篇文章的写作, 在上方工具栏找到 文章导出 ，生成一个.md文件或者.html文件进行本地保存。

导入

如果你想加载一篇你写过的.md文件，在上方工具栏可以选择导入功能进行对应扩展名的文件导入，
继续你的创作。

---

1. mermaid语法说明 ↩︎

2. 注脚的解释 ↩︎