# pytest+allure 自动化测试框架（接口自动化）

**Repository Path**: zheng-the-young/pytest_allure

## Basic Information

- **Project Name**: pytest+allure 自动化测试框架（接口自动化）
- **Description**: pytest+allure自动化测试框架，专注于接口自动化测试，结合pytest的简洁与allure的强大报告功能，助力高效开发与持续集成。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2025-05-27
- **Last Updated**: 2025-07-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# pytest+allure 自动化测试框架（接口自动化）

## 介绍
这是一个基于 pytest 和 allure 的接口自动化测试框架，主要用于对龙果支付项目进行接口测试。框架支持数据库操作、HTTP 请求封装、YAML 配置读取、日志记录以及测试报告生成等功能。

## 软件架构
本项目采用模块化设计，主要模块包括：
- **case_script**: 存放测试用例脚本。
- **common**: 包含通用工具类和方法，如数据库操作、请求封装、YAML 文件读取等。
- **config**: 存放配置文件，如接口基础 URL 和数据库配置。
- **data**: 存放测试过程中产生的数据文件。
- **report**: 测试报告输出目录，使用 allure 生成美观的测试报告。
- **tokens**: 存放登录 token 文件。

## 安装教程
1. 安装 Python 3.x。
2. 安装依赖包：
   ```bash
   pip install -r requirements.txt
   ```
3. 安装 allure 命令行工具：
   ```bash
   npm install -g allure-commandline
   ```
4. 配置数据库连接信息和接口基础 URL：
   - 修改 `config/data.yaml` 文件中的配置。

## 使用说明
1. 编写测试用例：
   - 在 `case_script` 目录下创建测试脚本。
   - 使用 pytest 的装饰器和断言方法编写测试用例。
2. 执行测试：
   ```bash
   pytest run.py
   ```
3. 生成测试报告：
   ```bash
   allure generate report/api_report -o report/html
   ```
4. 查看测试报告：
   ```bash
   allure open report/html
   ```

## 示例代码
```python
@allure.description("龙果支付项目接口测试")
@allure.epic("用户相关")
@allure.feature("用户管理")
@pytest.mark.backup_tables(["rp_user_info", "pms_menu"])
class TestCase:
    def test_user_login(self):
        # 登录操作
        token = login("test_user")
        # 发送 GET 请求
        response = Requests().get_request(url="/api/user/login", params={"token": token})
        # 断言响应状态码
        assert response.status_code == 200
```

## 贡献指南
1. Fork 本项目。
2. 创建新分支。
3. 提交代码更改。
4. 创建 Pull Request。

## 许可证
本项目采用 MIT 许可证。详情请查看项目根目录下的 LICENSE 文件。