# aomakerProject

**Repository Path**: leierqiang/aomaker-project

## Basic Information

- **Project Name**: aomakerProject
- **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-26
- **Last Updated**: 2025-10-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 用户API测试项目

## 项目概述
这是一个使用Python、pytest和aomaker框架构建的API测试项目，用于测试用户管理相关的API端点。项目结合aomaker框架提供的API对象模型和requests库实现HTTP请求，并包含一个模拟API服务器用于本地测试。

## 项目结构
```
├── server.py           # 模拟API服务器，提供/users端点
├── tests/              # 测试目录
│   ├── users/          # 用户相关测试用例
│   │   └── test_api.py # 用户API测试用例
│   ├── common/         # 公共测试工具和夹具
│   └── __init__.py     # 测试包初始化文件
├── middlewares/        # 中间件配置目录，用于请求/响应处理（当前已禁用）
├── api/                # API定义目录
├── config.yaml         # 项目配置文件
├── requirements.txt    # 项目依赖
└── whl_dependencies/   # 依赖包whl文件
```

## 环境要求
- Python 3.11+
- 依赖包：pytest, requests

## 安装步骤
1. 克隆项目到本地
2. 安装依赖：
   ```
   pip install pytest requests aomaker
   ```

## 使用方法

### 启动模拟API服务器
```
python server.py
```
服务器将在 http://localhost:8000 启动，提供以下端点：
- GET /users: 获取用户列表
- POST /users: 创建新用户

### 运行测试
```
python -m pytest -v tests/
```

### 使用aomaker运行测试
```
aomaker run tests/users/test_aomaker_api.py
```

## 测试用例说明
- test_get_user_list: 测试获取用户列表接口 (pytest风格)
- test_create_user: 测试创建用户接口 (pytest风格)
- test_get_user_list_aomaker: 测试获取用户列表接口 (aomaker风格)
- test_create_user_aomaker: 测试创建用户接口 (aomaker风格)
- test_get_user_detail_aomaker: 测试获取用户详情接口 (aomaker风格)

## 注意事项
- 模拟服务器需要先启动才能运行测试
- 测试结果中的pytest警告可通过将return语句改为assert语句进一步优化
- 项目使用aomaker框架实现结构化API测试，提供类型安全的请求构造和响应验证