博客接口自动化测试--搭建测试环境库的介绍安装allure
一、搭建测试环境
新建PyCharm项目
查看Python安装路径：
Windows+r -> cmd -> where python
切换终端类型为Windows PowerShell
PowerShell：功能更强，适合复杂脚本、管道操作
File -> Settings -> Tools -> Terminal
Shell path : 'powershell.exe'
点击 OK 保存
安装所需要的库：
1、创建 requirements.txt 文件，输入库名及版本号
pytest==8.3.2 allure-pytest==2.13.5 jsonschema==4.23.0 PyYAML==6.0.1 requests==2.31.02、通过包管理器 pip 一件安装
pip install -r requirements.txt3、检查有没有安装成功
pip list
已经安装成功
二、库的介绍
1. requests
HTTP客户端库，用户发送HHTTP请求
常用方法：
| 方法 | 说明 |
| get(url,params=None) | 发送get请求 |
| post(url,data=None,json=None) | 发送post请求 |
| put(url,data=None) | 发送put请求 |
| delete(url) | 发送delete请求 |
常用参数：
| 参数 | 说明 |
| url | 接口地址 |
| params | URL查询参数 |
headers | 请求头 |
| json | JSON格式请求体 |
| data | 表单格式请求体 |
| timeout | 超时时间 |
返回值（Response对象）：
| 属性/方法 | 说明 |
| r.status_code | 状态码 |
| r.text | 字符串响应体 |
| r.json() | JSON格式响应体 |
| r.headers | 响应头 |
2. pytest
Python测试框架，用于编写和执行测试用例
核心功能：
| 功能 | 说明 |
| test_xxx.py | 测试文件命名规则 |
| def test_xxx(): | 测试函数命名规则 |
| assert | 断言 |
| @pytest.fixture | 测试夹具 |
| @pytest.mark.parametrize | 参数化 |
常用命令：
pytest # 运行所有测试 pytest -v # 显示详细信息 pytest -k "login" # 运行指定关键字测试 pytest test_demo.py # 运行指定文件 pytest --html=report.html # 生成HTML报告3. allure-pytest
pytest的插件，用于生成美观的测试报告
常用装饰器：
| 装饰器 | 说明 |
| @allure.feature("模块名") | 功能模块 |
| @allure.story("故事点") | 子功能 |
| @allure.title("用例标题") | 测试用例标题 |
| @allure.description("描述") | 用例描述 |
| @allure.severity("级别") | 用例严重级别 |
| @allure.step("步骤") | 测试步骤 |
常用命令：
pytest --alluredir=./allure-result # 生成allure数据 allure serve ./allure-result # 启动web报告4. jsonschema
JSON数据验证库，用于校验接口返回的数据格式
常用方法：
| 方法 | 说明 |
| validate(instance, schema) | 验证数据是否符合schema |
Schema示例：
schema = { "type": "object", "required": ["name", "age"], "properties": { "name": {"type": "string"}, "age": {"type": "integer", "minimum": 0}, "email": {"type": "string", "format": "email"} }, "additionalProperties": False }验证规则：
| 关键字 | 说明 | 示例 |
| type | 数据类型 | ”string","integer","boolean" |
| required | 必填字段 | ["name","age"] |
| minimum/maximum | /最小值最大值 | 18/188 |
| minLength/maxLength | 字符串长度范围 | 5/50 |
| pattern | 正则表达式 | "^1[3-9]\d{9}$" |
| enum | 枚举值 | ["male","female"] |
| format | 格式 | "email","date","uri" |
5. PyYAML
yaml文件解析库，用于读写yaml格式的配置文件或测试数据
常用方法：
| 方法 | 说明 |
| yaml.safe_load(file) | 读取YAML文件 → Python对象 |
| yaml.safe_dump(data, file) | Python对象 -> 写入yaml文件 |
| yaml.safe_load_all(file) | 读取多文档yaml |
| yaml.safe_dump_all(docs, file) | 写入多文档yaml |
示例：
import yaml # 读取YAML with open("config.yaml", "r", encoding="utf-8") as f: data = yaml.safe_load(f) print(data["database"]["host"]) # 写入YAML data = { "database": { "host": "localhost", "port": 3306, "user": "root" } } with open("config.yaml", "w", encoding="utf-8") as f: yaml.safe_dump(data, f, allow_unicode=True)YAML格式特点：
# 键值对 name: 张三 age: 25 # 列表 hobbies: - 读书 - 编程 - 音乐 # 对象嵌套 user: name: 李四 address: city: 北京 street: 长安街6. 五者之间的关系
三、安装allure
下载安装包链接：https://github.com/allure-framework/allure2/releases/download/2.30.0/allure-2.30.0.zip
解压 -> 找到bin目录 -> 复制文件路径
配置环境变量：
确认结果：打开cmd查看allure版本
注意：可能存在部分情况，在cmd上执行命令可以通过，但是在pycharm上执行allure--version提示找不到的命令，需要手动修改pycharm中的配置:
运行自动化，并指定测试报告放置路径：
pytest --alluredir=allure-results查看测试报告：
1、启动⼀个本地服务器来在浏览器中展示测试报告
#不指定端⼝号和主机地址 allure serve .\allure-results\ #指定端⼝号 allure serve --port 8787 .\allure-results\ #清除上⼀次⽣成的测试报告 allure serve .\allure-results\ --clean-alluredir2、从测试结果生成测试报告
allure generate .\allure-results\ -o .\allure-report