# Web自动化框架

**Repository Path**: will-pix/web-automation-framework

## Basic Information

- **Project Name**: Web自动化框架
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-05
- **Last Updated**: 2025-10-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PulseUIFrame - UI 自动化测试框架

这是一个基于 Pytest 和 Playwright 的 UI 自动化测试框架，旨在提供一个清晰、可维护且易于扩展的测试解决方案。

## ✨ 功能特性

- **基于 Pytest**: 利用强大的 `pytest` 作为测试执行引擎。
- **Playwright 驱动**: 使用现代化的 `playwright` 库与浏览器进行交互。
- **页面对象模型 (POM)**: 采用业界标准的 POM 设计模式，将 UI 元素和业务逻辑分层。
- **分层结构**: 清晰的目录结构，将测试、页面对象和核心工具分离。
- **易于扩展**: 可以轻松添加新的页面对象和测试用例。
- **详细报告**: 自动生成 HTML 格式的测试报告。

## 🚀 快速开始

### 1. 环境准备

- 确保您的系统中已安装 Python 3.8+。
- 建议使用虚拟环境来管理项目依赖。

```bash
# 创建虚拟环境
python -m venv .venv

# 激活虚拟环境 (Windows)
.venv\Scripts\activate

# 激活虚拟环境 (macOS/Linux)
source .venv/bin/activate
```

### 2. 安装依赖

从项目的根目录运行以下命令来安装所有必需的库：

```bash
pip install -r requirements.txt
```

接下来，安装 Playwright 的浏览器驱动：

```bash
playwright install
```

### 3. 运行测试

您可以通过多种方式运行测试：

- **运行所有测试**:
  ```bash
  pytest
  ```

- **只运行冒烟测试**:
  ```bash
  pytest -m smoke
  ```

- **只运行回归测试**:
  ```bash
  pytest -m regression
  ```

测试报告将自动生成在 `reports/` 目录下。

## 📂 框架结构

```
PulseUIFrame/
├── pages/                # 页面对象
│   ├── __init__.py
│   ├── base_page.py      # 页面对象基类
│   └── login_page.py     # 登录页面对象
├── tests/                # 测试用例
│   ├── __init__.py
│   └── test_login.py     # 登录功能的测试用例
├── core/                 # 核心工具和封装
│   └── __init__.py
├── config/               # 配置文件
│   └── __init__.py
├── reports/              # 测试报告
│   └── .gitkeep
├── conftest.py           # Pytest 全局 Fixtures
├── pytest.ini            # Pytest 配置文件
├── requirements.txt      # Python 依赖列表
└── README.md             # 项目说明
```

## 📝 未来扩展

- **配置文件**: 在 `config/` 目录中添加 `config.yaml`，用于管理不同环境的 URL、用户名等信息。
- **日志系统**: 在 `core/` 目录中添加 `logger.py`，用于记录详细的测试日志。
- **数据驱动**: 结合 `pytest.mark.parametrize` 实现数据驱动测试。
- **CI/CD 集成**: 将此框架集成到 Jenkins、GitHub Actions 等 CI/CD 流水线中。