# AutoTest

**Repository Path**: wxy_home/auto-test

## Basic Information

- **Project Name**: AutoTest
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-06-21
- **Last Updated**: 2025-08-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: ui自动化测试框架, playwright

## README

# 自动化测试框架使用说明

## 项目概述
本项目是基于Python+Playwright+HTMLTestRunner+unittest+logging的Web自动化测试框架，采用Page Object设计模式，支持测试用例管理、报告生成、日志记录、测试过程录屏等功能。

## 环境搭建
1. **安装Python**：推荐Python 3.8+<mcurl name="Python官网" url="https://www.python.org/" ></mcurl>
2. **创建虚拟环境**：
   ```powershell
   python -m venv .venv
   .venv\Scripts\activate
   ```
3. **安装依赖**：
   ```powershell
   pip install playwright html-testRunner pyyaml jinja2
   playwright install
   ```

## 项目结构
```
autoTest/
├── AW/                  # 核心框架代码
│   ├── common/          # 公共模块（日志、基础类等）
│   └── LoginPage/       # 页面对象封装
├── testcase/            # 测试用例目录
├── testdata/            # 测试数据（YAML格式）
├── reports/             # 测试报告目录
│   ├── videos/          # 录屏
│   ├── photos/          # 截图文件
│   └── temp/            # 临时报告
├── logs/                # 日志文件
├── run_test.py          # 单文件测试入口
└── run_test_txt.py      # 批量测试入口（通过run_testcases.txt配置）
```

## 运行测试
### 方式1：运行单个测试文件
```powershell
python run_test.py
```

### 方式2：运行多个测试文件
1. 编辑`run_testcases.txt`文件，添加测试用例路径
2. 执行命令：
   ```powershell
   python run_test_txt.py
   ```

## 测试报告
- 报告生成路径：`./reports/TestReport-YYYY-MM-DD_HH-MM-SS.html`
- 报告包含：用例执行情况、失败原因、日志链接等信息
- 报告模板：`report_template.html`（可自定义样式）

## 配置说明
1. **测试数据**：修改`testdata/`目录下的YAML文件
2. **日志配置**：调整`AW/common/logger.py`
3. **报告配置**：修改`run_test_txt.py`中的报告生成参数

## 常见问题
1. **模块导入错误**：确保`sys.path`已添加项目根目录
2. **元素定位失败**：检查定位表达式或增加等待时间
3. **报告统计异常**：确认`report_template.html`中的计算公式正确
4. **类名与模块名不匹配**：确保测试类名与文件名保持一致

## 注意事项
- 测试用例类需继承`TestCaseBase`
- 页面元素定位建议使用`@locator`装饰器
- 所有路径推荐使用绝对路径避免相对路径问题