98 lines
2.8 KiB
Markdown
98 lines
2.8 KiB
Markdown
|
# KARDS Battle System 测试套件
|
|||
|
|
|
|||
|
|
这里包含了KARDS战斗系统的所有测试代码。
|
|||
|
|
|
|||
|
|
## 📁 测试结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
tests/
|
|||
|
|
├── unit/ # 单元测试
|
|||
|
|
│ ├── test_unit_type_rules.py # 单位类型战斗规则测试
|
|||
|
|
│ └── test_artillery_simple.py # 火炮攻击测试
|
|||
|
|
├── integration/ # 集成测试
|
|||
|
|
│ ├── test_drag_system.py # 拖拽操作系统测试
|
|||
|
|
│ ├── test_corrected_battlefield.py # 战场系统测试
|
|||
|
|
│ └── test_*.py # 其他集成测试
|
|||
|
|
├── examples/ # 示例测试
|
|||
|
|
│ └── test_readme_example.py # README示例代码测试
|
|||
|
|
└── run_tests.py # 测试运行器
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 🚀 运行测试
|
|||
|
|
|
|||
|
|
### 运行所有测试
|
|||
|
|
```bash
|
|||
|
|
# 使用Shell脚本（推荐）
|
|||
|
|
./run_tests.sh
|
|||
|
|
|
|||
|
|
# 使用Python测试运行器
|
|||
|
|
python3 tests/run_tests.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 运行特定类型的测试
|
|||
|
|
```bash
|
|||
|
|
# 单元测试
|
|||
|
|
python3 tests/unit/test_unit_type_rules.py
|
|||
|
|
python3 tests/unit/test_artillery_simple.py
|
|||
|
|
|
|||
|
|
# 集成测试
|
|||
|
|
python3 tests/integration/test_drag_system.py
|
|||
|
|
|
|||
|
|
# 示例测试
|
|||
|
|
python3 tests/examples/test_readme_example.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 📋 测试内容
|
|||
|
|
|
|||
|
|
### 🔧 单元测试
|
|||
|
|
- **test_unit_type_rules.py**: 全面测试各兵种的战斗规则
|
|||
|
|
- 步兵攻击相邻战线规则
|
|||
|
|
- 火炮无视距离和守护，不受反击
|
|||
|
|
- 战斗机保护机制
|
|||
|
|
- 轰炸机不受反击规则
|
|||
|
|
|
|||
|
|
- **test_artillery_simple.py**: 专门测试火炮不受反击机制
|
|||
|
|
|
|||
|
|
### 🔗 集成测试
|
|||
|
|
- **test_drag_system.py**: 测试真实的拖拽操作系统
|
|||
|
|
- 拖拽到空位 = 移动
|
|||
|
|
- 拖拽到敌方 = 攻击
|
|||
|
|
- 指挥点和激活成本管理
|
|||
|
|
|
|||
|
|
- **test_corrected_battlefield.py**: 测试3线战场系统
|
|||
|
|
- 战场布局和控制权
|
|||
|
|
- 单位部署和移动
|
|||
|
|
|
|||
|
|
### 📖 示例测试
|
|||
|
|
- **test_readme_example.py**: 验证README中的示例代码正确工作
|
|||
|
|
|
|||
|
|
## ✅ 测试验证的功能
|
|||
|
|
|
|||
|
|
- ✅ 真实的3条战线布局
|
|||
|
|
- ✅ 两种玩家操作：使用卡牌、拖动单位
|
|||
|
|
- ✅ 拖拽统一移动/攻击操作
|
|||
|
|
- ✅ 指挥点资源管理
|
|||
|
|
- ✅ 激活点数（油费）系统
|
|||
|
|
- ✅ 单位类型特殊规则
|
|||
|
|
- ✅ 战斗伤害和反击计算
|
|||
|
|
- ✅ 前线控制权机制
|
|||
|
|
- ✅ 挤位置移动规则
|
|||
|
|
|
|||
|
|
## 🎯 测试原则
|
|||
|
|
|
|||
|
|
1. **不要防御式编程**: 如果期望没达到就直接报错，不掩盖问题
|
|||
|
|
2. **完整性测试**: 每个功能都要有对应的测试
|
|||
|
|
3. **真实场景**: 测试要模拟真实的游戏使用场景
|
|||
|
|
4. **清晰输出**: 测试结果要清晰显示通过/失败状态
|
|||
|
|
|
|||
|
|
## 🔧 添加新测试
|
|||
|
|
|
|||
|
|
1. 在相应目录创建 `test_*.py` 文件
|
|||
|
|
2. 添加适当的路径设置:
|
|||
|
|
```python
|
|||
|
|
import sys
|
|||
|
|
import os
|
|||
|
|
sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', '..'))
|
|||
|
|
```
|
|||
|
|
3. 更新 `run_tests.sh` 包含新测试
|
|||
|
|
4. 确保测试输出清晰的通过/失败信息
|