# EasyTesting

**Repository Path**: joyamon/easy-testing

## Basic Information

- **Project Name**: EasyTesting
- **Description**: EasyTesting 是基于 Django、DRF、SQLite、Bootstrap、HTTPRunner 及 Playwright 的接口与 UI 自动化测试平台。集成大模型（LLM），可按需自动生成功能测试用例，并支持修改与手动新增，用例可导出为 Excel 或 Markdown。平台支持异步执行测试用例与套件，涵盖接口调试、用例管理、自动化执行、报告查看、数据生成、定时调度与监控等全功能。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://gitee.com/joyamon/easy-testing
- **GVP Project**: No

## Statistics

- **Stars**: 72
- **Forks**: 26
- **Created**: 2025-04-23
- **Last Updated**: 2026-05-08

## Categories & Tags

**Categories**: testing

**Tags**: 接口自动化测试平台, api测试工具, UI自动化测试, llm, AI自动生成测试用例

## README

# EasyTesting

EasyTesting 是一款基于 Django、DRF、SQLite、Bootstrap、HTTPRunner 和 Playwright 构建的接口与 UI 自动化测试平台。平台已集成大模型（LLM）能力，可根据用户需求智能生成功能测试用例，并支持灵活的编辑功能（包括修改和手动新增）。生成的用例可导出为 Excel 或 Markdown 格式。平台支持异步执行测试用例与测试套件，提供接口调试、用例管理、自动化执行、测试报告查看、测试数据生成、定时任务调度与监控等全方位功能。界面设计简约美观，操作流畅、易于上手，致力于为测试团队打造高效、轻量、开源的自动化测试解决方案。
## **`特别提醒，本次版本（v2.2.0）更新集成了AI 大模型能力，python版本需要3.10以上，建议使用python 3.12版本。带来的不便望请谅解`**
## 推荐版本

推荐使用Python 3.10以上版本，这里推荐Python 3.12

```
cryptography==43.0.0
Django==4.2.11
djangorestframework==3.15.2
jsonpath-ng==1.7.0
pydantic>=2.0.0
django-simpleui==2025.5.17
Faker==37.3.0
django-cors-headers==4.3.1
requests>=2.32.5
Pillow==10.1.0
celery==5.3.4
redis==5.0.1
croniter==2.0.1
django-celery-beat==2.5.0
django-cors-headers==4.3.1
xlwt==1.3.0
DBUtils==3.1.2
PyMySQL==1.1.2
pandas==2.3.3
playwright==1.58.0
django-filter==25.1
openpyxl==3.1.5
# 基础依赖
python-dotenv>=1.0.0     # 环境变量加载

# LLM 支持
dashscope>=1.20.0       # 通义千问 SDK
pymupdf>=1.23.0         # PDF 解析
python-docx>=1.0.0      # Word 文档解析
```

## 功能特点

- 创建和管理测试项目
- 使用变量定义测试环境
- 使用请求详细信息和验证规则创建API测试用例
- 将测试用例组织到测试套件中
- 执行测试并查看结果
- 通过执行结果生成测试报告
- 用于与其他工具集成的RESTful API

## 快速开始

1. 拉取代码:

```
   git clone https://gitee.com/joyamon/easy-testing.git
```

2. 创建虚拟环境:
   ```
   python -m venv venv
   source venv/bin/activate 
   ```
3. 安装依赖:
   ```
   pip install -r requirements.txt
   ```
4. 复制配置文件:
   ```
   # windows
   copy .env.example .env
   # linux
   cp .env.example .env
   
   配置qwen api-key：
   DASHSCOPE_API_KEY = sk-xxxx # 必填，替换为你的api key
   ```
5. 生成迁移文件并迁移数据库:
   ```
   python manage.py makemigrations
   python manage.py migrate
   ```
6. 创建管理员:
   ```
   python manage.py createsuperuser
   ```
7. 启动服务器:
   ```
   python manage.py runserver
   ```
8. 启动celery和beat
   ```
   # windows 
   celery -A EasyTesting worker -l info  -P eventlet --pool=solo
   celery -A EasyTesting beat -l info
   # linux
   celery -A EasyTesting worker -l info
   celery -A EasyTesting beat -l info
   
   ```

## 使用

1. 点击 http://localhost:8000/ 访问
2. 使用账号密码登录
3. 创建项目、环境、测试用例和测试套件
4. 执行测试用例并查看结果

## AI生成功能测试用例使用流程

```
新建项目  →  录入需求  →  自动生成用例  →  编辑优化  →  导出 Excel/Markdown
```

1. **新建项目**：首页点击「新建项目」，填写项目名称与描述
2. **录入需求**：进入项目详情，点击「添加需求」，填写需求标题和详细描述
3. **生成用例**：进入需求详情，选择生成模式（规则/LLM/混合），点击「生成测试用例」
4. **编辑优化**：对生成的用例进行手动调整（步骤、预期结果、优先级、状态）
5. **导出**：在需求详情页点击「导出 Excel」或「导出 Markdown」

---
## 效果截图

### 注册

<img src="static/pic/注册.png" />

### 登录

<img src="static/pic/登录.png" />

### 面板

<img src="static/pic/Dashboard.png" />

### 项目

<img src="static/pic/project.png" />

### 项目详情

<img src="static/pic/projectDetails.png" />

### 环境

<img src="static/pic/Environments.png" />

### 测试用例

<img src="static/pic/TestCases.png" />

### 测试用例详情

<img src="static/pic/caseDetail.png" />

### 测试套件

<img src="static/pic/TestSuites.png" />

### 测试套件详情

<img src="static/pic/suiteDetail.png" />

### 测试运行

<img src="static/pic/TestRuns.png" />

### 测试结果

<img src="static/pic/testresultsDetail.png" />

### UI测试用例

<img src="static/pic/uitestcase.png" />

### ui测试执行结果

<img src="static/pic/uitestresult.png" />

### 个人资料

<img src="static/pic/个人资料.png" />

### 修改密码

<img src="static/pic/修改密码.png" />

### 邮件配置列表

<img src="static/pic/邮件配置列表.png" />

### 测试报告列表

<img src="static/pic/report_list.png" />

### 测试报告详情

<img src="static/pic/report_details.png" />

### mock数据

  <img src="static/pic/mock数据.png" />

### 定时任务

   <img src="static/pic/定时任务.png" />

### 定时任务监控

   <img src="static/pic/定时任务监控.png" />

### 辅助工具

  <img src="static/pic/辅助工具.png" />

### 访问记录

<img src="static/pic/访问记录.png">

### 测试管理后台

<img src="static/pic/后台管理.png" />

### 觉得项目不错，请作者喝一杯咖啡

<img src="static/pic/pay.jpg" width="300" />

### 交流群

<img src="static/pic/wechat.jpg" width="300"  /> 
<img src="static/pic/chat.jpg" width="300"  />

- 群二维码过期无法访问，请添加个人微信，博主可拉进群，添加时备注：gitee，欢迎大家一起交流

## 贡献伙伴

非常感谢以下小伙伴的贡献

- [jinpeng_zhang](https://gitee.com/jinpeng_zhang)

   <img src="https://foruda.gitee.com/avatar/1749719940805397104/7589136_jinpeng_zhang_1749719940.png" width="80"/>

## License

本项目根据MIT许可证获得许可

## 致谢

- [Django](https://www.djangoproject.com/)
- [Django REST framework](https://www.django-rest-framework.org/)
- [SQLite](https://www.sqlite.org/index.html)
- [Bootstrap](https://getbootstrap.com/)
- [HTTPRunner](https://httprunner.com/)
- [Django-SimpleUI](https://github.com/xui2013/django-simpleui)
- [playwright](https://playwright.dev/)
- [Faker](https://faker.readthedocs.io/en/master/)
- [WorkBuddy](https://www.codebuddy.cn/)