zwf
55 lines
1.5 KiB
Markdown
55 lines
1.5 KiB
Markdown
# 测试指南
|
||
|
||
## 测试目录结构
|
||
|
||
```
|
||
tests/
|
||
├── conftest.py # 全局 fixtures 和配置
|
||
├── unit/ # 单元测试（无外部依赖，可离线运行）
|
||
│ ├── test_paste.py # 基础导入和版本
|
||
│ ├── test_snow_id.py # 雪花ID生成器
|
||
│ ├── test_jwt.py # JWT 令牌（mock）
|
||
│ ├── test_configure.py # 配置管理（mock）
|
||
│ ├── test_pagination.py # 分页逻辑
|
||
│ ├── test_ustr.py # 字符串工具
|
||
│ └── test_udict.py # 字典工具
|
||
├── integration/ # 集成测试（需要真实服务）
|
||
│ └── test_db.py # 数据库连接测试
|
||
└── README.md # 本文件
|
||
```
|
||
|
||
## 运行方式
|
||
|
||
### 运行所有单元测试（推荐日常使用）
|
||
|
||
```bash
|
||
cd <项目根目录>
|
||
pytest tests/unit/ -v
|
||
```
|
||
|
||
### 运行所有测试（含集成测试）
|
||
|
||
```bash
|
||
pytest tests/ -v
|
||
```
|
||
|
||
### 仅运行集成测试
|
||
|
||
```bash
|
||
pytest tests/integration/ -v
|
||
```
|
||
|
||
### 生成覆盖率报告
|
||
|
||
```bash
|
||
pytest tests/unit/ --cov=paste --cov-report=html
|
||
open htmlcov/index.html
|
||
```
|
||
|
||
## 编写规范
|
||
|
||
1. **单元测试**放在 `tests/unit/`，无外部依赖
|
||
2. **集成测试**放在 `tests/integration/`，加 `@pytest.mark.integration`
|
||
3. 每个测试类以 `Test` 开头，测试方法以 `test_` 开头
|
||
4. 使用断言而非 print 验证结果
|
||
5. 不依赖外部配置文件或数据库连接 |